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

Trang này mô tả cách quản lý các đố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",
    });

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:

Điều quan trọng là bạn phải truy xuất đúng đối tượng ứng dụng cho sân khấu chính hoặc bảng điều khiển bên. Nếu truy xuất sai ứng dụng, SDK Tiện ích bổ sung của Google Meet sẽ gửi một 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 thấy cách tạo bản sao đối tượng ứng dụng cho sân khấu 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 dùng chung

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ó 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.
  • Phương thức getMeetingInfo() lấy thông tin chi tiết về cuộc họp mà 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.

Các tính năng dành riêng cho ứng dụng

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

  • Phương thức notifySidePanel() sẽ gửi thông báo đến bảng điều khiển bên. Bạn có thể nhận được thông báo bằng cách đăng ký lệnh gọi lại frameToFrameMessage trong bảng điều khiển bên.

  • Phương thức loadSidePanel() sẽ mở iframe của bảng điều khiển bên. Nguồn iframe được đặt thành URL của bảng điều khiển bên trong 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: