RemotePlayback

Интерфейс RemotePlayback API удалённого воспроизведения позволяет странице определить доступность устройств удалённого воспроизведения, а затем подключиться к ним и управлять воспроизведением на этих устройствах.

Также наследует свойства от своего родительского интерфейса, EventTarget.

RemotePlayback.state Только для чтения

Представляет состояние подключения RemotePlayback. Может принимать одно из следующих значений:

"connecting"

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

"connected"

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

"disconnected"

Удалённое воспроизведение не было инициировано, не удалось инициировать или оно было остановлено.

Также наследует методы от своего родительского интерфейса, EventTarget.

RemotePlayback.watchAvailability()

Отслеживает список доступных устройств удалённого воспроизведения и возвращает Promise, который разрешается со значением callbackId доступного устройства удалённого воспроизведения.

RemotePlayback.cancelWatchAvailability()

Отменяет запрос на мониторинг доступности устройств удалённого воспроизведения.

RemotePlayback.prompt()

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

Также наследует события от своего родительского интерфейса, EventTarget.

connecting

Срабатывает, когда пользовательский агент инициирует удалённое воспроизведение.

connect

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

disconnect

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

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

<video id="videoElement" src="https://example.org/media.ext">
  <button id="deviceBtn" style="display: none;">Pick device</button>
</video>

Метод RemotePlayback.watchAvailability() используется для отслеживания доступных устройств удалённого воспроизведения. Если устройство доступно, используйте обратный вызов для отображения кнопки.

const deviceBtn = document.getElementById("deviceBtn");
const videoElem = document.getElementById("videoElement");

function availabilityCallback(available) {
  // Show or hide the device picker button depending on device availability.
  deviceBtn.style.display = available ? "inline" : "none";
}

videoElem.remote.watchAvailability(availabilityCallback).catch(() => {
  /* If the device cannot continuously watch available,
  show the button to allow the user to try to prompt for a connection.*/
  deviceBtn.style.display = "inline";
});