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 tác trên một hoạt động trong Tiện ích bổ sung của Google Meet. Khi một hoạt động cộng tác bắt đầu, tất cả người tham gia cuộc họp sẽ nhận được thông báo cho biết hoạt động đó đang diễn ra.

Thông báo này được điều chỉnh để 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ếu người tham gia chưa cài đặt tiện ích bổ sung: Họ sẽ được hướng dẫn cài đặt tiện ích bổ sung.

  • Nếu tiện ích bổ sung này không dùng được cho nền tảng của người tham gia: Họ sẽ nhận được thông báo rằng họ không thể tham gia hoạt động này 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 việc người mới tham gia có mở hoạt động cộng tác trong màn hình chính hay 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 có thể đặt hoặc cập nhật ActivityStartingState bằng cách gọi phương thức setActivityStartingState() bất cứ lúc nào trước hoặc trong hoạt động. Bạn có thể bỏ qua các lệnh gọi đến setActivityStartingState() nếu ActivityStartingState được đặt riêng trong lệnh gọi đến startActivity().

Bước 2: Tiện ích bổ sung bắt đầu 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 việc 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 thao tác 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 giai đoạn 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 MainStageClient hoặc SidePanelClient, bạn có thể gọi phương thức 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 các 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:

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

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

Tiện ích bổ sung mẫu"Ảnh động" trên GitHub bao gồm tính năng cộng tác trong một tiện ích bổ sung. Bước 1 trong hướng dẫn này không có 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 khi hoạt động bắt đầu, giai đoạn chính sẽ 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 vì trạng thái (màu được 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 này. Tuy nhiên, từng người dùng 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 đến khung giai đoạn chính thông qua tính năng thông báo giữa các khung hình.

Giới hạn