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á tiện ích bổ sung trên màn hình chia sẻ.

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ã ngắn trên một trang web khác.

Chiến lược phát hành đĩa đơn exposeToMeetWhenScreensharing() cho phép trang web đó gửi thông tin đến Meet khi thẻ đượ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 có đã cài đặt tiện ích bổ sung. Nếu người dùng không có khi họ chia sẻ màn hình một thẻ, họ sẽ có thể đã được nhắc cài đặt tiện ích bổ sung.

Chiến lược phát hành đĩa đơn AddonScreenshareInfo đối tượng chứa năm thuộc tính có thể được thêm vào dựa trên trường hợp sử dụng:

  • additionalData: Thông tin mà tiện ích bổ sung có thể sử dụng để tự khởi chạy. Lon chỉ được đặt nếu thuộc tính startActivityOnOpen là true và có thể là đã truy cập bằng ActivityStartingState. Để biết thêm thông tin, hãy xem phần Sử dụng hoạt động bắt đầu trạng thái.

  • cloudProjectNumber: Bắt buộc. Số dự án của dự án trên Google Cloud.

  • mainStageUrl: URL mà giai đoạn chính sẽ mở sau khi tiện ích bổ sung chẳng hạn như https://www.example.com. Các URL phải thuộc về cùng một origin làm URL được chỉ định trong tệp kê khai tiện ích bổ sung.

  • sidePanelUrl: URL mà bảng điều khiển bên sẽ mở ra sau khi tiện ích bổ sung chẳng hạn như https://www.example.com. Các URL phải thuộc về cùng một origin làm URL được chỉ định trong tệp kê khai tiện ích bổ sung.

  • startActivityOnOpen: Bắt buộc. Liệu có bắt đầu tiện ích bổ sung hoạt động hay không trong Meet ngay khi người dùng bắt đầu tiện ích bổ sung từ biểu ngữ bản trình bày. Phải là đúng nếu sử dụng thuộc tính mainStageUrl.

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 một trang web bằng Meet chứa mã sau đây sẽ được nhắc khởi chạy tiện ích bổ sung:

<script src="https://www.gstatic.com/meetjs/addons/1.0.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ế đoạn mã sau:

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

Khi người dùng trong màn hình cuộc gọi trên Meet chia sẻ trang, họ sẽ thấy một biểu ngữ bản trình bày trong Meet. Nhấp vào nút trên biểu ngữ mở tiện ích bổ sung cho số dự án trên đám mây đã cho trong giai đoạn chính. Thuộc tính mainStageUrl đã được tải và Thuộc tính additionalData được dùng để đặt hoạt động bắt đầu trạng thái của tiện ích bổ sung. Những người dùng khác trong cuộc gọi sẽ được nhắc ngay để 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, 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ì so với giai đoạn chính:

<script src="https://www.gstatic.com/meetjs/addons/1.0.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ế đoạn mã sau:

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

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

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

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

Thay thế đoạn mã sau:

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

Khi người dùng trong màn hình cuộc gọi Meet chia sẻ trang, 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 đã cho sẽ mở ra trong bảng điều khiển bên. Vì startActivityOnOpen được đặt thành false, nút start activity (Bắt đầu hoạt động) bị tắt cho đến khi Đã đặt ActivityStartingState. Để biết thêm thông tin, hãy xem phần Sử dụng trạng thái bắt đầu hoạt động.

Sau khi hoạt động bắt đầu, người dùng khác trong cuộc 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

Nguồn gốc được cung cấp trong mainStageUrl và sidePanelUrl được so sánh với các nguồn gốc trong tiện ích bổ sung của số dự án trên đám mây được cung cấp. Nếu mọi thông tin đề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 bắt đầu chia sẻ màn hình trong trường addOnOrigins trong tiện ích bổ sung tệp kê khai.

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