HTMLMediaElement: метод setSinkId()

Метод setSinkId() интерфейса HTMLMediaElement устанавливает идентификатор аудиоустройства для вывода и возвращает Promise.

Это работает только в том случае, если приложение имеет разрешение на использование указанного устройства. Дополнительную информацию см. в разделе требования к безопасности ниже.

sinkId

Идентификатор MediaDeviceInfo.deviceId аудиовывода.

A Promise, который разрешается в undefined.

NotAllowedError DOMException

Возвращается, если speaker-selection Политика разрешений используется для блокирования использования аудиовыходов.

NotFoundError DOMException

Возвращается, если deviceId не соответствует ни одному аудиовыходу.

AbortError DOMException

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

Доступ к API ограничен следующими условиями:

• Метод должен вызываться в безопасном контексте.
• Доступ может быть ограничен speaker-selection HTTP Политикой разрешений.
• Для доступа к устройству, отличного от стандартного, требуется разрешение пользователя. Пользователь предоставляет разрешение, выбрав устройство, связанное с идентификатором, в запросе, отображаемом MediaDevices.selectAudioOutput().

В этом примере показано, как выбрать аудиовыходное устройство из массива, возвращаемого MediaDevices.enumerateDevices(), и установить его в качестве источника звука. Обратите внимание, что результат enumerateDevices() содержит только устройства, для которых не требуется разрешение пользователя или оно уже предоставлено.

const devices = await navigator.mediaDevices.enumerateDevices();
const audioDevice = devices.find((device) => device.kind === "audiooutput");
const audio = document.createElement("audio");
await audio.setSinkId(audioDevice.deviceId);
console.log(`Audio is being output on ${audio.sinkId}`);

• API устройств аудиовывода
• MediaDevices.selectAudioOutput()
• HTMLMediaElement.sinkId