RemotePlayback: watchAvailability() method

The watchAvailability() method of the RemotePlayback interface watches the list of available remote playback devices and returns a Promise that resolves with the callbackId of a remote playback device.

Syntax

watchAvailability(RemotePlaybackAvailabilityCallback)

Parameters

RemotePlaybackAvailabilityCallback(boolean)

A callback that allows the page to obtain the remote playback device availability for the corresponding media element. It is passed a boolean which, if true, indicates that remote playback is available.

Return value

A Promise that resolves with an integer. This is the callbackId for the identified remote playback device.

Exceptions

InvalidStateError DOMException

Thrown if disableRemotePlayback is true for the media element.

NotSupportedError DOMException

Thrown if the user agent is unable to continuously monitor the list of available remote playback devices.

Examples

In the following example, after checking that there is no currently connected device, watchAvailability() is used to watch for remote devices becoming available. See the working example (Requires a supported device and a connected remote playback device).

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

Specifications

Specification
Remote Playback API
# dom-remoteplayback-watchavailability

Browser compatibility

BCD tables only load in the browser