CoWatchingClient

Kotlin |Java

@PublicApi
interface CoWatchingClient

---

Representa uma sessão de assistir em grupo.

Informa o Meet sobre ações recentes do usuário (por exemplo, reproduzir/pausar/buscar) e fatores ambientais, como atrasos devido ao armazenamento em buffer de mídia.

Resumo

Constantes
const Double	MAX_PLAYOUT_RATE = 2.0 Taxa de Playout máxima permitida.
const Double	MAX_SEEKS_PER_SECOND = 0.9 Número máximo de buscas permitidas por segundo.

Funções públicas
Unit	notifyBuffering(mediaPlayoutPosition: Duration!) Notifica o Meet de que a mídia não está pronta para ser reproduzida devido a um armazenamento em buffer, a uma troca de mídia anterior, uma busca de mídia ou um congestionamento normal da rede.
Unit	notifyEnded(mediaPlayoutPosition: Duration!) Notifica o Meet de que o player de mídia chegou ao fim da mídia atual.
Unit	notifyPauseState(paused: Boolean, mediaPlayoutPosition: Duration!) Informe ao Meet que o usuário pausou ou retomou a reprodução de mídia. Assim, o Meet pode espelhar essa ação para outros usuários.
Unit	notifyPlayoutRate(rate: Double, mediaPlayoutPosition: Duration!) Notifica o Meet de que o usuário atualizou a taxa de reprodução da mídia (por exemplo,
Unit	notifyQueueUpdate(queue: CoWatchingQueue!) Informe ao Meet que a fila mudou para espelhar o conteúdo de outros usuários.
Unit	notifyReady(mediaPlayoutPosition: Duration!) Notifica o Meet que o armazenamento em buffer foi concluído e a mídia está pronta para ser reproduzida, começando no carimbo de data/hora fornecido.
Unit	notifySeekToTimestamp(mediaPlayoutPosition: Duration!) Informe ao Meet que o usuário procurou o ponto de reprodução da mídia. Assim, o Meet poderá espelhar essa ação para outros usuários.
Unit	notifySwitchedToMedia(     mediaTitle: String!,     mediaId: String!,     mediaPlayoutPosition: Duration! ) Informe ao Meet que o usuário trocou de mídia para que ele possa repassar para outros usuários.
Unit	notifySwitchedToMedia(     mediaTitle: String!,     mediaId: String!,     mediaPlayoutPosition: Duration!,     queue: CoWatchingQueue! ) Notifique o Meet de que o usuário trocou de mídia, com uma atualização de fila simultânea, para que o Meet possa repassar a informação a outros usuários.

Constantes

MAX_PLAYOUT_RATE

const val MAX_PLAYOUT_RATE = 2.0: Double

Taxa de Playout máxima permitida.

MAX_SEEKS_PER_SECOND

const val MAX_SEEKS_PER_SECOND = 0.9: Double

Número máximo de buscas permitidas por segundo.

Funções públicas

notifyBuffering

fun notifyBuffering(mediaPlayoutPosition: Duration!): Unit

Notifica o Meet de que a mídia não está pronta para ser reproduzida devido a um armazenamento em buffer, a uma troca de mídia anterior, uma busca de mídia ou um congestionamento normal da rede.

Parâmetros
mediaPlayoutPosition: Duration!	a posição em que a mídia está pausada, aguardando a conclusão do armazenamento em buffer

Gera
java.lang.NullPointerException	se mediaPlayoutPosition for nulo
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo

notifyEnded

fun notifyEnded(mediaPlayoutPosition: Duration!): Unit

Notifica o Meet de que o player de mídia chegou ao fim da mídia atual.

Observação:não é necessário chamar esse método, embora não seja prejudicial, se o notificationSwitchedToMedia for chamado por um mecanismo de reprodução automática assim que uma mídia terminar.

Parâmetros
mediaPlayoutPosition: Duration!	a posição final do player

Gera
java.lang.NullPointerException	se mediaPlayoutPosition for nulo
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo

notifyPauseState

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

Informe ao Meet que o usuário pausou ou retomou a reprodução de mídia. Assim, o Meet pode espelhar essa ação para outros usuários.

Parâmetros
paused: Boolean	true se a reprodução estiver pausada ou false se a reprodução for retomada
mediaPlayoutPosition: Duration!	a posição em que a mídia foi pausada ou retomada

Gera
java.lang.NullPointerException	se mediaPlayoutPosition for nulo
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo

notifyPlayoutRate

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

Notifica o Meet de que o usuário atualizou a taxa de reprodução da mídia (por exemplo, 1,25x) para um novo valor.

Parâmetros
rate: Double	a frequência com que a mídia está sendo reproduzida
mediaPlayoutPosition: Duration!	a posição atual do player

Gera
java.lang.IllegalStateException	se rate não for um número positivo
java.lang.IllegalStateException	se rate for maior que MAX_PLAYOUT_RATE
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo

notifyQueueUpdate

fun notifyQueueUpdate(queue: CoWatchingQueue!): Unit

Informe ao Meet que a fila mudou para espelhar o conteúdo de outros usuários.

Parâmetros
queue: CoWatchingQueue!	informações sobre a fila do app do complemento

Gera
java.lang.NullPointerException	se queue for nulo
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo

notifyReady

fun notifyReady(mediaPlayoutPosition: Duration!): Unit

Notifica o Meet que o armazenamento em buffer foi concluído e a mídia está pronta para ser reproduzida, começando no carimbo de data/hora fornecido.

Parâmetros
mediaPlayoutPosition: Duration!	a posição em que a mídia está armazenada em buffer e pronta para ser reproduzida

Gera
java.lang.NullPointerException	se mediaPlayoutPosition for nulo
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo

notifySeekToTimestamp

fun notifySeekToTimestamp(mediaPlayoutPosition: Duration!): Unit

Informe ao Meet que o usuário procurou o ponto de reprodução da mídia. Assim, o Meet poderá espelhar essa ação para outros usuários.

Parâmetros
mediaPlayoutPosition: Duration!	o carimbo de data/hora que o usuário procurou

Gera
java.lang.NullPointerException	se mediaPlayoutPosition for nulo
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo
java.lang.IllegalStateException	se o número de buscas por segundo for maior que MAX_SEEKS_PER_SECOND

notifySwitchedToMedia

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

Informe ao Meet que o usuário trocou de mídia para que ele possa repassar para outros usuários.

Parâmetros
mediaTitle: String!	o título da mídia foi alterado. Esse título será exibido na interface do Meet quando outros usuários quiserem se conectar à sessão de assistir em grupo.
mediaId: String!	o URI da string da mídia mudou para
mediaPlayoutPosition: Duration!	a posição em que a mídia iniciou a reprodução

Gera
java.lang.NullPointerException	quando mediaId ou mediaPlayoutPosition são nulos
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo

notifySwitchedToMedia

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

Notifique o Meet de que o usuário trocou de mídia, com uma atualização de fila simultânea, para que o Meet possa repassar a informação a outros usuários.

Parâmetros
mediaTitle: String!	o título da mídia foi alterado. Esse título será exibido na interface do Meet quando outros usuários quiserem se conectar à sessão de assistir em grupo.
mediaId: String!	o URI da string da mídia mudou para
mediaPlayoutPosition: Duration!	a posição em que a mídia iniciou a reprodução
queue: CoWatchingQueue!	informações sobre a fila do app do complemento

Gera
java.lang.NullPointerException	se mediaId, mediaPlayoutPosition ou queue forem nulos
com.google.android.meet.addons.AddonException	se houve um erro inesperado
java.lang.IllegalStateException	se for chamado após o término da sessão de assistir em grupo