Triển khai API Co-Doing

Co-Doing API dùng để đồng bộ hoá dữ liệu tuỳ ý giữa các cuộc họp người tham gia. Đây có thể là bất kỳ dữ liệu nào mà ứng dụng của bạn phụ thuộc vào.

Bạn phải chuyển đổi tuần tự dữ liệu thành Uint8Array để truyền dữ liệu. Để biết thêm hãy xem thư viện JavaScript chuẩn, tham khảo.

Nếu bạn không chắc chắn về cách chuyển đổi tuần tự dữ liệu của mình, hãy xem các mã mẫu đang theo dõi.

Hướng dẫn này giải thích cách triển khai API Co-Doing.

Bắt đầu

Để sử dụng API Co-Doing, trước tiên, bạn phải Tạo tiện ích bổ sung cho Meet. Sau khi hoàn tất các bước đó, bạn có thể bắt đầu sử dụng API Co-Doing trong tiện ích bổ sung mới.

Để sử dụng API Co-Doing, hãy bắt đầu bằng cách lấy đối tượng AddonSession. Đối tượng này đóng vai trò là điểm truy cập cho các hoạt động cùng làm trên Google Meet:

TypeScript

const session = await window.meet.addon.createAddonSession({
    cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});

Thay thế CLOUD_PROJECT_NUMBER bằng số dự án của dự án Google Cloud.

Tạo một ứng dụng cùng thực hiện

Để bắt đầu, hãy tạo một CoDoingClient khỏi AddonSession.

Để tạo CoDoingClient, hãy gọi phương thức createCoDoingClient() và cung cấp một CoDoingDelegate .

CoDoingDelegate là cách API cùng hành động cập nhật ứng dụng của bạn bất cứ khi nào ứng dụng có trạng thái mới. Dự kiến là khi phương thức onCoDoingStateChanged() được gọi, ứng dụng của bạn sẽ áp dụng trạng thái mới ngay lập tức.

Mã mẫu sau đây cho biết cách sử dụng API Co-Doing:

TypeScript

interface MyState {
  someString: string;
  someNumber: number;
}

/**
 * Serialize/deserialize using JSON.stringify
 * You can use any method you want; this is included for as an example
 */
function toBytes(state: MyState): Uint8Array {
  return new TextEncoder().encode(JSON.stringify(state));
}

function fromBytes(bytes: Uint8Array): MyState {
  return JSON.parse(new TextDecoder().decode(bytes)) as MyState;
}

  const coDoingClient = await addonSession.createCoDoingClient({
    activityTitle: "ACTIVITY_TITLE",
    onCoDoingStateChanged(coDoingState: CoDoingState) {
      const newState = fromBytes(coDoingState.bytes);
      // This function should apply the new state to your ongoing CoDoing activity
    },
  });

Thay thế ACTIVITY_TITLE bằng tiêu đề của hoạt động.

Quản lý trạng thái hiện tại

Thông thường, khi người dùng thực hiện hành động trong ứng dụng, ứng dụng của bạn sẽ ngay lập tức gọi phương thức broadcastStateUpdate() .

Mẫu mã sau đây cho thấy cách triển khai phương thức broadcastStateUpdate():

TypeScript

const myState: MyState = {
  someString: "SOME_STRING",
  someNumber: 0
};

document.getElementById('some-button').onClick(() => {
  myState.someNumber = myState.someNumber + 1;
  coDoingClient.broadcastStateUpdate({ bytes: toBytes(myState) });
});

Thay thế SOME_STRING bằng trạng thái hiện tại của ứng dụng.