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à một 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 trên Google Cloud.

Từ phiên này, bạn có thể tạo 2 đối tượng khách hàng:

Điều quan trọng là bạn phải 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 sai ứng dụng, SDK bổ trợ Google Meet sẽ gửi một ngoại lệ. Để kiểm tra xem tiện ích bổ sung đang chạy trong iframe nào (giai đoạn chính hoặc bảng điều khiển bên), hãy sử dụng phương thức getFrameType().

Mã mẫu sau đây cho thấy cách tạo thực thể cho đối tượng ứng dụng khách giai đoạn chính:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
    });
  const mainStageClient = await session.createMainStageClient();

Thay CLOUD_PROJECT_NUMBER bằng số dự án của dự án trên 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 dành riêng cho một ứng dụng khách nhất định.

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

  • Phương thức getActivityStartingState() nhận 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 khách hàng

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

  • Phương thức notifySidePanel() sẽ gửi một thông báo đến bảng điều khiển bên. Bạn có thể nhận 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() sẽ đóng iframe của 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 này được gọi. Tiện ích bổ sung có trách nhiệm duy trì mọi trạng thái của tiện ích bổ sung 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: