Menggunakan status awal kolaborasi

Halaman ini menjelaskan tujuan CollaborationStartingState dan cara menetapkan serta mengambilnya dari SDK Add-on Google Meet.

Ringkasan status awal kolaborasi

Saat add-on pertama kali dibuka, iframe panel samping memuat URL yang ditentukan dalam manifes add-on. Status awal ini mungkin berbeda dengan status awal yang ingin digunakan add-on saat pengguna bergabung menggunakan undangan kolaborasi. CollaborationStartingState dapat digunakan untuk menentukan URL iframe yang harus dimuat saat pengguna bergabung menggunakan undangan kolaborasi. Selain itu, kolom additional_data dapat digunakan oleh add-on untuk menyimpan data yang mungkin diperlukan untuk inisialisasinya.

Menetapkan, mendapatkan, dan menghapus status awal kolaborasi

Anda dapat mengelola CollaborationStartingState dengan metode berikut.

Tetapkan CollaborationStartingState menggunakan metode MeetAddonClient.setCollaborationStartingState. Add-on dapat menetapkan CollaborationStartingState kapan saja sebelum atau selama kolaborasi.

URL yang ditentukan dalam metode MeetAddonClient.setCollaborationStartingState harus berasal dari origin yang sama dengan asal yang ditentukan dalam manifes add-on. Untuk informasi selengkapnya, lihat Keamanan add-on.

Panjang karakter CollaborationStartingState.sidePanelUrl, CollaborationStartingState.mainStageUrl, dan CollaborationStartingState.additionalData harus sesuai dengan batas ukurannya masing-masing seperti yang dipublikasikan dalam dokumen referensi SDK.

    mainStageClient.setCollaborationStartingState({
        sidePanelUrl: "https://app.example.com/sidepanel",
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
        // State to send to participants.
        })
    });

Dapatkan CollaborationStartingState, dengan metode MeetAddonClient.getCollaborationStartingState.

    const startingState = mainStageClient.getCollaborationStartingState();
    const additionalData = JSON.parse(startingState.additionalData);

Hapus CollaborationStartingState, dengan metode MeetAddonClient.clearCollaborationStartingState.

    mainStageClient.clearCollaborationStartingState();