RemotePlayback: watchAvailability() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức watchAvailability() của giao diện RemotePlayback theo dõi danh sách các thiết bị phát từ xa khả dụng và trả về một Promise được giải quyết với callbackId của một thiết bị phát từ xa.

Cú pháp

js
watchAvailability(RemotePlaybackAvailabilityCallback)

Tham số

RemotePlaybackAvailabilityCallback(boolean)

Một callback cho phép trang lấy tính khả dụng của thiết bị phát từ xa cho phần tử phương tiện tương ứng. Nó được truyền một giá trị boolean, nếu là true, cho biết phát từ xa khả dụng.

Giá trị trả về

Một Promise được giải quyết với một số nguyên. Đây là callbackId cho thiết bị phát từ xa được xác định.

Ngoại lệ

InvalidStateError DOMException

Được ném ra nếu disableRemotePlaybacktrue cho phần tử phương tiện.

NotSupportedError DOMException

Được ném ra nếu tác nhân người dùng không thể liên tục theo dõi danh sách các thiết bị phát từ xa khả dụng.

Ví dụ

Trong ví dụ sau, sau khi kiểm tra rằng không có thiết bị nào đang kết nối, watchAvailability() được dùng để theo dõi các thiết bị từ xa trở nên khả dụng. Xem ví dụ hoạt động (Yêu cầu thiết bị được hỗ trợ và một thiết bị phát từ xa đã kết nối).

js
if (video.remote.state === "disconnected") {
  video.remote.watchAvailability(handleAvailabilityChange).then((id) => {
    log(`> Started watching remote device availability: ${id}`);
    callbackId = id;
  });
}

Thông số kỹ thuật

Specification
Remote Playback API
# dom-remoteplayback-watchavailability

Tương thích trình duyệt