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 des RemotePlayback-Interfaces fordert den Benutzer auf, ein verfügbares Fernwiedergabegerät auszuwählen und die Erlaubnis zu erteilen, das aktuelle Medium mit diesem Gerät abzuspielen.
Wenn der Benutzer die Erlaubnis erteilt, wird der state auf connecting gesetzt und der User-Agent verbindet sich mit dem Gerät, um die Wiedergabe zu starten.
Wenn der Benutzer stattdessen wählt, die Verbindung zu dem 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, der mit undefined aufgelöst wird, nachdem der Benutzer das Prompt akzeptiert 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 es bereits ein nicht abgeschlossenes Promise von einem vorherigen Aufruf von
prompt()für dieses Medienelement oder diesen Browsing-Kontext gibt. InvalidAccessErrorDOMException-
Wird ausgelöst, wenn der Benutzer kürzlich nicht mit diesem Gerät interagiert hat.
NotSupportedErrorDOMException-
Wird ausgelöst, wenn der User-Agent weiß, dass die Fernwiedergabe dieses speziellen Mediums nicht machbar ist.
NotFoundErrorDOMException-
Wird ausgelöst, wenn die 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 Fernwiedergabegerä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 |