Rastrear a reprodução principal usando o JavaScript 3.x track-core-playback-on-javascript

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.

API de createMediaObject API

StreamTypeConstantes:

MediaTypeConstantes:

var mediaObject = ADB.Media.createMediaObject(<MEDIA_NAME>,
                                  <MEDIA_ID,
                                  <MEDIA_LENGTH>,
                                  <STREAM_TYPE>,
                                  <MEDIA_TYPE>);

Anexar metadados

Opcionalmente, anexe metadados padrão e/ou personalizados à sessão de rastreamento por meio de variáveis de dados de contexto.

• Metadados padrão

  note note
  NOTE
  Anexar os metadados padrão é opcional.

  • Referência da API de chaves de metadados de mídia - Chaves de metadados padrão - JavaScript

    Consulte o conjunto completo de metadados aqui: Parâmetros de áudio e vídeo

• Metadados personalizados

  Crie um objeto variável para as variáveis personalizadas e preencha com os dados desta mídia. Por exemplo:

  code language-js
  /* Set context data */ var contextData = {}; //Standard metadata contextData[ADB.Media.VideoMetadataKeys] = "Sample Episode"; contextData[ADB.Media.VideoMetadataKeys] = "Sample Show"; //Custom metadata contextData["isUserLoggedIn"] = "false"; contextData["tvStation"] = "Sample TV Station";

Rastrear a intenção de iniciar a reprodução

Para começar a rastrear uma sessão de mídia, chame trackSessionStart na instância do Media Heartbeat:

var mediaObject = ADB.Media.createMediaObject("video-name",
                                              "video-id",
                                              60.0,
                                              ADB.Media.StreamType.VOD,
                                              ADB.Media.MediaType.Video);

var contextData = {};

//Standard metadata
contextData[ADB.Media.VideoMetadataKeys] = "Sample Episode";
contextData[ADB.Media.VideoMetadataKeys] = "Sample Show";

//Custom metadata
contextData["isUserLoggedIn"] = "false";
contextData["tvStation"] = "Sample TV Station";

tracker.trackSessionStart(mediaObject, contextData);

Rastrear o início real da reprodução

Identifique o evento no reprodutor de mídia para o início da reprodução, em que o primeiro quadro da mídia é renderizado na tela, e chame trackPlay:

tracker.trackPlay();

Atualizar valor do indicador de reprodução

Quando o indicador de reprodução de mídia for alterado, notifique o SDK, chamando o mediaUpdatePlayhead API.
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 pode ser especificado como o número de segundos desde a meia-noite UTC daquele dia.

tracker.updatePlayhead(position)

Rastrear a conclusão da reprodução

Identifique o evento no reprodutor de mídia para a conclusão da reprodução, em que o usuário assistiu ao conteúdo até o fim, e chame trackComplete:

tracker.trackComplete();

Rastrear o final da sessão

Identifique o evento no reprodutor de mídia para o descarregamento/encerramento da reprodução, em que o usuário fecha a mídia, e/ou a mídia é concluída e descarregada, e chame trackSessionEnd:

tracker.trackSessionEnd();

Rastrear todos os cenários de pausa possíveis

Identifique o evento do reprodutor de mídia para pausa e chame trackPause:

tracker.trackPause();

Pausar cenários

Identifique qualquer cenário no qual o reprodutor de mídia será pausado e verifique se trackPause foi chamado corretamente. Os seguintes cenários exigem que o aplicativo chame trackPause():

• 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 a mídia a partir do ponto de interrupção.

Identifique o evento do reprodutor para reprodução e/ou retomada da pausa e chame trackPlay:

tracker.trackPlay();