Triển khai API cùng xem

API Cùng xem quản lý trải nghiệm họp của nhiều người tham gia khi xem hoặc nghe nội dung trong ứng dụng của bạn.

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

Bắt đầu

Để sử dụng API Cùng xem, trước tiên, bạn phải Triển khai tiện ích bổ sung Meet. Sau khi hoàn tất các bước đó, bạn có thể bắt đầu sử dụng API Cùng xem trong tiện ích bổ sung mới.

Để sử dụng API Cùng xem, 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:

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

Tạo ứng dụng cùng xem

Để bắt đầu, hãy tạo một đối tượng CoWatchingClient từ AddonSession.

Để tạo CoWatchingCient, hãy gọi phương thức createCoWatchingClient() và cung cấp đối tượng CoWatchingDelegate.

CoWatchingDelegate là cách API cùng xem sẽ 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 onCoWatchingStateChanged() đượ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-Watching (Xem cùng):

 const coWatchingClient = await addonSession.createCoWatchingClient({
    activityTitle: "ACTIVITY_TITLE",
    onCoWatchingStateQuery() {
      // This function should return the current state of your CoWatching activity
      return getMyApplicationCoWatchingState();
    },
    onCoWatchingStateChanged(coWatchingState: CoWatchingState) {
      // This function should apply newState to your ongoing CoWatching activity
    },
  });

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

Khi người dùng thực hiện thao tác trong ứng dụng, ứng dụng sẽ gọi ngay các phương thức API đã cung cấp.

Bạn chỉ nên gọi các phương thức này để phản hồi các sự kiện quan trọng. Ví dụ: bạn không cần gọi các phương thức này mỗi khi ứng dụng của bạn chuyển tiếp một video đang phát. CoWatchingDelegate mà bạn tạo sẽ xử lý việc cập nhật vị trí phát trong những trường hợp này.

Bạn có thể kiểm soát trạng thái cùng xem bằng các phương thức sau:

• notifyBuffering(): Gọi khi ứng dụng của người dùng bắt đầu lưu vào bộ đệm do lưu vào bộ đệm từ một nút chuyển nội dung nghe nhìn, tìm nội dung nghe nhìn hoặc tắc nghẽn mạng trước đó.

• notifyPauseState(): Gọi khi người dùng tạm dừng hoặc huỷ tạm dừng nội dung nghe nhìn đang phát.

• notifyPlayoutRate(): Gọi khi người dùng cập nhật tốc độ phát thành một giá trị mới (ví dụ: 1,25 lần).

• notifyReady(): Cuộc gọi khi bộ đệm hoàn tất và nội dung nghe nhìn hiện đã sẵn sàng để phát.

• notifySeekToTimestamp(): Gọi khi người dùng thay đổi rõ ràng vị trí phát.

• notifySwitchToMedia(): Gọi bất cứ khi nào nội dung nghe nhìn đang phát thay đổi. Ví dụ: người dùng chọn một video mới hoặc tính năng tự động phát sẽ khởi động video tiếp theo.