RemotePlayback: cancelWatchAvailability() Methode

Limited availability

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

Die cancelWatchAvailability() Methode der RemotePlayback Schnittstelle storniert die Anfrage, um ein oder alle verfügbaren Geräte zu überwachen.

Syntax

js
cancelWatchAvailability()
cancelWatchAvailability(id)

Parameter

id Optional

Die callbackId eines bestimmten Remote-Playback-Geräts.

Wenn eine callbackId eines spezifischen Geräts übergeben wird, dann wird dieses Gerät aus der Liste der überwachten Geräte entfernt. Andernfalls wird die gesamte Liste geleert.

Rückgabewert

Ein Promise, der mit undefined aufgelöst wird.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn disableRemotePlayback für das Medienelement true ist.

NotFoundError DOMException

Wird ausgelöst, wenn eine id übergeben wird, die keiner verfügbaren callbackId entspricht.

Beispiele

Sobald ein Remote-Playback-Gerät identifiziert und verbunden wurde, kann die Überwachung der verfügbaren Geräte mit cancelWatchAvailability() gestoppt werden.

js
function switchToRemoteUI() {
  // Indicate that the state is 'connecting' or 'connected' to the user.
  // For example, hide the video element as only controls are needed.
  videoElem.style.display = "none";

  // Stop monitoring the availability of remote playback devices.
  videoElem.remote.cancelWatchAvailability();
}

Spezifikationen

Specification
Remote Playback API
# dom-remoteplayback-cancelwatchavailability

Browser-Kompatibilität

BCD tables only load in the browser