Mengimplementasikan Co-Watching API

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

Panduan ini menjelaskan cara menerapkan Co-Watching API.

Mulai

Untuk menggunakan Co-Watching API, Anda harus Men-deploy Add-on Meet terlebih dahulu. Setelah menyelesaikan langkah-langkah tersebut, Anda dapat mulai menggunakan Co-Watching API dari dalam add-on baru.

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

TypeScript

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

Ganti CLOUD_PROJECT_NUMBER dengan nomor project project Google Cloud Anda.

Membuat klien co-watching

Untuk memulai, buat objek CoWatchingClient dari AddonSession Anda.

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

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

Contoh kode berikut menunjukkan cara menggunakan Co-Watching API:

TypeScript

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

Ganti ACTIVITY_TITLE dengan judul media aktivitas Anda.

Mengelola status saat ini

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

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

Anda dapat mengontrol status menonton bersama menggunakan metode berikut:

  • notifyBuffering(): Panggil saat aplikasi pengguna mulai melakukan buffering karena buffering dari pengalihan media sebelumnya, pencarian media, atau kemacetan jaringan.

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

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

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

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

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