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
MeetAddonScreenshare.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 trường có thể được thêm vào dựa trên trường hợp sử dụng:
AddonScreenshareInfo.additionalData
: Thông tin mà tiện ích bổ sung có thể sử dụng để tự khởi chạy. Lon chỉ được thiết lập nếuAddonScreenshareInfo.startActivityOnOpen
là true và có thể là đã truy cập bằngCollaborationStartingState
. Để biết thêm thông tin, hãy xem bài viết Sử dụng dự án cộng tác bắt đầu trạng thái.AddonScreenshareInfo.cloudProjectNumber
: Bắt buộc. Số dự án trên Google Cloud của tiện ích bổ sung.AddonScreenshareInfo.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.AddonScreenshareInfo.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.AddonScreenshareInfo.startActivityOnOpen
: Bắt buộc. Có bắt đầu sử dụng tiện ích bổ sung cộng tác 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 đúng nếu bạn dùngAddonScreenshareInfo.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/0.9.1/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 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 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. AddonScreenshareInfo.mainStageUrl
đã được tải và
AddonScreenshareInfo.additionalData
được dùng để bắt đầu phiên cộng tác
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
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/0.9.1/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 trên đám mây của bạn.
- 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. AddonScreenshareInfo.sidePanelUrl
đã được tải và
AddonScreenshareInfo.additionalData
được dùng để bắt đầu phiên cộng tác
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 phiên cộng tác
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 có thể bắt đầu hoạt động cộng tác. Do yêu cầu này, phải bắt đầu trong bảng điều khiển bên mà không có dành cho tất cả mọi người.
<script src="https://www.gstatic.com/meetjs/addons/0.9.1/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 trên đám mây của bạn.
- 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. Từ
AddonScreenshareInfo.startActivityOnOpen
được đặt thành false, nút bắt đầu hoạt động bị tắt cho đến khi
Đã đặt CollaborationStartingState
. Để biết thêm thông tin, hãy xem bài viết Sử dụng
bắt đầu cộng tác
trạng thái.
Sau khi hoạt động này bắt đầu, những người dùng khác trong cuộc gọi sẽ được nhắc chọn 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
AddonScreenshareInfo.mainStageUrl
và
AddonScreenshareInfo.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
đượ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.