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

js
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:

InvalidStateError DOMException

Wird ausgelöst, wenn disableRemotePlayback für das Medienelement true ist.

OperationError DOMException

Wird ausgelöst, wenn bereits ein offenes Promise von einem vorherigen Aufruf von prompt() für dieses Medienelement oder den Browsing-Kontext existiert.

InvalidAccessError DOMException

Wird ausgelöst, wenn der Benutzer kürzlich nicht mit diesem Gerät interagiert hat.

NotSupportedError DOMException

Wird ausgelöst, wenn dem User-Agent bekannt ist, dass eine Fernwiedergabe dieses speziellen Mediums nicht durchführbar ist.

NotFoundError DOMException

Wird ausgelöst, wenn eine Fernwiedergabe nicht verfügbar ist.

NotAllowedError DOMException

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.

js
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

BCD tables only load in the browser