Rastreamento da reprodução principal no Chromecast track-core-playback-on-chromecast
Esta documentação abrange o rastreamento na versão 2.x do SDK.
-
Configuração de rastreamento inicial
Identifique quando o usuário aciona a intenção de reproduzir (o usuário clica em Reproduzir e/ou a reprodução automática está ativada) e crie uma instância
MediaObject.Referência da API
MediaObject:code language-none mediaObject = ADBMobile.media.createMediaObject(<name>, <id>, <duration>, <streamType>, <mediaType>);Constantes de
StreamType:Constantes de
MediaType: -
Anexar metadados de vídeo
Opcionalmente, anexe objetos de metadados de vídeo padrão e/ou personalizados à sessão de rastreamento de vídeo por meio de variáveis de dados de contexto.
-
Metadados de vídeo padrão
Implementar metadados padrão no Chromecast
note note NOTE Anexar o objeto de metadados de vídeo padrão ao objeto de mídia é opcional. -
Metadados personalizados
Crie um objeto variável para as variáveis personalizadas e preencha com os dados deste vídeo. Por exemplo:
code language-js /* Set custom context data */ var customVideoMetadata = { isUserLoggedIn: "false", tvStation: "Sample TV station", programmer: "Sample programmer" };
-
-
Rastrear a intenção de iniciar a reprodução
Para começar a rastrear uma sessão de mídia, chame trackSessionStart no objeto
media.code language-none ADBMobile.media.trackSessionStart(mediaObject, customVideoMetadata);note important IMPORTANT trackSessionStartrastreia a intenção de reproduzir do usuário e não o início da reprodução. Essa API é utilizada para carregar os dados/metadados de vídeo e estimar a métrica de tempo do início de QoS (duração entretrackSessionStartetrackPlay).note note NOTE O segundo valor é o nome de objeto dos metadados de vídeo personalizados, criado na etapa 2. Se não estiver utilizando metadados de vídeo personalizados, basta enviar um objeto vazio para o argumento dataemtrackSessionStart, como mostrado na linha comentada do exemplo de iOS acima. -
Rastrear o início real da reprodução
Identifique o evento no reprodutor de vídeo a partir do início da reprodução, em que o primeiro quadro do vídeo é renderizado na tela, e chame trackPlay:
code language-none ADBMobile.media.trackPlay(); -
Atualizar valor do indicador de reprodução
Atualize o valor de posição do
mediaUpdatePlayheadvárias vezes quando o indicador de reprodução mudar.
Para vídeos sob demanda (VOD), o valor é especificado em segundos a partir do início do item de mídia.
Para transmissões ao vivo, se o player não fornecer informações sobre a duração do conteúdo, o valor poderá ser especificado como o número de segundos desde a meia-noite UTC daquele dia.code language-none ADBMobile().media.updatePlayhead(position)note note NOTE Considere o seguinte ao chamar a API media.updatePlayhead:- Ao usar marcadores de progresso, a duração do conteúdo é necessária e o indicador de reprodução precisa ser atualizado para o número de segundos desde o início do item de mídia, começando com 0.
- Ao usar SDKs de mídia, você deve chamar a API
media.updatePlayheadpelo menos uma vez por segundo.
-
Rastrear a conclusão da reprodução
Identifique o evento no reprodutor de vídeo para a conclusão da reprodução, onde o usuário assistiu ao conteúdo até o fim, e chame trackComplete:
code language-none ADBMobile.media.trackComplete(); -
Rastrear o final da sessão
Identifique o evento no reprodutor de vídeo para o descarregamento/encerramento da reprodução, onde o usuário fecha o vídeo, e/ou ele é concluído e descarregado, e chame trackSessionEnd:
code language-none ADBMobile.media.trackSessionEnd();note important IMPORTANT trackSessionEndmarca o fim de uma sessão de rastreamento de vídeo. Se a sessão tiver sido assistida até o final, onde o usuário assistiu ao conteúdo até o fim, verifique setrackComplete() é chamado antes detrackSessionEnd. Qualquer outra chamada de API detrack*é ignorada depois detrackSessionEnd, exceto portrackSessionStartpara uma nova sessão de rastreamento de vídeo. -
Rastrear todos os cenários de pausa possíveis
Identifique o evento no reprodutor de vídeo para vídeos pausados e chame trackPause:
code language-none ADBMobile.media.trackPause();Pausar cenários
Identifique qualquer cenário no qual o reprodutor de vídeo será pausado e verifique se
trackPausefoi chamado corretamente. Os seguintes cenários exigem que o aplicativo chametrackPause():- O usuário faz uma pausa explicitamente no aplicativo.
- O player se coloca no estado Pausa.
- (Aplicativos móveis) - O usuário coloca o aplicativo em segundo plano, mas você deseja que ele mantenha a sessão aberta.
- (Aplicativos móveis) - Qualquer tipo de interrupção de sistema que ocorra e faça com que um aplicativo seja colocado em segundo plano. Por exemplo, o usuário recebe uma chamada ou uma pop-up de outro aplicativo ocorre, mas você deseja que o aplicativo mantenha a sessão ativa para dar ao usuário a oportunidade de retomar o vídeo a partir do ponto de interrupção.
-
Identifique o evento do reprodutor para reprodução e/ou continuação do vídeo a partir da pausa e chame trackPlay:
code language-none ADBMobile.media.trackPlay();note tip TIP Esta pode ser a mesma fonte de evento utilizada na Etapa 4. Verifique se cada chamada trackPause()da API está emparelhada a uma chamadatrackPlay()da API quando a reprodução continuar.
- Cenários de rastreamento: Reprodução de VOD sem anúncios
- Exemplo de reprodutor incluído no Chromecast SDK para obter um exemplo completo de rastreamento.