Quản lý đối tượng ứng dụng

Trang này mô tả cách quản lý đối tượng ứng dụng khách 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",
    });

Thay thế CLOUD_PROJECT_NUMBER bằng số dự án của dự án Google Cloud.

Từ phiên này, bạn có thể tạo hai đối tượng ứng dụng:

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 (bảng điều khiển chính hoặc bảng điều khiển bên) mà tiện ích bổ sung đang chạy, hãy sử dụng phương thức 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();

Thay thế CLOUD_PROJECT_NUMBER bằng số dự án của dự án trên Google Cloud.

Các tính năng được chia sẻ

Một số tính năng có trong cả đối tượng MeetMainStageClient và MeetSidePanelClient, trong khi các tính năng khác chỉ dành riêng cho một ứng dụng nhất định.

Ví dụ: một số tính năng có sẵn trong cả hai ứng dụng bao gồm:

  • Phương thức getActivityStartingState() lấy thông tin về 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 tham gia hoạt động.
  • getMeetingInfo() để lấy thông tin chi tiết về cuộc họp trong đó tiện ích bổ sung đang chạy.
  • Phương thức setActivityStartingState() đặ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 tham gia hoạt động.
  • Để biết danh sách đầy đủ các tính năng trong cả hai ứng dụng, hãy xem đối tượng MeetAddonClient.

Tính năng dành riêng cho khách hàng

Các tính năng chỉ có trong MeetMainStageClient đối tượng:

  • notifySidePanel() sẽ gửi một 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 lệnh gọi lại trong bảng điều khiển bên.

  • 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.

  • Phương thức unloadSidePanel() đóng iframe bảng điều khiển bên. Trạng thái tiện ích bổ sung không được giữ lại trong Meet khi phương thức được gọi. Tùy thuộc vào tiện ích bổ sung để duy trì bất kỳ trạng thái tiện ích bổ sung nào trước khi phương thức này được gọi.

Các tính năng chỉ có trong đối tượng MeetSidePanelClient: