AudioContext: sinkchange event
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Web Audio API")}}{{SeeCompatTable}}
The **sinkchange** event of the {{domxref("AudioContext")}} interface is fired when the output audio device (and therefore, the {{domxref("AudioContext.sinkId")}}) has changed.
Syntax
Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:
addEventListener("sinkchange", (event) => { })Alternatively, assign to the event handler property of the interface:
onsinkchange = (event) => { }Event type
{{domxref("Event")}}.
{{InheritanceDiagram("Event")}}
Examples
A sinkchange event listener can be used to report a change of audio output device. Note that if {{domxref("AudioContext.sinkId", "sinkId")}} contains an {{domxref("AudioSinkInfo")}} object, it indicates that the audio has been changed to not play on any output device.
audioCtx.addEventListener("sinkchange", () => {
if (typeof audioCtx.sinkId === "object" && audioCtx.sinkId.type === "none") {
console.log("Audio changed to not play on any device");
} else {
console.log(`Audio output device changed to ${audioCtx.sinkId}`);
}
});See our SetSinkId test example for working code (also check out the source code).
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Change the destination output device in Web Audio
- {{domxref("AudioContext.setSinkId()")}}
- {{domxref("AudioContext.sinkId")}}