Trang này mô tả cách lấy đối tượng ứng dụng mà tiện ích bổ sung cần giao tiếp với Google Meet.
Trước tiên, tiện ích bổ sung cần thiết lập một phiên:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
Trong phiên này, bạn có thể tạo 2 đối tượng ứng dụng:
MeetMainStageClient
cho một tiện ích bổ sung chạy trong main giai đoạn, có thể truy xuất được bằngawait session.createMainStageClient()
.MeetSidePanelClient
cho một tiện ích bổ sung chạy ở bên cạnh bảng điều khiển, có thể truy xuất được bằngawait session.createSidePanelClient()
.
Bạn cần truy xuất đúng đối tượng ứng dụng cho giai đoạn chính
hoặc bảng điều khiển bên. Nếu truy xuất nhầm ứng dụng, thì SDK tiện ích bổ sung Google Meet sẽ gửi đi
ngoại lệ. Để kiểm tra iframe nào (giai đoạn chính hoặc bảng điều khiển bên),
tiện ích bổ sung nào đang chạy, hãy sử dụng
MeetAddon.getFrameType
.
Mã mẫu sau đây cho biết cách tạo thực thể cho đối tượng ứng dụng ở giai đoạn chính:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
const mainStageClient = await session.createMainStageClient();
Chức năng dùng chung
Một số chức năng có trong cả MeetMainStageClient
và
MeetSidePanelClient
, trong khi chức năng khác dành riêng cho một số
khách hàng.
Ví dụ: một số chức năng có sẵn trong cả hai ứng dụng bao gồm:
MeetAddonClient.getCollaborationStartingState
để lấy thông tin về trạng thái ban đầu của khi người tham gia chấp nhận lời mời để cộng tác.MeetAddonClient.getMeetingInfo
để lấy thông tin chi tiết về cuộc họp trong đó tiện ích bổ sung đang chạy.MeetAddonClient.getMeetPlatformInfo
để lấy thông tin chi tiết về nền tảng cuộc họp mà tiện ích bổ sung đang chạy.MeetAddonClient.setCollaborationStartingState
đặt trạng thái ban đầu của tiện ích bổ sung khi người tham gia chấp nhận lời mời để cộng tác.- Để biết danh sách đầy đủ các chức năng trong cả hai ứng dụng, hãy xem
MeetAddonClient
.
Chức năng dành riêng cho khách hàng
Chức năng chỉ có trong
MeetMainStageClient
:
MeetMainStageClient.notifySidePanel
sẽ gửi thông báo đến bảng điều khiển bên. Có thể nhận tin nhắn bằng đăng ký frameToFrameMessage callback trong bảng điều khiển bên.MeetMainStageClient.loadSidePanel
sẽ mở iframe bảng điều khiển bên. Nguồn iframe được đặt thành URL bảng điều khiển bên từ tệp kê khai.MeetMainStageClient.unloadSidePanel
sẽ đóng iframe bảng điều khiển bên. Tiện ích bổ sung trạng thái không được giữ lại trong Meet khi phương thức này được gọi. Tiện ích bổ sung có thể duy trì bất kỳ trạng thái bổ sung trước khi phương thức này được gọi.
Chức năng chỉ có trong
MeetSidePanelClient
:
MeetSidePanelClient.notifyMainStage
sẽ gửi thông báo đến main dựng. Người dùng có thể nhận tin nhắn bằng cách đăng ký vào frameToFrameMessage lệnh gọi lại trong giai đoạn chính.