RemotePlayback

Limited availability

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

Das RemotePlayback Interface der Remote Playback API ermöglicht es der Seite, die Verfügbarkeit von Fernwiedergabegeräten zu erkennen, sich mit diesen zu verbinden und die Wiedergabe auf diesen Geräten zu steuern.

EventTarget RemotePlayback

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem Eltern-Interface, EventTarget.

RemotePlayback.state Schreibgeschützt

Representiert den Zustand der RemotePlayback-Verbindung. Einer der folgenden Werte:

"connecting"

Der Benutzeragent versucht, die Fernwiedergabe mit dem ausgewählten Gerät zu initiieren.

"connected"

Der Übergang von der lokalen zur Fernwiedergabe ist erfolgt, alle Befehle werden nun auf dem Fernwiedergabegerät ausgeführt.

"disconnected"

Die Fernwiedergabe wurde nicht initiiert, konnte nicht initiiert werden oder wurde gestoppt.

Instanz-Methoden

Erbt auch Methoden von seinem Eltern-Interface, EventTarget.

RemotePlayback.watchAvailability()

Überwacht die Liste der verfügbaren Fernwiedergabegeräte und gibt ein Promise zurück, das mit einer callbackId eines verfügbaren Fernwiedergabegeräts aufgelöst wird.

RemotePlayback.cancelWatchAvailability()

Bricht die Anfrage zum Überwachen der Verfügbarkeit von Fernwiedergabegeräten ab.

RemotePlayback.prompt()

Fordert den Benutzer auf, ein Fernwiedergabegerät auszuwählen und die Erlaubnis zur Verbindung zu erteilen.

Ereignisse

Erbt auch Ereignisse von seinem Eltern-Interface, EventTarget.

connecting

Wird ausgelöst, wenn der Benutzeragent die Fernwiedergabe initiiert.

connect

Wird ausgelöst, wenn der Benutzeragent erfolgreich mit dem Fernwiedergabegerät verbunden ist.

disconnect

Wird ausgelöst, wenn der Benutzeragent die Verbindung zum Fernwiedergabegerät trennt.

Beispiele

Das folgende Beispiel zeigt einen Player mit benutzerdefinierten Steuerungen, die Fernwiedergabe unterstützen. Der anfangs verwendete Knopf zur Auswahl eines Geräts ist verborgen:

html
<video id="videoElement" src="https://example.org/media.ext">
  <button id="deviceBtn" class="hidden">Pick device</button>
</video>
css
.hidden {
  display: none;
}

Die Methode RemotePlayback.watchAvailability() wird verwendet, um nach verfügbaren Fernwiedergabegeräten zu suchen. Wenn ein Gerät verfügbar ist, verwenden Sie den Callback, um den Knopf anzuzeigen.

js
const deviceBtn = document.getElementById("deviceBtn");
const videoElem = document.getElementById("videoElement");

function availabilityCallback(available) {
  // Show or hide the device picker button depending on device availability.
  if (available) {
    deviceBtn.classList.remove("hidden");
  } else {
    deviceBtn.classList.add("hidden");
  }
}

videoElem.remote.watchAvailability(availabilityCallback).catch(() => {
  // If the device cannot continuously watch available,
  // show the button to allow the user to try to prompt for a connection.
  deviceBtn.classList.remove("hidden");
});

Spezifikationen

Specification
Remote Playback API
# remoteplayback-interface

Browser-Kompatibilität