Cộng tác bằng tiện ích bổ sung của Meet

Những người tham gia cuộc họp có thể cùng nhau cộng tác trong Hoạt động liên quan đến tiện ích bổ sung Google Meet. Khi một hoạt động cộng tác bắt đầu, tất cả người tham gia trong cuộc họp đều sẽ nhận được thông báo rằng hoạt động này liên tục.

Thông báo này được điều chỉnh cho phù hợp với tình trạng sẵn có và trạng thái cài đặt của tiện ích bổ sung:

  • Nếu người tham gia đã cài đặt tiện ích bổ sung: Họ có thể tham gia hoạt động này.

  • Nếu người tham gia không có tiện ích bổ sung đã cài đặt: Họ được chuyển hướng để cài đặt tiện ích bổ sung.

  • Nếu tiện ích bổ sung không dùng được trên nền tảng của người tham gia: Họ sẽ được thông báo rằng họ không thể tham gia hoạt động bằng thiết bị hiện tại.

Khi người dùng tham gia hoạt động, họ sẽ tải iframe của riêng mình bằng nội dung bổ sung của bạn. Bạn có thể tuỳ chỉnh liệu người mới tham gia hay không sẽ mở hoạt động cộng tác trong màn hình chính hoặc bảng điều khiển bên.

Bắt đầu hoạt động

Hoạt động được bắt đầu bằng cách gọi phương thức startActivity(). Phương thức này sử dụng giao diện ActivityStartingState.

Bước 1 (Không bắt buộc): Tiện ích bổ sung đặt trạng thái bắt đầu hoạt động

ActivityStartingState chứa thông tin về trạng thái ban đầu của tiện ích bổ sung được sử dụng khi người tham gia chấp nhận lời mời tham gia hoạt động.

Tiện ích bổ sung này có thể thiết lập hoặc cập nhật ActivityStartingState bằng cách gọi setActivityStartingState() bất cứ lúc nào trước hoặc trong khi hoạt động diễn ra. Cuộc gọi đến Có thể bỏ qua setActivityStartingState() nếu ActivityStartingState là được đặt riêng trong lệnh gọi đến startActivity().

Bước 2: Tiện ích bổ sung khởi động hoạt động

Hoạt động bắt đầu khi tiện ích bổ sung gọi phương thức startActivity() trên MeetSidePanelClient. Phương thức startActivity() lấy đối tượng ActivityStartingState làm tham số, vì vậy, bạn có thể gọi startActivity() thay vì gọi setActivityStartingState().

Sau khi người dùng hoàn tất lựa chọn nội dung và sẵn sàng bắt đầu một hoạt động, hãy gọi phương thức startActivity() trong tiện ích bổ sung như sau:

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

Khi phương thức startActivity() được gọi, Meet sẽ thực hiện các hành động sau:

  • Đối với những người tham gia khác: Meet sẽ hiển thị thông báo cho biết hoạt động đang diễn ra.

  • Đối với người khởi tạo: Nếu bạn chỉ định URL của sân khấu chính trong ActivityStartingState, thì Meet sẽ mở sân khấu chính bằng URL trong ActivityStartingState.

Bước 3: Lấy trạng thái bắt đầu hoạt động

Khi người dùng tham gia hoạt động, họ sẽ tải tiện ích bổ sung của bạn vào màn hình chính hoặc bảng điều khiển bên tuỳ thuộc vào ActivityStartingState.

Với thuộc tính additionalData, bạn có thể chia sẻ dữ liệu ban đầu (còn gọi là trạng thái) với những người dùng tham gia hoạt động. Sau khi khởi chạy một MainStageClient hoặc SidePanelClient, bạn có thể gọi getActivityStartingState() để truy xuất thuộc tính additionalData.

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

Bước 4 (Không bắt buộc): Chia sẻ trạng thái tiện ích bổ sung trong một hoạt động

Bạn cũng có thể chia sẻ trạng thái giữa những người dùng trong khi hoạt động đang diễn ra. Bạn có thể chia sẻ trạng thái theo hai cách:

  • Tự xử lý vấn đề này bằng cách tạo phần phụ trợ đồng bộ hoá của riêng bạn.
  • Hãy dùng Co-Doing API, là cách thuận tiện và nhanh chóng để chia sẻ dữ liệu tuỳ ý giữa người dùng.

Ví dụ: Tiện ích bổ sung ảnh động trên GitHub

"Ảnh động" tiện ích bổ sung mẫu trên GitHub bao gồm cả hoạt động cộng tác trong tiện ích bổ sung. Bước 1 từ hướng dẫn này không được bao gồm trong mẫu. Thay vào đó, khi trình khởi chạy tiện ích bổ sung nhấp vào nút "Bắt đầu ảnh động" trong bảng điều khiển bên, phương thức startActivity() sẽ được gọi (Bước 2) bằng cách điền trạng thái bắt đầu bằng màu mà người dùng đã chọn. Sau hoạt động bắt đầu, giai đoạn chính truy xuất trạng thái bắt đầu bằng cách gọi phương thức getActivityStartingState() (Bước 3). Bước 4 bị bỏ qua, dưới dạng trạng thái (phần tử màu đã chọn) không được chia sẻ giữa những người tham gia trong hoạt động trong tiện ích bổ sung mẫu. Tuy nhiên, người dùng cá nhân có thể thay đổi trạng thái của riêng mình bằng cách chọn một màu được gửi từ khung bảng điều khiển bên sang khung sân khấu chính bằng cách sử dụng thông báo khung đến khung.

Giới hạn