RemotePlayback: prompt() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die prompt()-Methode der RemotePlayback-Schnittstelle fordert den Benutzer auf, ein verfügbares Remote-Wiedergabegerät auszuwählen und die Erlaubnis zu erteilen, dass das aktuelle Medium über dieses Gerät abgespielt wird.
Wenn der Benutzer die Erlaubnis erteilt, wird der state auf connecting gesetzt und der User-Agent wird sich mit dem Gerät verbinden, um die Wiedergabe zu starten.
Wenn der Benutzer stattdessen wählt, die Verbindung zum Gerät zu trennen, wird der state auf disconnected gesetzt und der User-Agent trennt die Verbindung zu diesem Gerät.
Syntax
prompt()
Parameter
Keine.
Rückgabewert
Ein Promise, das mit undefined aufgelöst wird, nachdem der Benutzer die Eingabeaufforderung angenommen oder abgelehnt hat.
Ausnahmen
Das Promise wird mit einer der folgenden Ausnahmen abgelehnt:
InvalidStateErrorDOMException-
Wird ausgelöst, wenn
disableRemotePlaybackfür das Medienelementtrueist. OperationErrorDOMException-
Wird ausgelöst, wenn bereits ein offenes Promise von einem vorherigen Aufruf von
prompt()für dieses Medienelement oder den Browsing-Kontext existiert. InvalidAccessErrorDOMException-
Wird ausgelöst, wenn der Benutzer kürzlich nicht mit diesem Gerät interagiert hat.
NotSupportedErrorDOMException-
Wird ausgelöst, wenn dem User-Agent bekannt ist, dass eine Fernwiedergabe dieses speziellen Mediums nicht durchführbar ist.
NotFoundErrorDOMException-
Wird ausgelöst, wenn eine Fernwiedergabe nicht verfügbar ist.
NotAllowedErrorDOMException-
Wird ausgelöst, wenn der Benutzer die Erlaubnis zur Nutzung des Geräts verweigert.
Sicherheit
Vorübergehende Benutzeraktivierung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion funktioniert.
Beispiele
Im folgenden Beispiel wird der Benutzer aufgefordert, ein Remote-Wiedergabegerät auszuwählen, um ein Video abzuspielen.
devicesBtn.onclick = () => {
// Request the user to select a remote playback device.
videoElem.remote
.prompt()
// Update the UI and monitor the connected state.
.then(updateRemotePlaybackState);
// Otherwise, the user cancelled the selection UI or no screens were found.
};
Spezifikationen
| Specification |
|---|
| Remote Playback API> # dom-remoteplayback-prompt> |
Browser-Kompatibilität
Loading…