RemotePlayback: watchAvailability() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die watchAvailability()-Methode des RemotePlayback-Interfaces überwacht die Liste der verfügbaren Remote-Wiedergabegeräte und gibt ein Promise zurück, das mit der callbackId eines Remote-Wiedergabegerätes aufgelöst wird.

Syntax

js
watchAvailability(RemotePlaybackAvailabilityCallback)

Parameter

RemotePlaybackAvailabilityCallback(boolean)

Ein Rückruf, der es der Seite ermöglicht, die Verfügbarkeit des Remote-Wiedergabegeräts für das entsprechende Medien-Element zu erhalten. Es wird ein boolean übergeben, der angibt, ob die Remote-Wiedergabe verfügbar ist.

Rückgabewert

Ein Promise, das mit einer ganzen Zahl aufgelöst wird. Dies ist die callbackId für das identifizierte Remote-Wiedergabegerät.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn disableRemotePlayback für das Medien-Element true ist.

NotSupportedError DOMException

Wird ausgelöst, wenn der Benutzeragent nicht in der Lage ist, die Liste der verfügbaren Remote-Wiedergabegeräte kontinuierlich zu überwachen.

Beispiele

Im folgenden Beispiel wird, nachdem überprüft wurde, dass kein momentan verbundenes Gerät existiert, watchAvailability() verwendet, um auf die Verfügbarkeit von Remote-Geräten zu warten. Siehe das funktionierende Beispiel (Erfordert ein unterstütztes Gerät und ein verbundenes Remote-Wiedergabegerät).

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

Spezifikationen

Specification
Remote Playback API
# dom-remoteplayback-watchavailability

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
watchAvailability

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support