DOM

HTMLMediaElement.setSinkId() メソッド

[Edge]。→、、

HTMLMediaElement の出力に使用するオーディオ デバイスの ID を設定し、Promise を返します。これは、アプリケーションが指定されたデバイスの使用を許可されている場合にのみ機能します。

構文

戻り値

undefined に解決される Promise。

例外

NotAllowedError／DOMException

要求されたデバイスを使用する権限がない場合に返されます。

NotFoundError／DOMException

deviceId がどのオーディオ出力デバイスとも一致しない場合に返されます。

AbortError／DOMException

オーディオ出力デバイスの新しいオーディオ デバイスへの切り替えに失敗した場合に返されます。

例

mdn

const devices = await navigator.mediaDevices.enumerateDevices();
const audioDevices = devices.filter(device => device.kind === 'audiooutput');
const audio = document.createElement('audio');
await audio.setSinkId(audioDevices[0].deviceId);
console.log('Audio is being played on ' + audio.sinkId);

テスト