Implementar a API de co-watching

Este guia explica como implementar a API Co-Watching.

Criar um CoWatchingClient.

Para começar, crie um createCoWatchingClient do AddonSession que você criou em Começar.

Para criar um CoWatchingCient, chame o método AddonSession.createCoWatchingClient e forneça um CoWatchingDelegate.

O CoWatchingDelegate é como a API Co-Watching atualiza o aplicativo sempre que ele tem um novo estado disponível. Espera-se que, quando o método CoWatchingDelegate.onCoWatchingStateChanged for chamado, o aplicativo aplicará imediatamente o novo estado.

O exemplo de código a seguir mostra como usar a API Co-Watching:

 const coWatchingClient = await addonSession.createCoWatchingClient({
    activityTitle: "ACTIVITY_TITLE",
    onCoWatchingStateQuery() {
      // This function should return the current state of your CoWatching activity
      return getMyApplicationCoWatchingState();
    },
    onCoWatchingStateChanged(coWatchingState: CoWatchingState) {
      // This function should apply newState to your ongoing CoWatching activity
    },
  });

Substitua ACTIVITY_TITLE pelo título da mídia da sua atividade.

Gerenciar o estado atual

Quando os usuários agem no seu aplicativo, espera-se que ele chame imediatamente os métodos de API fornecidos.

Chame esses métodos apenas em resposta a eventos significativos. Por exemplo, você não precisa chamá-los sempre que o app avançar a reprodução de um vídeo. O CoWatchingDelegate criado acima processa a atualização das posições do layout nessas circunstâncias.

Use estes métodos para controlar o estado "Assistir em grupo":

• CoWatchingClient.notifySwitchToMedia: chame sempre que a mídia em reprodução mudar. Por exemplo, o usuário seleciona um novo vídeo ou a reprodução automática inicia o próximo vídeo.
• CoWatchingClient.notifyPauseState: chame quando um usuário pausar ou retomar a mídia que está tocando.
• CoWatchingClient.notifySeekToTimestamp: chame quando um usuário muda explicitamente a posição de reprodução.
• CoWatchingClient.notifyPlayoutRate: chama quando um usuário atualiza a velocidade de reprodução para um novo valor (por exemplo, 1,25x).
• CoWatchingClient.notifyBuffering: chame quando o app de um usuário começar a armazenar em buffer devido ao armazenamento em buffer de um interruptor de mídia anterior, busca de mídia ou congestionamento da rede.
• CoWatchingClient.notifyReady: chame quando o armazenamento em buffer for concluído e a mídia estiver pronta para ser reproduzida.