Mengimplementasikan Co-Watching API

Panduan ini menjelaskan cara menerapkan Co-Watching API.

Membuat CoWatchingClient

Untuk memulai, buat createCoWatchingClient dari AddonSession yang Anda buat di Memulai.

Untuk membuat CoWatchingCient, panggil metode AddonSession.createCoWatchingClient dan berikan CoWatchingDelegate.

CoWatchingDelegate adalah cara Co-Watching API mengupdate aplikasi Anda setiap kali tersedia status baru. Diperkirakan, saat metode CoWatchingDelegate.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
    },
  });

Ganti ACTIVITY_TITLE dengan judul media aktivitas Anda.

Kelola status saat ini

Saat pengguna melakukan 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 melanjutkan pemutaran video. CoWatchingDelegate yang Anda buat di atas menangani perolehan posisi playout yang diperbarui dalam situasi ini.

Anda dapat mengontrol status menonton bersama menggunakan metode berikut:

• CoWatchingClient.notifySwitchToMedia: Memanggil setiap kali media yang sedang diputar berubah. Misalnya, pengguna memilih video baru, atau putar otomatis akan memulai video berikutnya.
• CoWatchingClient.notifyPauseState: Memanggil saat pengguna menjeda atau membatalkan jeda media yang diputar.
• CoWatchingClient.notifySeekToTimestamp: Memanggil saat pengguna secara eksplisit mengubah posisi pemutaran.
• CoWatchingClient.notifyPlayoutRate: Memanggil saat pengguna memperbarui kecepatan pemutaran ke nilai baru (misalnya, 1,25x).
• CoWatchingClient.notifyBuffering: Memanggil saat aplikasi pengguna mulai melakukan buffering karena buffering dari tombol media, pencarian media, atau kemacetan jaringan sebelumnya.
• CoWatchingClient.notifyReady: Memanggil setelah buffering selesai dan media sekarang siap diputar.