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 Geräten für die Remote-Wiedergabe zu erkennen und dann die Wiedergabe auf diesen Geräten zu steuern.
Instanzeigenschaften
Erbt auch Eigenschaften von seinem Elterninterface, EventTarget
.
RemotePlayback.state
Schreibgeschützt-
Repräsentiert den Status der
RemotePlayback
-Verbindung. Einer von:"connecting"
-
Der User-Agent versucht, die Remote-Wiedergabe mit dem ausgewählten Gerät zu initiieren.
"connected"
-
Der Wechsel von lokaler zu Remote-Wiedergabe hat stattgefunden, alle Befehle werden nun auf dem Remote-Gerät ausgeführt.
"disconnected"
-
Die Remote-Wiedergabe wurde nicht initiiert, konnte nicht initiiert werden oder wurde gestoppt.
Instanzmethoden
Erbt auch Methoden von seinem Elterninterface, EventTarget
.
RemotePlayback.watchAvailability()
-
Überwacht die Liste der verfügbaren Remote-Wiedergabegeräte und gibt ein
Promise
zurück, das mit einemcallbackId
eines verfügbaren Remote-Wiedergabegeräts aufgelöst wird. RemotePlayback.cancelWatchAvailability()
-
Hebt die Anfrage zur Überwachung der Verfügbarkeit von Remote-Wiedergabegeräten auf.
RemotePlayback.prompt()
-
Fordert den Benutzer auf, ein Remote-Wiedergabegerät auszuwählen und die Berechtigung zur Verbindung zu erteilen.
Ereignisse
Erbt auch Ereignisse von seinem Elterninterface, EventTarget
.
connecting
-
Wird ausgelöst, wenn der User-Agent die Remote-Wiedergabe initiiert.
connect
-
Wird ausgelöst, wenn der User-Agent erfolgreich eine Verbindung zum Remote-Gerät herstellt.
disconnect
-
Wird ausgelöst, wenn der User-Agent die Verbindung zum Remote-Gerät trennt.
Beispiele
Das folgende Beispiel zeigt einen Player mit benutzerdefinierten Steuerelementen, die die Remote-Wiedergabe unterstützen. Zu Beginn ist die Schaltfläche, die zur Auswahl eines Geräts verwendet wird, ausgeblendet:
<video id="videoElement" src="https://example.org/media.ext">
<button id="deviceBtn" style="display: none;">Pick device</button>
</video>
Die Methode RemotePlayback.watchAvailability()
wird verwendet, um nach verfügbaren Remote-Wiedergabegeräten zu suchen. Wenn ein Gerät verfügbar ist, verwenden Sie den Callback, um die Schaltfläche 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.
deviceBtn.style.display = available ? "inline" : "none";
}
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.style.display = "inline";
});
Spezifikationen
Specification |
---|
Remote Playback API # remoteplayback-interface |