Mengimplementasikan Co-Watching API

Co-Watching API mengelola pengalaman rapat dari peserta yang menonton atau mendengarkan konten di aplikasi Anda.

Panduan ini menjelaskan cara menerapkan Co-Watching API.

Mulai

Untuk menggunakan Co-Watching API, Anda harus terlebih dahulu Membuat Add-on Meet. Satu kali telah menyelesaikan langkah-langkah tersebut, Anda dapat mulai menggunakan Co-Watching API dari dalam add-on baru Anda.

Untuk menggunakan Co-Watching API, mulailah dengan mendapatkan Objek AddonSession, yang berfungsi sebagai titik entri untuk aktivitas bersama Google Meet:

const session = await window.meet.addon.createAddonSession({
    cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});

Membuat klien menonton bersama

Untuk memulai, buat CoWatchingClient dari AddonSession Anda.

Untuk membuat CoWatchingCient, panggil metode createCoWatchingClient() dan menyediakan CoWatchingDelegate .

CoWatchingDelegate adalah cara Co-Watching API mengupdate aplikasi Anda setiap kali ada status baru yang tersedia. Diharapkan, saat metode onCoWatchingStateChanged() dipanggil, aplikasi Anda akan segera menerapkan status baru.

Contoh kode berikut menunjukkan cara menggunakan Co-Watching API:

 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
    },
  });

Kelola status saat ini

Saat pengguna mengambil tindakan dalam aplikasi, aplikasi Anda diharapkan segera memanggil metode API yang disediakan.

Anda hanya boleh memanggil metode ini sebagai respons terhadap peristiwa signifikan. Misalnya, Anda tidak perlu memanggilnya setiap kali aplikasi memajukan video yang sedang diputar. CoWatchingDelegate yang Anda buat mendapatkan nama sebutan channel yang diperbarui posisi dalam situasi seperti ini.

Anda dapat mengontrol status menonton bersama menggunakan metode berikut:

• notifyBuffering(): Panggilan saat aplikasi pengguna mulai buffering karena buffering dari media sebelumnya {i>switch<i}, pencarian media, atau kemacetan jaringan.

• notifyPauseState(): Lakukan panggilan saat pengguna menjeda atau melanjutkan pemutaran media.

• notifyPlayoutRate(): Memanggil saat pengguna memperbarui kecepatan pemutaran ke nilai baru (misalnya, 1,25x).

• notifyReady(): Panggil saat buffering selesai dan media kini siap untuk diputar.

• notifySeekToTimestamp(): Memanggil saat pengguna secara eksplisit mengubah posisi pemutaran.

• notifySwitchToMedia(): Panggil setiap kali media yang sedang diputar berubah. Misalnya, pengguna memilih video baru, atau putar otomatis memulai video berikutnya.