RemotePlayback: prompt() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die prompt() Methode der RemotePlayback-Schnittstelle fordert den Nutzer auf, ein verfügbares Remote-Playback-Gerät auszuwählen und die Erlaubnis zu erteilen, dass die aktuelle Medienwiedergabe über dieses Gerät erfolgt.
Wenn der Nutzer 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 Nutzer stattdessen entscheidet, die Verbindung zum Gerät zu trennen, wird der state auf disconnected gesetzt und der User Agent wird die Verbindung zu diesem Gerät trennen.
Syntax
prompt()
Parameter
Keine.
Rückgabewert
Ein Promise, das mit undefined aufgelöst wird, nachdem der Nutzer das Eingabefenster angenommen oder abgelehnt hat.
Ausnahmen
Das Promise wird mit einer der folgenden Ausnahmen abgelehnt:
InvalidStateErrorDOMException-
Wird ausgelöst, wenn
disableRemotePlaybackfür das Medien-Element auftruegesetzt ist. OperationErrorDOMException-
Wird ausgelöst, wenn bereits ein ungelöstes Promise von einem vorherigen Aufruf von
prompt()für dieses Medien-Element oder diesen Browsing-Kontext existiert. InvalidAccessErrorDOMException-
Wird ausgelöst, wenn der Nutzer kürzlich nicht mit diesem Gerät interagiert hat.
NotSupportedErrorDOMException-
Wird ausgelöst, wenn der User Agent weiß, dass die Remote-Wiedergabe dieser speziellen Medien nicht möglich ist.
NotFoundErrorDOMException-
Wird ausgelöst, wenn die Remote-Wiedergabe nicht verfügbar ist.
NotAllowedErrorDOMException-
Wird ausgelöst, wenn der Nutzer die Erlaubnis zur Nutzung des Geräts verweigert.
Sicherheit
Eine transiente Benutzeraktivierung ist erforderlich. Der Nutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion genutzt werden kann.
Beispiele
Im folgenden Beispiel wird der Nutzer aufgefordert, ein Remote-Playback-Gerä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 canceled the selection UI or no screens were found.
};
Spezifikationen
| Spezifikation |
|---|
| Remote Playback API> # dom-remoteplayback-prompt> |