. A API de compartilhamento ao vivo Co-Watching do Google Meet gerencia a experiência de reunião de vários participantes assistir ou ouvir 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 fornecem uma
CoWatchingDelegate
A CoWatchingDelegate
é como a API Co-Watching atualiza
do aplicativo sempre que houver um novo estado disponível. É esperado que, quando a
CoWatchingDelegate.onCoWatchingStateChanged
for chamado, seu aplicativo aplicará imediatamente o novo estado.
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 da mídia da sua atividade.
Gerenciar o estado atual
Quando os usuários agem no seu aplicativo, é esperado que ele chama imediatamente os métodos da API fornecidos.
Chame esses métodos apenas em resposta a eventos significativos. Para
por exemplo, você não precisa chamá-los sempre que o app avançar um
vídeo. O CoWatchingDelegate
que você criou acima lida com a atualização
nas posições finais nessas circunstâncias.
Use estes métodos para controlar o estado "Assistir em grupo":
CoWatchingClient.notifySwitchToMedia
: Chamar sempre que a mídia em reprodução for alterada. Por exemplo, o usuário seleciona um novo vídeo, ou a reprodução automática inicia o próximo vídeo.CoWatchingClient.notifyPauseState
: Chamar quando um usuário pausar ou retomar a mídia em reprodução.CoWatchingClient.notifySeekToTimestamp
: Chame quando um usuário alterar explicitamente a posição de reprodução.CoWatchingClient.notifyPlayoutRate
: Chame quando um usuário atualizar a velocidade de reprodução para um novo valor (por exemplo, 1,25x).CoWatchingClient.notifyBuffering
: Chamar quando o app de um usuário iniciar o armazenamento em buffer devido ao armazenamento em buffer de uma mídia anterior comutação, busca de mídia ou congestionamento de rede.CoWatchingClient.notifyReady
: Chame quando o armazenamento em buffer for concluído e a mídia estiver pronta para ser reproduzida.