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

瀏覽器相容性