Receptor da Web personalizado

Início rápido: o código para criar um arquivo da Web personalizado O receptor é simples. Pular para registrar seu receptor da Web app, depois crie um App receptor da Web.

O SDK do receptor da Web usa um player de mídia integrado para oferecer uma conexão experiência de reprodução de vídeo. Ele também oferece suporte imediato ao Google Assistente como recursos específicos do Google Cast que são compatíveis automaticamente com todos os remetentes e de dispositivos habilitados para toque. À medida que novos recursos são lançados, eles continuam sem alterações adicionais do remetente.

O receptor da Web personalizado é um app HTML5 personalizado que precisa ser hospedado para exibir seu conteúdo em dispositivos compatíveis com Cast. Talvez seja necessário criar um objeto Web Receiver, de acordo com as necessidades do seu negócio. Para receber ajuda para decidir qual destinatário usar, consulte a escolha um guia sobre o receptor da Web.

SDK do Google Web Receiver

Seu app Web Receiver acessa a API Web Receiver com o seguinte referência:

<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>

Prática recomendada para protocolos de URL: o URL acima não especifica um "http:" ou "https:" protocolo. Omitir esses protocolos ao adquirir o O recurso cast_receiver_framework.js permite que ele seja buscado usando o mesmo protocolo do servidor que hospeda o app receptor da Web. Isso significa que alternar entre HTTP para desenvolvimento e HTTPS para produção é transparente sem precisar mudar o código. (Os aplicativos receptores da Web publicados devem ser hospedados em servidores compatíveis com TLS.

Não auto-hospede o cast_receiver_framework.js (SDK do receptor da Web), nem mesmo para o desenvolvimento local. Sempre usar o SDK do receptor da Web hospedado por Google usando a referência gstatic.com. O SDK do receptor da Web hospedado pelo Google é mantido em paridade com o firmware da plataforma e é atualizado periodicamente para corrigir bugs e adicionar novos recursos. Durante o desenvolvimento, você pode hospedar App receptor da Web localmente em uma rede privada para testes, mas que hospeda a Web O SDK do receptor pode resultar na falha do app.

Visualização do SDK

Uma versão de pré-lançamento do SDK do receptor da Web do Google Cast também está disponível para uso em testar aplicativos que não sejam de produção. Mais informações sobre o URL de visualização do SDK pode ser encontrado em URL de visualização do SDK do receptor da Web do Google Cast.

Ciclo de vida do aplicativo

O ciclo de vida do app começa no ponto em que ele é carregada no dispositivo de transmissão e continua até o ponto em que o aplicativo será removido e o dispositivo de transmissão voltará ao estado padrão.

Ao longo do ciclo de vida de um app receptor da Web, as mensagens são trocadas entre as Receptor da Web e todos os aplicativos de remetente conectados. Um aplicativo remetente enviar uma mensagem inicial a um dispositivo com Google Cast solicitando a criação de uma sessão. usando um ID de app específico. Isso inicia o ciclo de vida do receptor da Web, como o dispositivo com Google Cast tentará carregar o app Receptor da Web. Supondo que não haja não houver problemas de rede, será feito o download do app receptor da Web pela rede usando o URL resolvido associado ao ID do app. Depois de carregado, o Web Receiver vai realizar as operações de configuração e indicar que está pronto para o processamento mensagens de qualquer aplicativo remetente conectado.

Um aplicativo receptor da Web pode ser encerrado (encerrar o ciclo de vida atual e fechar o da inscrição) nas seguintes condições:

• O app receptor da Web recebe uma mensagem explícita da última conexão remetente encerre a sessão do aplicativo.
• O app Web Receiver estiver ocioso por um período definido sem nenhuma remetentes conectados e decide encerrar a sessão do aplicativo.
• Uma sessão de transmissão diferente foi iniciada.
• O receptor da Web encontra um erro fatal durante o ciclo de vida normal.

O SDK do receptor da Web lida com todos os casos comuns de acordo com nossa Diretrizes de UX.

Aulas principais

O framework do SDK do receptor da Web tem duas classes principais:

• cast.framework.CastReceiverContext: gerencia e carrega todas as bibliotecas necessárias. Com esse objeto, é possível:

  • Definir as opções de configuração do aplicativo
  • Processar eventos do sistema (como o remetente conectado ou desconectado)
  • Criar canais personalizados
  • Iniciar a comunicação de transmissão

• cast.framework.PlayerManager: gerencia a mídia. a reprodução. Ele lida com o player e o elemento de mídia de acordo com o solicitação do remetente. Com esse objeto, é possível:

  • Processar operações de reprodução
  • Processar solicitações do remetente relacionadas à reprodução
  • Processar eventos relacionados à reprodução

Registrar o app receptor da Web

Antes de desenvolver um app receptor da Web, é preciso registrar o endereço App receptor com o Play Console do SDK do Google Cast. Consulte Acesse esta página para saber mais. Todos os receptores da Web exigem que os aplicativos remetentes forneçam um ID de app com as mensagens de comando enviados ao receptor da Web pela API do remetente. Quando você registra sua conta aplicativo receptor, você vai receber o ID do app para incluir no campo chamadas de API.

Criar um app receptor da Web básico

Veja a seguir a estrutura principal de um aplicativo receptor da Web básico que não tem personalização:

1. Um elemento HTML cast-media-player para representar o player de mídia.
2. Um elemento HTML de script para carregar o framework do receptor da Web.
3. Ligação start() para iniciar o app Web Receiver sem opções.

Este é o código mínimo para um app receptor da Web usando o aplicativo Cast sem a necessidade de personalização. Você pode copiar e colar esse script no estado em que se encontra para criar o app receptor da Web.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    cast.framework.CastReceiverContext.getInstance().start();
  </script>
</body>
</html>

Nesse momento, o usuário pode abrir o app remetente, conectar-se ao dispositivo de transmissão navegue até a mídia e pressione Reproduzir, que instrui o receptor da Web a transmitir a mídia à TV para o usuário assistir.

Compare este receptor da Web básico com um app receptor personalizado.

Mídia e players

O framework do Google Cast oferece um player de mídia integrado, representado pelo Elemento HTML cast-media-player. Esse player de mídia é compatível com a reprodução de protocolos de streaming, como MPEG-DASH, HLS e Smooth Streaming.

Um conjunto de codecs de mídia e contêineres suportados está listado em Mídia compatível. Com as mensagens da transmissão, os desenvolvedores podem suporte uma lista de operações iniciadas pelo remetente, como carregar, reproduzir, pausar e de busca, em que o SDK do Cast processa as interações com a mídia. Para uma lista de operações compatíveis, consulte a referência da API do remetente para a plataforma do seu app: RemoteMediaClient no Android Sender, GCKMediaControlChannel no Remetente do iOS e Media no Web Sender.

Compartilhamento de recursos entre origens

O Google Cast é totalmente compatível com o Compartilhamento de recursos entre origens (CORS). Fluxo diferentes, ao contrário da maioria dos protocolos baseados em arquivos, acessam o conteúdo de modo assíncrono usando XMLHttpRequest. Em um mundo CORS, essas solicitações são protegidas contra acesso impróprio pelo cabeçalho CORS do servidor onde o recurso se origina. Isso significa que o servidor do seu conteúdo determina onde ele pode ficar incluída. A maioria dos navegadores modernos são totalmente compatíveis com CORS. Dispositivos iOS e Android acessem o conteúdo de um nível inferior e não observem esses cabeçalhos. Isso é o primeiro problema que surge quando um desenvolvedor quer usar o streaming conteúdo. Consulte Compartilhamento de recursos entre origens para detalhes.