Quảng bá tiện ích bổ sung cho người dùng

Nhà phát triển có thể tăng khả năng xuất hiện của các tiện ích bổ sung bằng cách quảng bá chúng thông qua tính năng trò chuyện trong cuộc gọi của Meet và tính năng chia sẻ màn hình của Meet.

Trò chuyện trong cuộc gọi

Các tiện ích bổ sung của Google Meet sẽ được quảng bá đến người dùng trong tính năng trò chuyện trong cuộc gọi của Meet một cách tự động khi một tin nhắn có(các) đường liên kết được liên kết với một tiện ích bổ sung. Nhà phát triển không cần làm gì để quảng bá tiện ích bổ sung trong cuộc trò chuyện. Nhóm đánh giá sẽ xác định(các) đường liên kết cần liên kết với một tiện ích bổ sung, dựa trên URI của bảng điều khiển bên và các nguồn của tiện ích bổ sung được đặt trong tệp kê khai triển khai.

Khi người dùng gửi tin nhắn thông qua một cuộc trò chuyện trong cuộc gọi được liên kết với một tiện ích bổ sung, một trong hai điều sau sẽ xảy ra:

1. Nếu tiện ích bổ sung chưa được cài đặt, một thẻ sẽ nhắc người dùng cài đặt tiện ích bổ sung.
2. Nếu tiện ích bổ sung đã được cài đặt, một nút sẽ nhắc người dùng mở tiện ích bổ sung đó.

Chia sẻ màn hình

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ẻ bằng 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 exposeToMeetWhenScreensharing() cho phép trang web gửi thông tin đến Meet khi thẻ của trang web được chia sẻ màn hình. Thông tin này được dùng trong trải nghiệm 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ữ trình bày nếu họ đã cài đặt tiện ích bổ sung. Nếu chưa cài đặt tiện ích bổ sung khi chia sẻ màn hình một thẻ, người dùng sẽ được nhắc cài đặt tiện ích bổ sung.

Đối tượng AddonScreenshareInfo chứa 5 thuộc tính mà bạn có thể thêm dựa trên trường hợp sử dụng:

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

• 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ở khi tiện ích bổ sung bắt đầu, chẳng hạn như https://www.example.com. URL phải thuộc cùng một nguồn gốc với các 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ở khi tiện ích bổ sung bắt đầu, chẳng hạn như https://www.example.com. URL phải thuộc cùng một nguồn gốc với các URL được chỉ định trong tệp kê khai tiện ích bổ sung.

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

Cài đặt và nhập SDK

Bạn có thể truy cập vào SDK bằng npm hoặc gstatic.

npm install @googleworkspace/meet-addons

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

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

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

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

Thay thế nội dung sau:

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

Khi chia sẻ trang, người dùng trong màn hình cuộc gọi Meet sẽ thấy một biểu ngữ trình bày trong Meet. Khi bạn 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 đã cho trong bảng điều khiển bên. Vì thuộc tính startActivityOnOpen được đặt thành false, nên nút bắt đầu hoạt động sẽ bị vô hiệu hoá cho đến khi ActivityStartingState được đặt. Để 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, những người dùng khác trong cuộc gọi sẽ được nhắc khởi chạy hoặc cài đặt tiện ích bổ sung.

Tiện ích bổ sung "Ảnh động" mẫu trên GitHub có ví dụ này trong một tiện ích bổ sung đầy đủ. Khi trang chỉ mục của ứng dụng web được liên kết với tiện ích bổ sung xuất hiện, người dùng đang trình bày sẽ được nhắc cài đặt hoặc thiết lập tiện ích bổ sung.

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

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

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Thay thế nội dung sau:

• CLOUD_PROJECT_NUMBER: Chuỗi. Số dự án của dự án trên Google Cloud.
• MAIN_STAGE_URL: Chuỗi. URL của sân khấu chính.

Khi chia sẻ trang, người dùng trong màn hình cuộc gọi Meet sẽ thấy một biểu ngữ trình bày trong Meet. Khi bạn 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 đã cho trong màn hình chính. Thuộc tính mainStageUrl được tải và thuộc tính additionalData được dùng để đặt trạng thái bắt đầu hoạt động của tiện ích bổ sung. Những người dùng khác trong cuộc gọi sẽ ngay lập tức nhận được 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 đoạn mã mẫu sau, một người dùng chia sẻ màn hình 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>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Thay thế nội dung sau:

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

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

So khớp nguồn gốc

Nguồn gốc được cung cấp trong thuộc tính mainStageUrl và thuộc tính sidePanelUrl được so sánh với 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 bắt đầu chia sẻ màn hình phải được liệt kê trong trường addOnOrigins trong manifest của 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.

Chủ đề có liên quan

• Cộng tác bằng tiện ích bổ sung Meet
• Bảo mật bổ sung