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

BCD tables only load in the browser