Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

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

InvalidStateError DOMException

Wird ausgelöst, wenn disableRemotePlayback für das Medien-Element auf true gesetzt ist.

OperationError DOMException

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.

InvalidAccessError DOMException

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

NotSupportedError DOMException

Wird ausgelöst, wenn der User Agent weiß, dass die Remote-Wiedergabe dieser speziellen Medien nicht möglich ist.

NotFoundError DOMException

Wird ausgelöst, wenn die Remote-Wiedergabe nicht verfügbar ist.

NotAllowedError DOMException

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.

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 canceled the selection UI or no screens were found.
};

Spezifikationen

Spezifikation
Remote Playback API
# dom-remoteplayback-prompt

Browser-Kompatibilität