| CARVIEW |
Select Language
HTTP/2 200
content-type: text/html
x-guploader-uploadid: AAwnv3Kzbk88ZTiR5FciMmP3BwF9APP6a4-Pi_vGMefIKkBktFGl0nE7YXLACX2GUo4reRlY
cache-control: public, max-age=3600
expires: Fri, 10 Oct 2025 01:16:04 GMT
last-modified: Thu, 09 Oct 2025 01:12:37 GMT
etag: W/"b9b280ec5e544e3666052de339440a28"
x-goog-generation: 1759972356901693
x-goog-metageneration: 1
x-goog-stored-content-encoding: identity
x-goog-stored-content-length: 160738
x-goog-meta-goog-reserved-file-mtime: 1759970507
x-goog-hash: crc32c=ddfaLg==, md5=ubKA7F5UTjZmBS3jOUQKKA==
x-goog-storage-class: STANDARD
accept-ranges: none
alt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
alt-svc: clear
referrer-policy: strict-origin-when-cross-origin
x-content-type-options: nosniff
strict-transport-security: max-age=63072000
content-security-policy: default-src 'self'; script-src 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; script-src-elem 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; style-src 'report-sample' 'self' 'unsafe-inline'; object-src 'none'; base-uri 'self'; connect-src 'self' developer.allizom.org bcd.developer.allizom.org bcd.developer.mozilla.org updates.developer.allizom.org updates.developer.mozilla.org https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com https://incoming.telemetry.mozilla.org https://observatory-api.mdn.allizom.net https://observatory-api.mdn.mozilla.net https://api.github.com/search/issues stats.g.doubleclick.net https://api.stripe.com; font-src 'self'; frame-src 'self' interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net mdn.github.io live-samples.mdn.mozilla.net live-samples.mdn.allizom.net *.mdnplay.dev *.mdnyalp.dev *.play.test.mdn.allizom.net https://v2.scrimba.com https://scrimba.com jsfiddle.net www.youtube-nocookie.com codepen.io survey.alchemer.com https://js.stripe.com; img-src 'self' data: *.githubusercontent.com *.googleusercontent.com *.gravatar.com mozillausercontent.com firefoxusercontent.com profile.stage.mozaws.net profile.accounts.firefox.com developer.mozilla.org mdn.dev interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net wikipedia.org upload.wikimedia.org https://mdn.github.io/shared-assets/ https://mdn.dev/ https://*.google-analytics.com https://*.googletagmanager.com www.gstatic.com; manifest-src 'self'; media-src 'self' archive.org videos.cdn.mozilla.net https://mdn.github.io/shared-assets/; child-src 'self'; worker-src 'self';
x-frame-options: DENY
origin-trial: AxVILwizhbMjxFeHOn1P3R8niO1RJY/smaK4B4d1rLzc1gTaxtXMSaTi+FoigYgCw40uFRDwFcEAeqDR+vVLOW4AAABfeyJvcmlnaW4iOiJodHRwczovL2RldmVsb3Blci5tb3ppbGxhLm9yZyIsImZlYXR1cmUiOiJQcml2YXRlQXR0cmlidXRpb25WMiIsImV4cGlyeSI6MTc0MjA3OTYwMH0=
x-cloud-trace-context: 01b4b809e4cfeff60e6eb25c5b5065c4
date: Fri, 10 Oct 2025 00:16:04 GMT
server: Google Frontend
via: 1.1 google
vary: Accept-Encoding
content-encoding: gzip
x-cache: miss
HTMLMediaElement: setSinkId() メソッド - Web API | MDN
Toggle sidebar
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
HTMLMediaElement: setSinkId() メソッド
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
setSinkId() は HTMLMediaElement インターフェイスのメソッドで、出力に使用するオーディオ機器の ID を設定し、プロミス (Promise) を返します。
これは、アプリケーションが指定された機器を使用することを許可されている場合にのみ動作します。詳しくは下記のセキュリティ要件を参照してください。
構文
js
setSinkId(sinkId)
引数
sinkId-
オーディオ出力機器の
MediaDeviceInfo.deviceIdです。
返値
例外
NotAllowedErrorDOMException-
speaker-selection権限ポリシーが音声出力の使用をブロックするために使用された場合に返されます。 NotFoundErrorDOMException-
deviceIdがどの音声機器にも一致しない場合に返されます。 AbortErrorDOMException-
音声出力機器から新しい音声機器への切り替えに失敗した場合に返されます。
セキュリティ要件
この API にアクセスするには、以下の制約があります。
- このメソッドは保護されたコンテキストの中で呼び出すこと。
- アクセスが
speaker-selectionHTTP 権限ポリシーで制限されることがあります。 - 既定以外の端末にアクセスするには、そのユーザー権限が要求されます。
ユーザーは、
MediaDevices.selectAudioOutput()で表示されるプロンプトで、ID に関連付けられた端末を選択することで、その権限を付与します。
例
この例では、MediaDevices.enumerateDevices() が返す配列から音声出力機器を選択し、それを音声のシンクとして設定する方法を示します。
enumerateDevices() の結果には、ユーザー権限が要求されていないか、すでに付与されている端末しか含まれないことに注意してください。
js
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}`);
仕様書
| Specification |
|---|
| Audio Output Devices API # dom-htmlmediaelement-setsinkid |
ブラウザーの互換性
Loading…