RemotePlayback: cancelWatchAvailability() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

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

语法

js
cancelWatchAvailability()
cancelWatchAvailability(id)

参数

id 可选

特定远程播放设备的 callbackId

如果传入特定设备的 callbackId,则该设备将从受监视设备列表中移除。否则,整个列表将被清除。

返回值

一个 Promise,解析为 undefined

异常

InvalidStateError DOMException

如果媒体元素的 disableRemotePlaybacktrue,则抛出此异常。

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();
}

规范

规范
Remote Playback API
# dom-remoteplayback-cancelwatchavailability

浏览器兼容性