CoWatchingКлиент

Котлин | Джава

@PublicApi
interface CoWatchingClient

---

Представляет сеанс совместного просмотра.

Информирует Meet о недавних действиях пользователя (например, воспроизведение/пауза/поиск) и факторах окружающей среды, таких как задержки из-за буферизации мультимедиа.

Краткое содержание

Константы
const Double	MAX_PLAYOUT_RATE = 2.0 Максимально допустимая скорость воспроизведения.
const Double	MAX_SEEKS_PER_SECOND = 0.9 Максимально разрешенное количество поисков в секунду.

Общественные функции
Unit	notifyBuffering (mediaPlayoutPosition: Duration !) Уведомляет Meet о том, что медиафайл не готов к воспроизведению из-за буферизации, предыдущего переключения мультимедиа, поиска мультимедиа или обычной перегрузки сети.
Unit	notifyEnded (mediaPlayoutPosition: Duration !) Уведомляет Meet о том, что медиаплеер достиг конца текущего медиафайла.
Unit	notifyPauseState (paused: Boolean , mediaPlayoutPosition: Duration !) Сообщите Meet о том, что пользователь приостановил или возобновил воспроизведение мультимедиа, чтобы Meet мог отразить это действие для других пользователей.
Unit	notifyPlayoutRate (rate: Double , mediaPlayoutPosition: Duration !) Уведомляет Meet о том, что пользователь обновил скорость воспроизведения мультимедиа (например,
Unit	notifyQueueUpdate (queue: CoWatchingQueue !) Сообщите Meet об изменении очереди, чтобы Meet мог отразить ее для других пользователей.
Unit	notifyReady (mediaPlayoutPosition: Duration !) Уведомляет Meet о том, что буферизация завершена и медиафайл готов к воспроизведению, начиная с указанной отметки времени.
Unit	notifySeekToTimestamp (mediaPlayoutPosition: Duration !) Сообщите Meet о том, что пользователь нашел точку воспроизведения мультимедиа, чтобы Meet мог отразить это действие для других пользователей.
Unit	notifySwitchedToMedia ( mediaTitle: String !, mediaId: String !, mediaPlayoutPosition: Duration ! ) Сообщите Meet о том, что пользователь переключил медиафайл, чтобы Meet мог передать это другим пользователям.
Unit	notifySwitchedToMedia ( mediaTitle: String !, mediaId: String !, mediaPlayoutPosition: Duration !, queue: CoWatchingQueue ! ) Уведомите Meet о том, что пользователь переключил носитель, с помощью симулированного обновления очереди, чтобы Meet мог передать это другим пользователям.

Константы

MAX_PLAYOUT_RATE

const val MAX_PLAYOUT_RATE = 2.0: Double

Максимально допустимая скорость воспроизведения.

MAX_SEEKS_PER_SECOND

const val MAX_SEEKS_PER_SECOND = 0.9: Double

Максимально разрешенное количество поисков в секунду.

Общественные функции

уведомитьБуферизация

fun notifyBuffering(mediaPlayoutPosition: Duration!): Unit

Уведомляет Meet о том, что медиафайл не готов к воспроизведению из-за буферизации, предыдущего переключения мультимедиа, поиска мультимедиа или обычной перегрузки сети.

Параметры
mediaPlayoutPosition: Duration !	позиция, в которой медиа приостанавливается в ожидании завершения буферизации

Броски
java.lang.NullPointerException	если mediaPlayoutPosition имеет значение null
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра

уведомитьЗавершено

fun notifyEnded(mediaPlayoutPosition: Duration!): Unit

Уведомляет Meet о том, что медиаплеер достиг конца текущего медиафайла.

Примечание. вызов этого метода не требуется (хотя и не вреден), если notifySwitchedToMedia вызывается через механизм автоматического воспроизведения, как только медиафайл заканчивается.

Параметры
mediaPlayoutPosition: Duration !	конечная позиция игрока

Броски
java.lang.NullPointerException	если mediaPlayoutPosition имеет значение null
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра

уведомитьПаузестате

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

Сообщите Meet о том, что пользователь приостановил или возобновил воспроизведение мультимедиа, чтобы Meet мог отразить это действие для других пользователей.

Параметры
paused: Boolean	true , если воспроизведение приостановлено, или false если воспроизведение возобновлено
mediaPlayoutPosition: Duration !	позиция, в которой воспроизведение мультимедиа было приостановлено или возобновлено

Броски
java.lang.NullPointerException	если mediaPlayoutPosition имеет значение null
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра

уведомитьPlayoutRate

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

Уведомляет Meet о том, что пользователь обновил скорость воспроизведения мультимедиа (например, 1,25x) до нового значения.

Параметры
rate: Double	скорость, с которой сейчас воспроизводятся медиафайлы
mediaPlayoutPosition: Duration !	текущая позиция игрока

Броски
java.lang.IllegalStateException	если rate не является положительным числом
java.lang.IllegalStateException	если rate больше MAX_PLAYOUT_RATE
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра

уведомитьQueueUpdate

fun notifyQueueUpdate(queue: CoWatchingQueue!): Unit

Сообщите Meet об изменении очереди, чтобы Meet мог отразить ее для других пользователей.

Параметры
queue: CoWatchingQueue !	информация об очереди приложения-дополнения

Броски
java.lang.NullPointerException	если queue равна нулю
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра

уведомитьГотово

fun notifyReady(mediaPlayoutPosition: Duration!): Unit

Уведомляет Meet о том, что буферизация завершена и медиафайл готов к воспроизведению, начиная с указанной отметки времени.

Параметры
mediaPlayoutPosition: Duration !	позиция, в которой медиафайл находится в буфере и готов к воспроизведению

Броски
java.lang.NullPointerException	если mediaPlayoutPosition имеет значение null
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра

уведомитьSeekToTimestamp

fun notifySeekToTimestamp(mediaPlayoutPosition: Duration!): Unit

Сообщите Meet о том, что пользователь нашел точку воспроизведения мультимедиа, чтобы Meet мог отразить это действие для других пользователей.

Параметры
mediaPlayoutPosition: Duration !	временная метка, к которой искал пользователь

Броски
java.lang.NullPointerException	если mediaPlayoutPosition имеет значение null
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра
java.lang.IllegalStateException	если количество поисков в секунду превышает MAX_SEEKS_PER_SECOND

уведомитьSwitchedToMedia

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

Сообщите Meet о том, что пользователь переключил медиафайл, чтобы Meet мог передать это другим пользователям.

Параметры
mediaTitle: String !	название СМИ переключилось на. Этот заголовок будет отображаться в пользовательском интерфейсе Meet, когда другие пользователи планируют подключиться к сеансу совместного просмотра.
mediaId: String !	строковый URI носителя, переключенный на
mediaPlayoutPosition: Duration !	позиция, с которой СМИ начали воспроизведение

Броски
java.lang.NullPointerException	если mediaId или mediaPlayoutPosition имеют значение null
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра

уведомитьSwitchedToMedia

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

Уведомите Meet о том, что пользователь переключил носитель, с помощью симулированного обновления очереди, чтобы Meet мог передать это другим пользователям.

Параметры
mediaTitle: String !	название СМИ переключилось на. Этот заголовок будет отображаться в пользовательском интерфейсе Meet, когда другие пользователи планируют подключиться к сеансу совместного просмотра.
mediaId: String !	строковый URI носителя, переключенный на
mediaPlayoutPosition: Duration !	позиция, с которой СМИ начали воспроизведение
queue: CoWatchingQueue !	информация об очереди приложения-дополнения

Броски
java.lang.NullPointerException	если mediaId , mediaPlayoutPosition или queue имеют значение null
com.google.android.meet.addons.AddonException	если произошла непредвиденная ошибка
java.lang.IllegalStateException	если позвонят после окончания сеанса совместного просмотра