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.
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 einercallbackId
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:
<video id="videoElement" src="https://example.org/media.ext">
<button id="deviceBtn" class="hidden">Pick device</button>
</video>
.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.
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 |