RemotePlayback: watchAvailability() 方法

watchAvailability() 方法是 RemotePlayback 接口的方法，用于监视可用远程播放设备的列表，并返回一个 Promise，该 Promise 解析为远程播放设备的 callbackId。

语法

js
watchAvailability(RemotePlaybackAvailabilityCallback)

参数

RemotePlaybackAvailabilityCallback(boolean)

一个回调函数，允许页面获取对应媒体元素的远程播放设备可用性。它传递一个布尔值，如果为真，则表示远程播放可用。

返回值

一个 Promise，解析为一个整数。这是已识别远程播放设备的 callbackId。

异常

InvalidStateError DOMException

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

NotSupportedError DOMException

如果用户代理无法持续监视可用远程播放设备的列表，则抛出此异常。

示例

在以下示例中，在检查当前没有连接的设备后，watchAvailability() 用于监视远程设备变为可用。 查看工作示例（需要支持的设备和连接的远程播放设备）。

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

规范

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

浏览器兼容性

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