远程播放: cancelWatchAvailability() 方法

cancelWatchAvailability() 方法是 RemotePlayback 接口的方法，用于取消监视一个或所有可用设备的请求。

语法

js
cancelWatchAvailability()
cancelWatchAvailability(id)

参数

id 可选

特定远程播放设备的 callbackId。

如果传递了特定设备的 callbackId，则该设备将从监视设备列表中移除。否则，整个列表将被清空。

返回值

一个解析为 undefined 的 Promise。

异常

InvalidStateError DOMException

如果媒体元素的 disableRemotePlayback 为 true，则抛出此异常。

NotFoundError DOMException

如果传递了 id 但它与任何可用的 callbackId 不匹配，则抛出此异常。

示例

一旦识别出远程播放设备并连接，可以使用 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();
}

规范

规范
远程播放 API
# dom-remoteplayback-cancelwatchavailability

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。