L'API Co-Watching per la condivisione in tempo reale di Google Meet gestisce l'esperienza durante le riunioni di più partecipanti che guardano o ascoltano contenuti nella tua app.
Questa guida spiega come implementare l'API Co-Watching.
Crea un CoWatchingClient
Per iniziare, crea una createCoWatchingClient
dalla AddonSession
che hai creato in Inizia.
Per creare un CoWatchingCient
, chiama il metodo
AddonSession.createCoWatchingClient
e fornisci un
CoWatchingDelegate
.
L'CoWatchingDelegate
è il modo in cui l'API Co-Watching aggiorna la tua
applicazione ogni volta che è disponibile un nuovo stato. È previsto che, quando viene chiamato il metodo
CoWatchingDelegate.onCoWatchingStateChanged
, la tua applicazione applichi immediatamente il nuovo stato.
Il seguente esempio di codice mostra come utilizzare l'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
},
});
Sostituisci ACTIVITY_TITLE con il titolo multimediale della tua attività.
Gestisci stato attuale
Quando gli utenti eseguono azioni nella tua applicazione, ci si aspetta che l'applicazione chiami immediatamente i metodi API forniti.
Dovresti chiamare questi metodi solo in risposta a eventi significativi. Ad esempio, non è necessario chiamarli ogni volta che l'app avanza nella riproduzione di un video. L'elemento CoWatchingDelegate
creato in precedenza gestisce il recupero
delle posizioni di riproduzione aggiornate in queste circostanze.
Puoi controllare lo stato della visione condivisa utilizzando questi metodi:
CoWatchingClient.notifySwitchToMedia
: Chiama ogni volta che i contenuti multimediali in riproduzione attiva cambiano. Ad esempio, l'utente seleziona un nuovo video o la riproduzione automatica avvia il video successivo.CoWatchingClient.notifyPauseState
: chiamata quando un utente mette in pausa o riattiva la riproduzione dei contenuti multimediali.CoWatchingClient.notifySeekToTimestamp
: chiamata quando un utente cambia esplicitamente la posizione di gioco.CoWatchingClient.notifyPlayoutRate
: chiamata quando un utente aggiorna la velocità di riproduzione impostandola su un nuovo valore (ad esempio 1,25x).CoWatchingClient.notifyBuffering
: chiamata quando l'app di un utente avvia il buffering a causa del buffering di un sensore multimediale, di una ricerca multimediale precedente o di una congestione della rete in precedenza.CoWatchingClient.notifyReady
: effettua una chiamata quando il buffer è completato e il contenuto multimediale è pronto per essere riprodotto.