Trang này mô tả cách quảng bá một 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 chia sẻ màn hình. Thông tin này được dùng trong tiện ích bổ sung của Meet khi người dùng nhấp vào "Bắt đầu hoạt động" trên biểu ngữ của 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 chia sẻ màn hình một thẻ, 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:
AddonScreenshareInfo.additionalData
: Thông tin mà tiện ích bổ sung có thể sử dụng để tự khởi chạy. Bạn chỉ có thể thiết lập nếuAddonScreenshareInfo.startActivityOnOpen
là true và có thể truy cập được bằngCollaborationStartingState
. Để 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.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ở ra khi tiện ích bổ sung bắt đầu, chẳng hạn nhưhttps://www.example.com
. URL phải có cùng nguồn gốc với các 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 khi tiện ích bổ sung khởi động, chẳng hạn nhưhttps://www.example.com
. URL phải có cùng nguồn gốc với các URL được chỉ định trong tệp kê khai tiện ích bổ sung.AddonScreenshareInfo.startActivityOnOpen
: Bắt buộc. Liệu có bắt đầu trải nghiệm tiện ích bổ sung cộng tác trong Meet ngay khi người dùng khởi động tiện ích bổ sung từ biểu ngữ của bản trình bày hay không. Giá trị này phải là true nếu bạn sử dụngAddonScreenshareInfo.mainStageUrl
.
Ví dụ: Tải trong giai đoạn chính
Trong mã mẫu sau đây, một người dùng chia sẻ màn hình một trang web trong Meet chứa mã sau đây 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ế đ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ữ 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 giai đoạn chính. AddonScreenshareInfo.mainStageUrl
được tải và AddonScreenshareInfo.additionalData
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 cuộc gọi sẽ được nhắc cài đặt hoặc chạy tiện ích bổ sung ngay lập tức.
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 một 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ế đ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ữ 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 cụ thể sẽ mở ra trong bảng điều khiển bên. AddonScreenshareInfo.sidePanelUrl
được tải và AddonScreenshareInfo.additionalData
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 cuộc gọi sẽ được nhắc cài đặt hoặc chạy tiện ích bổ sung ngay lập tức.
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 đây, màn hình người dùng chia sẻ một trang với một tiện ích bổ sung cần phải điều chỉnh các quyền đối với 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 nên được bắt đầu trong bảng điều khiển bên mà không bắt đầu quy trình cộng tác cho tất cả mọi người.
<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ế đ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ữ 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 cụ thể sẽ mở ra trong bảng điều khiển bên. Vì AddonScreenshareInfo.startActivityOnOpen
được đặt thành false, nên 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 này bắt đầu, những 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 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, nguồn gốc của trang web khởi tạo lượt chia sẻ màn hình phải được liệt kê trong trường addOnOrigins
trong tệp kê khai tiện ích bổ sung.
Để biết thêm thông tin, hãy xem bài viết Bảo mật tiện ích bổ sung.