CoWatchingClient

Kotlin |Java

@PublicApi
interface CoWatchingClient

---

Merepresentasikan sesi menonton bersama.

Memberi tahu Meet tentang tindakan terbaru pengguna (misalnya, memutar/menjeda/mencari) dan faktor lingkungan seperti penundaan karena buffering media.

Ringkasan

Konstanta
const Double	MAX_PLAYOUT_RATE = 2.0 Rasio pemutaran maksimum yang diizinkan.
const Double	MAX_SEEKS_PER_SECOND = 0.9 Jumlah maksimum pencarian yang diizinkan per detik.

Fungsi publik
Unit	notifyBuffering(mediaPlayoutPosition: Duration!) Memberi tahu Meet bahwa media belum siap diputar karena buffering, karena adanya pengalihan media sebelumnya, pencarian media, atau kemacetan jaringan normal.
Unit	notifyEnded(mediaPlayoutPosition: Duration!) Memberi tahu Meet bahwa pemutar media telah mencapai bagian akhir media saat ini.
Unit	notifyPauseState(paused: Boolean, mediaPlayoutPosition: Duration!) Beri tahu Meet bahwa pengguna telah menjeda atau membatalkan jeda pemutaran media, sehingga Meet dapat mencerminkan tindakan tersebut untuk pengguna lain.
Unit	notifyPlayoutRate(rate: Double, mediaPlayoutPosition: Duration!) Memberi tahu Meet bahwa pengguna telah memperbarui rasio pemutaran media (misalnya,
Unit	notifyQueueUpdate(queue: CoWatchingQueue!) Beri tahu Meet bahwa antrean telah berubah, sehingga Meet dapat mencerminkannya untuk pengguna lain.
Unit	notifyReady(mediaPlayoutPosition: Duration!) Memberi tahu Meet bahwa buffering telah selesai dan media kini siap diputar, dimulai pada stempel waktu yang diberikan.
Unit	notifySeekToTimestamp(mediaPlayoutPosition: Duration!) Beri tahu Meet bahwa pengguna telah mencari titik pemutaran media, agar Meet dapat mencerminkan tindakan tersebut untuk pengguna lain.
Unit	notifySwitchedToMedia(     mediaTitle: String!,     mediaId: String!,     mediaPlayoutPosition: Duration! ) Beri tahu Meet bahwa pengguna telah beralih media agar Meet dapat meneruskannya kepada pengguna lain.
Unit	notifySwitchedToMedia(     mediaTitle: String!,     mediaId: String!,     mediaPlayoutPosition: Duration!,     queue: CoWatchingQueue! ) Beri tahu Meet bahwa pengguna telah beralih media, dengan pembaruan antrean simulasi, sehingga Meet dapat meneruskannya kepada pengguna lain.

Konstanta

MAX_PLAYOUT_RATE

const val MAX_PLAYOUT_RATE = 2.0: Double

Rasio pemutaran maksimum yang diizinkan.

MAX_SEEKS_PER_SECOND

const val MAX_SEEKS_PER_SECOND = 0.9: Double

Jumlah maksimum pencarian yang diizinkan per detik.

Fungsi publik

notifyBuffering

fun notifyBuffering(mediaPlayoutPosition: Duration!): Unit

Memberi tahu Meet bahwa media belum siap diputar karena buffering, karena adanya pengalihan media sebelumnya, pencarian media, atau kemacetan jaringan normal.

Parameter
mediaPlayoutPosition: Duration!	posisi saat media dijeda, menunggu buffering selesai

Menampilkan
java.lang.NullPointerException	jika mediaPlayoutPosition adalah null
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir

notifyEnded

fun notifyEnded(mediaPlayoutPosition: Duration!): Unit

Memberi tahu Meet bahwa pemutar media telah mencapai bagian akhir media saat ini.

Catatan: memanggil metode ini tidak diperlukan (meskipun tidak berbahaya) jika sheetSwitchedToMedia dipanggil melalui mekanisme putar otomatis segera setelah media berakhir.

Parameter
mediaPlayoutPosition: Duration!	posisi akhir pemain

Menampilkan
java.lang.NullPointerException	jika mediaPlayoutPosition adalah null
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir

notifyPauseState

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

Beri tahu Meet bahwa pengguna telah menjeda atau membatalkan jeda pemutaran media, sehingga Meet dapat mencerminkan tindakan tersebut untuk pengguna lain.

Parameter
paused: Boolean	true jika dijeda atau false jika pemutaran dilanjutkan
mediaPlayoutPosition: Duration!	posisi saat media dijeda atau dibatalkan jedanya

Menampilkan
java.lang.NullPointerException	jika mediaPlayoutPosition adalah null
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir

notifyPlayoutRate

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

Memberi tahu Meet bahwa pengguna telah memperbarui rasio pemutaran media (misalnya, 1,25x) ke nilai baru.

Parameter
rate: Double	kecepatan media saat ini diputar
mediaPlayoutPosition: Duration!	posisi pemutar saat ini

Menampilkan
java.lang.IllegalStateException	jika rate bukan bilangan positif
java.lang.IllegalStateException	jika rate lebih besar dari MAX_PLAYOUT_RATE
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir

notifyQueueUpdate

fun notifyQueueUpdate(queue: CoWatchingQueue!): Unit

Beri tahu Meet bahwa antrean telah berubah, sehingga Meet dapat mencerminkannya untuk pengguna lain.

Parameter
queue: CoWatchingQueue!	info tentang antrean aplikasi add-on

Menampilkan
java.lang.NullPointerException	jika queue adalah null
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir

notifyReady

fun notifyReady(mediaPlayoutPosition: Duration!): Unit

Memberi tahu Meet bahwa buffering telah selesai dan media kini siap diputar, dimulai pada stempel waktu yang diberikan.

Parameter
mediaPlayoutPosition: Duration!	posisi saat media di-buffer dan siap diputar

Menampilkan
java.lang.NullPointerException	jika mediaPlayoutPosition adalah null
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir

notifySeekToTimestamp

fun notifySeekToTimestamp(mediaPlayoutPosition: Duration!): Unit

Beri tahu Meet bahwa pengguna telah mencari titik pemutaran media, agar Meet dapat mencerminkan tindakan tersebut untuk pengguna lain.

Parameter
mediaPlayoutPosition: Duration!	stempel waktu yang dicari pengguna

Menampilkan
java.lang.NullPointerException	jika mediaPlayoutPosition adalah null
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir
java.lang.IllegalStateException	jika jumlah pencarian per detik lebih besar dari MAX_SEEKS_PER_SECOND

notifySwitchedToMedia

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

Beri tahu Meet bahwa pengguna telah beralih media agar Meet dapat meneruskannya kepada pengguna lain.

Parameter
mediaTitle: String!	judul media yang diganti. Judul ini akan ditampilkan di UI Meet saat pengguna lain mempertimbangkan untuk terhubung ke sesi menonton bersama.
mediaId: String!	URI string media beralih ke
mediaPlayoutPosition: Duration!	posisi saat media mulai diputar

Menampilkan
java.lang.NullPointerException	jika mediaId atau mediaPlayoutPosition adalah null
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir

notifySwitchedToMedia

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

Beri tahu Meet bahwa pengguna telah beralih media, dengan pembaruan antrean simulasi, sehingga Meet dapat meneruskannya kepada pengguna lain.

Parameter
mediaTitle: String!	judul media yang diganti. Judul ini akan ditampilkan di UI Meet saat pengguna lain mempertimbangkan untuk terhubung ke sesi menonton bersama.
mediaId: String!	URI string media beralih ke
mediaPlayoutPosition: Duration!	posisi saat media mulai diputar
queue: CoWatchingQueue!	info tentang antrean aplikasi add-on

Menampilkan
java.lang.NullPointerException	jika mediaId, mediaPlayoutPosition, atau queue adalah null
com.google.android.meet.addons.AddonException	jika terjadi error tidak terduga
java.lang.IllegalStateException	jika dipanggil setelah sesi menonton bersama berakhir