A API Co-Watching de compartilhamento ao vivo do Google Meet gerencia a experiência de reunião de vários participantes que assistem ou ouvem conteúdo no seu app.
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
.
A CoWatchingDelegate
é como a API Co-Watching atualiza o
app sempre que ele tem um novo estado disponível. Espera-se que, quando o método
CoWatchingDelegate.onCoWatchingStateChanged
for chamado, o aplicativo aplique o novo estado imediatamente.
O exemplo de código a seguir mostra como usar a API Co-Watching:
TypeScript
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 de mídia da sua atividade.
Gerenciar o estado atual
Quando os usuários realizam ações no seu aplicativo, é esperado que ele chame imediatamente os métodos de API fornecidos.
Chame esses métodos somente em resposta a eventos significativos. Por
exemplo, você não precisa chamá-los sempre que o app avançar
um vídeo em reprodução. O CoWatchingDelegate
criado acima processa a atualização
de posições de layout nessas circunstâncias.
É possível controlar o estado de assistir em grupo usando os seguintes métodos:
CoWatchingClient.notifySwitchToMedia
: chame sempre que a mídia em reprodução ativa mudar. Por exemplo, o usuário seleciona um novo vídeo ou a reprodução automática inicia o próximo.CoWatchingClient.notifyPauseState
: chamar quando um usuário pausar ou retomar a mídia em reprodução.CoWatchingClient.notifySeekToTimestamp
: chamar quando um usuário mudar 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 iniciar o armazenamento em buffer devido ao armazenamento em buffer de um switch de mídia anterior, uma busca de mídia ou um congestionamento da rede.CoWatchingClient.notifyReady
: chame quando o armazenamento em buffer for concluído e a mídia estiver pronta para ser reproduzida.