RemotePlayback: метод prompt()

Метод prompt() интерфейса RemotePlayback предлагает пользователю выбрать доступное устройство для удаленного воспроизведения и разрешить воспроизведение текущего медиа на этом устройстве.

Если пользователь разрешит, state будет установлено в connecting, и пользовательский агент подключится к устройству для начала воспроизведения.

Если пользователь решит отключиться от устройства, state будет установлено в disconnected, и пользовательский агент отключится от этого устройства.

Нет.

A Promise, который завершается с undefined после того, как пользователь подтвердит или отклонит запрос.

Обещание будет отклонено с одним из следующих исключений:

InvalidStateError DOMException

Выбрасывается, если disableRemotePlayback имеет значение true для элемента медиа.

OperationError DOMException

Выбрасывается, если уже существует незавершенное обещание от предыдущего вызова prompt() для этого элемента медиа или контекста просмотра.

InvalidAccessError DOMException

Выбрасывается, если пользователь недавно не взаимодействовал с этим устройством.

NotSupportedError DOMException

Выбрасывается, если пользовательский агент знает, что удалённое воспроизведение данного медиа нереально.

NotFoundError DOMException

Выбрасывается, если удалённое воспроизведение недоступно.

NotAllowedError DOMException

Выбрасывается, если пользователь отклоняет разрешение на использование устройства.

Временная активация пользователя требуется. Пользователь должен взаимодействовать со страницей или элементом пользовательского интерфейса для работы этой функции.

В следующем примере пользователю предлагается выбрать устройство для удалённого воспроизведения видео.

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.
};