Sử dụng trạng thái bắt đầu của hoạt động cộng tác

Trang này mô tả mục đích của CollaborationStartingState cũng như cách thiết lập và truy xuất tiện ích đó từ SDK tiện ích bổ sung cho Google Meet.

Tổng quan về trạng thái bắt đầu cộng tác

Khi mở tiện ích bổ sung lần đầu tiên, iframe side-panel tải URL được chỉ định trong tiện ích bổ sung tệp kê khai. Tên viết tắt này có thể khác với trạng thái ban đầu mà tiện ích bổ sung muốn sử dụng khi người dùng tham gia bằng lời mời cộng tác. Chiến lược phát hành đĩa đơn CollaborationStartingState có thể được sử dụng để chỉ định URL iframe sẽ được tải khi người dùng tham gia thông qua lời mời cộng tác. Ngoài ra, trường additional_data có thể là mà tiện ích bổ sung sử dụng để lưu trữ bất kỳ dữ liệu nào mà nó có thể cần để khởi tạo.

Đặt, tải và xoá trạng thái bắt đầu của phiên cộng tác

Bạn có thể quản lý CollaborationStartingState bằng các phương thức sau.

Đặt CollaborationStartingState bằng cách sử dụng MeetAddonClient.setCollaborationStartingState . Tiện ích bổ sung có thể đặt CollaborationStartingState bất cứ lúc nào trước hoặc trong quá trình cộng tác.

URL được chỉ định trong phương thức MeetAddonClient.setCollaborationStartingState phải thuộc cùng nguồn gốc với nguồn gốc được chỉ định trong tệp kê khai tiện ích bổ sung. Để biết thêm thông tin, hãy xem Tiện ích bổ sung bảo mật.

Chiến lược phát hành đĩa đơn CollaborationStartingState.sidePanelUrl! CollaborationStartingState.mainStageUrl, và CollaborationStartingState.additionalData độ dài ký tự phải tuân theo giới hạn kích thước tương ứng như được công bố trong các tài liệu tham khảo về SDK.

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

Tải CollaborationStartingState qua MeetAddonClient.getCollaborationStartingState .

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

Xoá CollaborationStartingState, bằng MeetAddonClient.clearCollaborationStartingState .

    mainStageClient.clearCollaborationStartingState();