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 Google Meet.
Tổng quan về trạng thái bắt đầu cộng tác
Khi một tiện ích bổ sung được mở lần đầu tiên, iframe bảng điều khiển bên sẽ tải URL được chỉ định trong tệp kê khai tiện ích bổ sung. Trạng thái ban đầu này có thể khác với trạng thái bắt đầ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. Bạn có thể sử dụng CollaborationStartingState để chỉ định URL iframe sẽ được tải khi người dùng tham gia bằng lời mời cộng tác. Ngoài ra, tiện ích bổ sung này có thể tận dụng trường additional_data để lưu trữ mọi dữ liệu cần thiết cho quá trình khởi chạy.
Đặ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 phương thức MeetAddonClient.setCollaborationStartingState. Tiện ích bổ sung có thể đặt CollaborationStartingState bất kỳ lúc nào trước hoặc trong khi cộng tác.
Các URL được chỉ định trong phương thức MeetAddonClient.setCollaborationStartingState
phải thuộc cùng nguồn gốc với
các 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 phần Bảo mật tiện ích bổ sung.
Độ dài ký tự CollaborationStartingState.sidePanelUrl, CollaborationStartingState.mainStageUrl và CollaborationStartingState.additionalData phải tuân thủ giới hạn kích thước tương ứng như được công bố trong 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.
})
});
Lấy CollaborationStartingState bằng phương thức MeetAddonClient.getCollaborationStartingState.
const startingState = mainStageClient.getCollaborationStartingState();
const additionalData = JSON.parse(startingState.additionalData);
Xoá CollaborationStartingState bằng phương thức MeetAddonClient.clearCollaborationStartingState.
mainStageClient.clearCollaborationStartingState();