RemotePlayback: cancelWatchAvailability() method

Khả dụng hạn chế

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

Phương thức cancelWatchAvailability() của giao diện RemotePlayback hủy yêu cầu theo dõi một hoặc tất cả các thiết bị khả dụng.

Cú pháp

js
cancelWatchAvailability()
cancelWatchAvailability(id)

Tham số

id Optional

callbackId của một thiết bị phát từ xa cụ thể.

Nếu callbackId của một thiết bị cụ thể được truyền vào, thiết bị đó sẽ bị xóa khỏi danh sách các thiết bị đang được theo dõi. Ngược lại, toàn bộ danh sách sẽ bị xóa.

Giá trị trả về

Một Promise được giải quyết với undefined.

Ngoại lệ

InvalidStateError DOMException

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

NotFoundError DOMException

Được ném ra nếu id được truyền vào nhưng không khớp với bất kỳ callbackId khả dụng nào.

Ví dụ

Sau khi một thiết bị phát từ xa đã được xác định và kết nối, việc theo dõi các thiết bị khả dụng có thể được dừng bằng cách dùng cancelWatchAvailability().

js
function switchToRemoteUI() {
  // Indicate that the state is 'connecting' or 'connected' to the user.
  // For example, hide the video element as only controls are needed.
  videoElem.style.display = "none";

  // Stop monitoring the availability of remote playback devices.
  videoElem.remote.cancelWatchAvailability();
}

Thông số kỹ thuật

Thông số kỹ thuật
Remote Playback API
# dom-remoteplayback-cancelwatchavailability

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