W3cubDocs

/Web APIs

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

js

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).

js

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

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
watchAvailability 56 79 No No 43 13.1 No 56 No 43 13.4 6.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RemotePlayback/watchAvailability