MediaCP Manual
Leitor de áudio HTML5

Last updated 1 mês atrás

O leitor de áudio é compatível com todos os navegadores modernos, suporta html5 nativo e streaming SSL e vem em 3 tamanhos diferentes: Grande, Pequeno e Compacto. O jogador está disponível apenas com o software MediaCP e não pode ser usado com fluxos externos fora do MediaCP.

O Audio Player inclui os seguintes recursos primários:

  • Capa automática album art do iTunes ou LastFM
  • Fundo personalizado de recuo onde uma imagem relativa não pode ser localizada ou álbuns de capa são desativados
  • Direct Player links
  • Seleção de ponto de montagem
  • Contagem de ouvinte
  • Restrições de domínio – Jogar apenas em sites específicos

HTTPS / SSL & Stream Proxy

O Audio Player foi projetado para funcionar com SSL nativo do serviço de streaming (Shoutcast ou Icecast) ou com o MediaCP Stream Proxy. Se o proxy de fluxo estiver ativado em um serviço, este método será usado como url de streaming preferido pelo jogador. O proxy de fluxo é fornecido através do recurso nginx proxy_pass e fornece um consumo mínimo de sobrecarga e CPU.

O Stream Proxy é ativado automaticamente para tipos de servidor onde o SSL ou não está disponível; ou não o ideal. Isso inclui:

  • Shoutcast 2.5 – O suporte ao SSL não está disponível no software do servidor
  • Shoutcast 2.6 – O suporte ao SSL é um recurso pago apenas por prêmios a partir de www.shoutcast.com

Reproduzir automaticamente

A reprodução automática de um fluxo é um processo complicado com navegadores modernos, já que o mecanismo Chrome implementou alterações de políticas de reprodução automática que proíbem um fluxo de reprodução automática, a menos que certas condições sejam feitas

A política especifica que a reprodução automática só é possível quando:

  1. O áudio é silenciado; ou
  2. O usuário se engajou com o site antes do início da reprodução automática; ou
  3. O usuário já reproduziu mídia no site com som.

Por causa dessas restrições, não faz muito sentido iniciar um fluxo somente de áudio silenciado; porque vai confundir o usuário que visita o site.

Trabalharemos em algumas mudanças no futuro para detectar automaticamente as duas últimas condições acima e tentar a reprodução automática uma vez que uma ou mais das condições sejam atendidas.

Pontos de Montagem

O Audio Player transmite a URL padrão do Mount Point conforme definido no MediaCP, por isso é importante que você esteja transmitindo para os mesmos Pontos de Montagem listados na configuração Mount Points.

Quando mais de um ponto de montagem for especificado, o jogador mostrará uma seleção suspensa permitindo que o usuário mude para um fluxo diferente. Isso pode ser útil para fornecer vários fluxos de bitrate.

Capas

As capas dos álbuns são exibidas no fluxo por padrão. A imagem está localizada a partir do iTunes ou Last.fm dependendo da configuração do painel. Se uma imagem não estiver disponível, o fundo do jogador configurado será exibido em vez disso.

É possível desativar capas de álbuns da configuração do jogador, desmarcando o item Capas das Opções de Exibição.

Configuração do jogador

É possível acessar a configuração do jogador enquanto estiver conectado ao MediaCP. Você verá o ícone de configuração disponível no próprio jogador.

Domínios permitidos

É possível bloquear o jogador para que ele só funcione a partir de uma lista especificada de domínios. Isso permite controlar onde o jogador pode ser usado. A lista de domínios deve ser fornecida apenas em uma lista simples de nomes de domínio, sem incluir nada adicional (não inclua http:// ou https://). Por exemplo: mediacp.net, mydomain.com

Essa função funciona utilizando o recurso Access-Control-Allow-Origin do navegador em conjunto com a URL de configuração JSON (onde o jogador obtém informações sobre o fluxo). Se um domínio não estiver incluído na lista permitida, ele será impedido de acessar os dados de configuração pelo próprio navegador.

Table of Contents