Quảng bá tiện ích bổ sung với người dùng thông qua tính năng chia sẻ màn hình

Quảng bá một tiện ích bổ sung thông qua tính năng chia sẻ màn hình.

Trang này mô tả cách quảng bá tiện ích bổ sung cho người dùng trong khi chia sẻ màn hình một thẻ với Google Meet bằng cách đặt một đoạn mã nhỏ trên một trang web khác.

Phương thức MeetAddonScreenshare.exposeToMeetWhenScreensharing cho phép trang web gửi thông tin đến Meet khi thẻ của trang web đang được chia sẻ màn hình. Thông tin này được dùng trong trải nghiệm tiện ích bổ sung với Meet khi người dùng nhấp vào "Bắt đầu hoạt động" trên biểu ngữ bản trình bày nếu họ đã cài đặt tiện ích bổ sung. Nếu người dùng chưa cài đặt tiện ích bổ sung khi họ chia sẻ màn hình một thẻ, họ sẽ được nhắc cài đặt tiện ích bổ sung đó.

Đối tượng AddonScreenshareInfo chứa 5 trường có thể được thêm vào tuỳ theo trường hợp sử dụng:

Ví dụ: Tải trong giai đoạn chính

Trong mã mẫu sau, một người dùng chia sẻ màn hình trang web trong Meet có chứa mã sau sẽ được nhắc chạy tiện ích bổ sung:

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Thay thế các đoạn mã sau:

  • CLOUD_PROJECT_NUMBER: Chuỗi. Số dự án trên đám mây của bạn.
  • MAIN_STAGE_URL: Chuỗi. URL cho giai đoạn chính.

Khi người dùng chia sẻ trang trong màn hình cuộc gọi của Meet, họ sẽ thấy một biểu ngữ trình bày trong Meet. Khi nhấp vào nút trên biểu ngữ, tiện ích bổ sung sẽ mở ra cho số dự án trên đám mây nhất định trong giai đoạn chính. AddonScreenshareInfo.mainStageUrl sẽ được tải và AddonScreenshareInfo.additionalData được dùng để đặt trạng thái bắt đầu cộng tác của tiện ích bổ sung. Những người dùng khác trong lệnh gọi sẽ nhận được ngay lời nhắc cài đặt hoặc chạy tiện ích bổ sung.

Ví dụ: Tải trong bảng điều khiển bên

Trong mã mẫu sau đây, màn hình người dùng chia sẻ một trang với tiện ích bổ sung muốn bắt đầu trong bảng điều khiển bên thay vì giai đoạn chính:

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Thay thế các đoạn mã sau:

  • CLOUD_PROJECT_NUMBER: Chuỗi. Số dự án trên đám mây của bạn.
  • SIDE_PANEL_URL: Chuỗi. URL cho bảng điều khiển bên.

Khi người dùng chia sẻ trang trong màn hình cuộc gọi của Meet, họ sẽ thấy một biểu ngữ trình bày trong Meet. Khi nhấp vào nút trên biểu ngữ, tiện ích bổ sung cho số dự án trên đám mây nhất định sẽ mở ra trong bảng điều khiển bên. AddonScreenshareInfo.sidePanelUrl sẽ được tải và AddonScreenshareInfo.additionalData được dùng để đặt trạng thái bắt đầu cộng tác của tiện ích bổ sung. Những người dùng khác trong lệnh gọi sẽ nhận được ngay lời nhắc cài đặt hoặc chạy tiện ích bổ sung.

Ví dụ: Tải trong bảng điều khiển bên mà không bắt đầu hoạt động cộng tác

Trong mã mẫu sau đây, màn hình người dùng chia sẻ một trang với tiện ích bổ sung phải điều chỉnh quyền truy cập vào tài nguyên trước khi bắt đầu hoạt động cộng tác. Do yêu cầu này, tiện ích bổ sung phải được bắt đầu trong bảng điều khiển bên khi mọi người chưa bắt đầu cộng tác.

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

Thay thế các đoạn mã sau:

  • CLOUD_PROJECT_NUMBER: Chuỗi. Số dự án trên đám mây của bạn.
  • SIDE_PANEL_URL: Chuỗi. URL cho bảng điều khiển bên.

Khi người dùng chia sẻ trang trong màn hình cuộc gọi của Meet, họ sẽ thấy một biểu ngữ trình bày trong Meet. Khi nhấp vào nút trên biểu ngữ, tiện ích bổ sung cho số dự án trên đám mây nhất định sẽ mở ra trong bảng điều khiển bên. Vì AddonScreenshareInfo.startActivityOnOpen được đặt thành false, nút bắt đầu hoạt động sẽ bị tắt cho đến khi bạn đặt CollaborationStartingState. Để biết thêm thông tin, hãy xem phần Sử dụng trạng thái bắt đầu cộng tác.

Sau khi hoạt động bắt đầu, những người dùng khác trong lệnh gọi sẽ được nhắc chạy hoặc cài đặt tiện ích bổ sung.

So khớp nguồn gốc

Các nguồn gốc được cung cấp trong AddonScreenshareInfo.mainStageUrl và AddonScreenshareInfo.sidePanelUrl được so sánh với các nguồn gốc trong tệp kê khai tiện ích bổ sung của số dự án trên đám mây được cung cấp. Nếu mọi thứ đều khớp, người dùng sẽ được phép chạy tiện ích bổ sung.

Ngoài ra, bạn phải liệt kê nguồn gốc của trang web khởi tạo tính năng chia sẻ màn hình trong trường addOnOrigins trong tệp kê khai tiện ích bổ sung.

Để biết thêm thông tin, hãy xem phần Bảo mật tiện ích bổ sung.