CoWatchingClient

Kotlin |Java

@PublicApi
interface CoWatchingClient

---

Rappresenta una sessione di visualizzazione condivisa.

Informa Meet sulle azioni recenti dell'utente (ad esempio riproduzione, pausa o ricerca) e su fattori ambientali come i ritardi dovuti al buffering dei contenuti multimediali.

Riepilogo

Costanti
const Double	MAX_PLAYOUT_RATE = 2.0 Percentuale massima di playout consentita.
const Double	MAX_SEEKS_PER_SECOND = 0.9 Numero massimo di ricerche consentite al secondo.

Funzioni pubbliche
Unit	notifyBuffering(mediaPlayoutPosition: Duration!) Comunica a Meet che i contenuti multimediali non sono pronti per essere riprodotti a causa del buffering, di un passaggio multimediale precedente, di una ricerca multimediale o di una normale congestione della rete.
Unit	notifyEnded(mediaPlayoutPosition: Duration!) Comunica a Meet che il media player ha raggiunto la fine dei contenuti multimediali attuali.
Unit	notifyPauseState(paused: Boolean, mediaPlayoutPosition: Duration!) Comunica a Meet che l'utente ha messo in pausa o riattivato la riproduzione dei contenuti multimediali, in modo che Meet possa eseguire il mirroring di quell'azione per altri utenti.
Unit	notifyPlayoutRate(rate: Double, mediaPlayoutPosition: Duration!) Comunica a Meet che l'utente ha aggiornato la percentuale di riproduzione dei contenuti multimediali (ad es.
Unit	notifyQueueUpdate(queue: CoWatchingQueue!) Comunica a Meet che la coda è cambiata, in modo che Meet possa eseguirne il mirroring per altri utenti.
Unit	notifyReady(mediaPlayoutPosition: Duration!) Comunica a Meet che il buffering è stato completato e che i contenuti multimediali sono ora pronti per essere riprodotti, a partire dal timestamp fornito.
Unit	notifySeekToTimestamp(mediaPlayoutPosition: Duration!) Comunica a Meet che l'utente ha cercato il punto di riproduzione dei contenuti multimediali, in modo che Meet possa eseguire il mirroring dell'azione per altri utenti.
Unit	notifySwitchedToMedia(     mediaTitle: String!,     mediaId: String!,     mediaPlayoutPosition: Duration! ) Comunica a Meet che l'utente ha cambiato contenuto multimediale, in modo che Meet possa inoltrarlo ad altri utenti.
Unit	notifySwitchedToMedia(     mediaTitle: String!,     mediaId: String!,     mediaPlayoutPosition: Duration!,     queue: CoWatchingQueue! ) Comunica a Meet che l'utente ha cambiato contenuto multimediale, con un aggiornamento simulato della coda, in modo che Meet possa inoltrare la richiesta ad altri utenti.

Costanti

MAX_PLAYOUT_RATE

const val MAX_PLAYOUT_RATE = 2.0: Double

Percentuale massima di playout consentita.

MAX_SEEKS_PER_SECOND

const val MAX_SEEKS_PER_SECOND = 0.9: Double

Numero massimo di ricerche consentite al secondo.

Funzioni pubbliche

notifyBuffering

fun notifyBuffering(mediaPlayoutPosition: Duration!): Unit

Comunica a Meet che i contenuti multimediali non sono pronti per essere riprodotti a causa del buffering, di un passaggio multimediale precedente, di una ricerca multimediale o di una normale congestione della rete.

Parametri
mediaPlayoutPosition: Duration!	la posizione in cui i contenuti multimediali sono in pausa, in attesa del completamento del buffering.

Lanci
java.lang.NullPointerException	se mediaPlayoutPosition è null
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa

notifyEnded

fun notifyEnded(mediaPlayoutPosition: Duration!): Unit

Comunica a Meet che il media player ha raggiunto la fine dei contenuti multimediali attuali.

Nota:la chiamata di questo metodo non è necessaria (sebbene non sia dannosa) se notificationSwitchedToMedia viene chiamato tramite un meccanismo di riproduzione automatica non appena termina un contenuto multimediale.

Parametri
mediaPlayoutPosition: Duration!	la posizione finale del player

Lanci
java.lang.NullPointerException	se mediaPlayoutPosition è null
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa

notifyPauseState

fun notifyPauseState(paused: Boolean, mediaPlayoutPosition: Duration!): Unit

Comunica a Meet che l'utente ha messo in pausa o riattivato la riproduzione dei contenuti multimediali, in modo che Meet possa eseguire il mirroring di quell'azione per altri utenti.

Parametri
paused: Boolean	true se in pausa o false se la riproduzione è ripresa
mediaPlayoutPosition: Duration!	la posizione in cui i contenuti multimediali sono stati messi in pausa o riattivati

Lanci
java.lang.NullPointerException	se mediaPlayoutPosition è null
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa

notifyPlayoutRate

fun notifyPlayoutRate(rate: Double, mediaPlayoutPosition: Duration!): Unit

Comunica a Meet che l'utente ha aggiornato la percentuale di riproduzione dei contenuti multimediali (ad es. 1,25x) a un nuovo valore.

Parametri
rate: Double	la velocità con cui i contenuti multimediali vengono riprodotti
mediaPlayoutPosition: Duration!	la posizione corrente del player

Lanci
java.lang.IllegalStateException	se rate non è un numero positivo
java.lang.IllegalStateException	se rate è maggiore di MAX_PLAYOUT_RATE
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa

notifyQueueUpdate

fun notifyQueueUpdate(queue: CoWatchingQueue!): Unit

Comunica a Meet che la coda è cambiata, in modo che Meet possa eseguirne il mirroring per altri utenti.

Parametri
queue: CoWatchingQueue!	informazioni sulla coda dell'app del componente aggiuntivo

Lanci
java.lang.NullPointerException	se queue è null
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa

notifyReady

fun notifyReady(mediaPlayoutPosition: Duration!): Unit

Comunica a Meet che il buffering è stato completato e che i contenuti multimediali sono ora pronti per essere riprodotti, a partire dal timestamp fornito.

Parametri
mediaPlayoutPosition: Duration!	la posizione in cui il contenuto multimediale è memorizzato nel buffer ed è pronto per la riproduzione

Lanci
java.lang.NullPointerException	se mediaPlayoutPosition è null
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa

notifySeekToTimestamp

fun notifySeekToTimestamp(mediaPlayoutPosition: Duration!): Unit

Comunica a Meet che l'utente ha cercato il punto di riproduzione dei contenuti multimediali, in modo che Meet possa eseguire il mirroring dell'azione per altri utenti.

Parametri
mediaPlayoutPosition: Duration!	il timestamp fino a cui l'utente ha eseguito la ricerca

Lanci
java.lang.NullPointerException	se mediaPlayoutPosition è null
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa
java.lang.IllegalStateException	se il numero di ricerche al secondo è maggiore di MAX_SEEKS_PER_SECOND

notifySwitchedToMedia

fun notifySwitchedToMedia(
    mediaTitle: String!,
    mediaId: String!,
    mediaPlayoutPosition: Duration!
): Unit

Comunica a Meet che l'utente ha cambiato contenuto multimediale, in modo che Meet possa inoltrarlo ad altri utenti.

Parametri
mediaTitle: String!	il titolo del contenuto multimediale. Questo titolo apparirà nella UI di Meet quando altri utenti prenderanno in considerazione la possibilità di connettersi alla sessione di visualizzazione condivisa.
mediaId: String!	l'URI stringa del supporto multimediale passa a
mediaPlayoutPosition: Duration!	la posizione in cui i media hanno iniziato i playout

Lanci
java.lang.NullPointerException	se mediaId o mediaPlayoutPosition sono null
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa

notifySwitchedToMedia

fun notifySwitchedToMedia(
    mediaTitle: String!,
    mediaId: String!,
    mediaPlayoutPosition: Duration!,
    queue: CoWatchingQueue!
): Unit

Comunica a Meet che l'utente ha cambiato contenuto multimediale, con un aggiornamento simulato della coda, in modo che Meet possa inoltrare la richiesta ad altri utenti.

Parametri
mediaTitle: String!	il titolo del contenuto multimediale. Questo titolo apparirà nella UI di Meet quando altri utenti prenderanno in considerazione la possibilità di connettersi alla sessione di visualizzazione condivisa.
mediaId: String!	l'URI stringa del supporto multimediale passa a
mediaPlayoutPosition: Duration!	la posizione in cui i media hanno iniziato i playout
queue: CoWatchingQueue!	informazioni sulla coda dell'app del componente aggiuntivo

Lanci
java.lang.NullPointerException	se mediaId, mediaPlayoutPosition o queue sono null
com.google.android.meet.addons.AddonException	se si è verificato un errore imprevisto
java.lang.IllegalStateException	se chiamata al termine della sessione di visualizzazione condivisa