CoWatchingClient

Kotlin |Java

@PublicApi
public interface CoWatchingClient

---

---

Chương trình tiếp cận sớm: Tính năng này chỉ được cung cấp dưới dạng bản xem trước có giới hạn thông qua một Chương trình tiếp cận sớm.

Đại diện cho một phiên cùng xem.

Thông báo cho Meet về các hành động gần đây của người dùng (ví dụ: phát/tạm dừng/tìm kiếm) và các yếu tố môi trường như độ trễ do nội dung nghe nhìn tải vào bộ đệm.

Tóm tắt

Hằng số
default static final double	MAX_PLAYOUT_RATE = 2.0 Tốc độ phát lại tối đa được phép.
default static final double	MAX_SEEKS_PER_SECOND = 0.9 Số lần tua tối đa được phép mỗi giây.

Phương thức công khai
abstract void	notifyBuffering(Duration mediaPlayoutPosition) Thông báo cho Meet rằng nội dung nghe nhìn chưa sẵn sàng để phát do tải vào bộ đệm, do có nút chuyển nội dung nghe nhìn trước đó, tìm kiếm nội dung nghe nhìn hoặc tình trạng nghẽn mạng bình thường.
abstract void	notifyEnded(Duration mediaPlayoutPosition) Thông báo cho Meet rằng trình phát nội dung đa phương tiện đã kết thúc nội dung nghe nhìn hiện tại.
abstract void	notifyPauseState(boolean paused, Duration mediaPlayoutPosition) Thông báo cho Meet rằng người dùng đã tạm dừng hoặc tiếp tục phát nội dung nghe nhìn để Meet có thể phản chiếu hành động đó cho người dùng khác.
abstract void	notifyPlayoutRate(double rate, Duration mediaPlayoutPosition) Thông báo cho Meet rằng người dùng đã cập nhật tốc độ phát của nội dung nghe nhìn (ví dụ:
abstract void	notifyQueueUpdate(CoWatchingQueue queue) Thông báo cho Meet rằng danh sách chờ đã thay đổi để Meet có thể phản chiếu nội dung đó cho người dùng khác.
abstract void	notifyReady(Duration mediaPlayoutPosition) Thông báo cho Meet rằng quá trình lưu vào bộ đệm đã hoàn tất và nội dung nghe nhìn hiện đã sẵn sàng để phát, bắt đầu tại dấu thời gian được cung cấp.
abstract void	notifySeekToTimestamp(Duration mediaPlayoutPosition) Thông báo cho Meet rằng người dùng đã tìm điểm phát nội dung nghe nhìn để Meet có thể phản chiếu hành động đó cho người dùng khác.
abstract void	notifySwitchedToMedia(     String mediaTitle,     String mediaId,     Duration mediaPlayoutPosition ) Thông báo cho Meet rằng người dùng đã chuyển đổi nội dung nghe nhìn để Meet có thể chuyển nội dung nghe nhìn đó cho những người dùng khác.
abstract void	notifySwitchedToMedia(     String mediaTitle,     String mediaId,     Duration mediaPlayoutPosition,     CoWatchingQueue queue ) Thông báo cho Meet rằng người dùng đã chuyển đổi nội dung nghe nhìn, kèm cập nhật hàng đợi mô phỏng để Meet có thể chuyển nội dung nghe nhìn đó cho những người dùng khác.

Hằng số

MAX_PLAYOUT_RATE

default static final double MAX_PLAYOUT_RATE = 2.0

Tốc độ phát lại tối đa được phép.

MAX_SEEKS_PER_SECOND

default static final double MAX_SEEKS_PER_SECOND = 0.9

Số lần tua tối đa được phép mỗi giây.

Phương thức công khai

notifyBuffering

abstract void notifyBuffering(Duration mediaPlayoutPosition)

Thông báo cho Meet rằng nội dung nghe nhìn chưa sẵn sàng để phát do tải vào bộ đệm, do có nút chuyển nội dung nghe nhìn trước đó, tìm kiếm nội dung nghe nhìn hoặc tình trạng nghẽn mạng bình thường.

Thông số
Duration mediaPlayoutPosition	vị trí tạm dừng nội dung nghe nhìn, chờ quá trình lưu vào bộ đệm hoàn tất

Gửi
java.lang.NullPointerException	nếu mediaPlayoutPosition rỗng
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc

notifyEnded

abstract void notifyEnded(Duration mediaPlayoutPosition)

Thông báo cho Meet rằng trình phát nội dung đa phương tiện đã kết thúc nội dung nghe nhìn hiện tại.

Lưu ý: không bắt buộc gọi phương thức này (mặc dù không có hại) nếu thông báoSwitchedToMedia được gọi qua cơ chế tự động phát ngay khi nội dung nghe nhìn kết thúc.

Thông số
Duration mediaPlayoutPosition	vị trí cuối cùng của người chơi

Gửi
java.lang.NullPointerException	nếu mediaPlayoutPosition rỗng
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc

notifyPauseState

abstract void notifyPauseState(boolean paused, Duration mediaPlayoutPosition)

Thông báo cho Meet rằng người dùng đã tạm dừng hoặc tiếp tục phát nội dung nghe nhìn để Meet có thể phản chiếu hành động đó cho người dùng khác.

Thông số
boolean paused	true nếu tạm dừng hoặc false nếu tiếp tục phát
Duration mediaPlayoutPosition	vị trí mà nội dung đa phương tiện đã bị tạm dừng hoặc tiếp tục

Gửi
java.lang.NullPointerException	nếu mediaPlayoutPosition rỗng
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc

notifyPlayoutRate

abstract void notifyPlayoutRate(double rate, Duration mediaPlayoutPosition)

Thông báo cho Meet rằng người dùng đã cập nhật tốc độ phát của nội dung nghe nhìn (ví dụ: 1,25x) thành một giá trị mới.

Thông số
double rate	tốc độ phát nội dung đa phương tiện
Duration mediaPlayoutPosition	vị trí hiện tại của trình phát

Gửi
java.lang.IllegalStateException	nếu rate không phải là số dương
java.lang.IllegalStateException	nếu rate lớn hơn MAX_PLAYOUT_RATE
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc

notifyQueueUpdate

abstract void notifyQueueUpdate(CoWatchingQueue queue)

Thông báo cho Meet rằng danh sách chờ đã thay đổi để Meet có thể phản chiếu nội dung đó cho người dùng khác.

Thông số
CoWatchingQueue queue	thông tin về hàng đợi của ứng dụng tiện ích bổ sung

Gửi
java.lang.NullPointerException	nếu queue rỗng
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc

notifyReady

abstract void notifyReady(Duration mediaPlayoutPosition)

Thông báo cho Meet rằng quá trình lưu vào bộ đệm đã hoàn tất và nội dung nghe nhìn hiện đã sẵn sàng để phát, bắt đầu tại dấu thời gian được cung cấp.

Thông số
Duration mediaPlayoutPosition	vị trí mà nội dung nghe nhìn được lưu vào bộ đệm và sẵn sàng phát

Gửi
java.lang.NullPointerException	nếu mediaPlayoutPosition rỗng
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc

notifySeekToTimestamp

abstract void notifySeekToTimestamp(Duration mediaPlayoutPosition)

Thông báo cho Meet rằng người dùng đã tìm điểm phát nội dung nghe nhìn để Meet có thể phản chiếu hành động đó cho người dùng khác.

Thông số
Duration mediaPlayoutPosition	dấu thời gian mà người dùng đã tìm kiếm

Gửi
java.lang.NullPointerException	nếu mediaPlayoutPosition rỗng
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc
java.lang.IllegalStateException	nếu số lượt tìm kiếm mỗi giây lớn hơn MAX_SEEKS_PER_SECOND

notifySwitchedToMedia

abstract void notifySwitchedToMedia(
    String mediaTitle,
    String mediaId,
    Duration mediaPlayoutPosition
)

Thông báo cho Meet rằng người dùng đã chuyển đổi nội dung nghe nhìn để Meet có thể chuyển nội dung nghe nhìn đó cho những người dùng khác.

Thông số
String mediaTitle	đã chuyển tiêu đề của nội dung nghe nhìn sang. Tiêu đề này sẽ hiển thị trong giao diện người dùng của Meet khi những người dùng khác cân nhắc việc kết nối với phiên cùng xem.
String mediaId	URI chuỗi của nội dung nghe nhìn đã chuyển thành
Duration mediaPlayoutPosition	vị trí mà nội dung nghe nhìn bắt đầu phát

Gửi
java.lang.NullPointerException	nếu mediaId hoặc mediaPlayoutPosition là rỗng
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc

notifySwitchedToMedia

abstract void notifySwitchedToMedia(
    String mediaTitle,
    String mediaId,
    Duration mediaPlayoutPosition,
    CoWatchingQueue queue
)

Thông báo cho Meet rằng người dùng đã chuyển đổi nội dung nghe nhìn, kèm cập nhật hàng đợi mô phỏng để Meet có thể chuyển nội dung nghe nhìn đó cho những người dùng khác.

Thông số
String mediaTitle	đã chuyển tiêu đề của nội dung nghe nhìn sang. Tiêu đề này sẽ hiển thị trong giao diện người dùng của Meet khi những người dùng khác cân nhắc việc kết nối với phiên cùng xem.
String mediaId	URI chuỗi của nội dung nghe nhìn đã chuyển thành
Duration mediaPlayoutPosition	vị trí mà nội dung nghe nhìn bắt đầu phát
CoWatchingQueue queue	thông tin về hàng đợi của ứng dụng tiện ích bổ sung

Gửi
java.lang.NullPointerException	nếu mediaId, mediaPlayoutPosition hoặc queue là giá trị rỗng
com.google.android.meet.addons.AddonException	nếu có lỗi không mong muốn
java.lang.IllegalStateException	nếu được gọi sau khi phiên cùng xem kết thúc