Mengimplementasikan Co-Doing API

Co-Doing API digunakan untuk menyinkronkan data arbitrer antar-peserta rapat. Data ini dapat berupa data apa pun yang diperlukan aplikasi Anda.

Anda harus melakukan serialisasi data ke Uint8Array agar dapat dikirim. Untuk informasi selengkapnya, lihat referensi library standar JavaScript.

Jika Anda tidak yakin cara melakukan serialisasi data, tinjau contoh kode berikut.

Panduan ini menjelaskan cara menerapkan Co-Doing API.

Mulai

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

Untuk menggunakan Co-Doing 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-doing

Untuk memulai, buat objek CoDoingClient dari AddonSession Anda.

Untuk membuat CoDoingClient, panggil metode createCoDoingClient() dan sediakan objek CoDoingDelegate.

CoDoingDelegate adalah cara Co-Doing API mengupdate aplikasi Anda setiap kali memiliki status baru yang tersedia. Diharapkan, saat metode onCoDoingStateChanged() dipanggil, aplikasi Anda akan segera menerapkan status baru.

Contoh kode berikut menunjukkan cara menggunakan Co-Doing API:

TypeScript

interface MyState {
  someString: string;
  someNumber: number;
}

/**
 * Serialize/deserialize using JSON.stringify
 * You can use any method you want; this is included for as an example
 */
function toBytes(state: MyState): Uint8Array {
  return new TextEncoder().encode(JSON.stringify(state));
}

function fromBytes(bytes: Uint8Array): MyState {
  return JSON.parse(new TextDecoder().decode(bytes)) as MyState;
}

  const coDoingClient = await addonSession.createCoDoingClient({
    activityTitle: "ACTIVITY_TITLE",
    onCoDoingStateChanged(coDoingState: CoDoingState) {
      const newState = fromBytes(coDoingState.bytes);
      // This function should apply the new state to your ongoing CoDoing activity
    },
  });

Ganti ACTIVITY_TITLE dengan judul aktivitas Anda.

Mengelola status saat ini

Saat pengguna melakukan tindakan di aplikasi, aplikasi Anda diharapkan segera memanggil metode broadcastStateUpdate().

Contoh kode berikut menunjukkan implementasi metode broadcastStateUpdate():

TypeScript

const myState: MyState = {
  someString: "SOME_STRING",
  someNumber: 0
};

document.getElementById('some-button').onClick(() => {
  myState.someNumber = myState.someNumber + 1;
  coDoingClient.broadcastStateUpdate({ bytes: toBytes(myState) });
});

Ganti SOME_STRING dengan status aplikasi saat ini.