Trang này mô tả mục đích của CollaborationStartingState
cũng như cách đặt và truy xuất tiện ích bổ sung này từ SDK tiện ích bổ sung cho Google Meet.
Tổng quan về trạng thái bắt đầu hoạt động cộng tác
Khi một tiện ích bổ sung được mở lần đầu, iframe bảng điều khiển bên sẽ tải URL được chỉ định trong tệp kê khai của tiện ích bổ sung. Trạng thái ban đầu 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. 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 có thể sử 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, nhận và xoá trạng thái bắt đầu hoạt động 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 phương thức MeetAddonClient.setCollaborationStartingState.
Các URL được chỉ định trong phương thức MeetAddonClient.setCollaborationStartingState phải có cùng nguồn gốc với các URL gốc được chỉ định trong tệp kê khai của tiện ích bổ sung. Để biết thêm thông tin, hãy xem bài viết Tiện ích bổ sung bảo mật.
Độ dài sidePanelUrl, mainStageUrl và additionalData phải tuân theo giới hạn kích thước tương ứng như được phát hành 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();