RemotePlayback: watchAvailability() 方法

可用性有限

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

watchAvailability()RemotePlayback 接口的一个方法。它用于监视可用远程回放设备的列表,并返回一个 Promise,该 Promise 在远程回放设备的 callbackId 解析时解决。

语法

js
watchAvailability(RemotePlaybackAvailabilityCallback)

参数

RemotePlaybackAvailabilityCallback(boolean)

此回调允许页面获取相应媒体元素的远程回放设备可用性。它会传入一个布尔值,如果为 true,则表示远程回放可用。

返回值

一个 Promise,它会解析为一个整数。这是所识别的远程回放设备的 callbackId

异常

InvalidStateError DOMException

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

NotSupportedError DOMException

如果用户代理无法持续监视可用远程回放设备的列表,则会抛出此错误。

示例

在下面的示例中,首先检查当前没有连接的设备,然后使用 watchAvailability() 来监视远程设备何时变得可用。查看工作示例(需要支持的设备和连接的远程回放设备)。

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

规范

规范
Remote Playback API
# dom-remoteplayback-watchavailability

浏览器兼容性