web api interface
AudioSession
Limited availability
The AudioSession interface of the Audio Session API lets a web page declare the type of audio it is producing — for example music playback, a video call, or a short notification. The platform uses that declaration to decide how the page’s audio and audio from other applications and tabs should coexist — whether to pause, duck (lower the volume), or play in parallel.
Instance properties
typeExperimental- : A string representing the type of the audio session. Possible values include
"auto","playback","transient","transient-solo","ambient", and"play-and-record".
- : A string representing the type of the audio session. Possible values include
Examples
Setting the audio session type for a video conferencing app
The following example sets the audio session type to "play-and-record" for a video conferencing application. On supporting platforms, this signals that the page needs simultaneous playback and recording, which may cause the system to route audio through the correct output (for example, earpiece instead of speaker on mobile devices) and prevent other applications’ audio from interrupting the call.
navigator.audioSession.type = "play-and-record";
// Start playing remote media
remoteVideo.srcObject = remoteMediaStream;
remoteVideo.play();
// Start capturing local media
const stream = await navigator.mediaDevices.getUserMedia({
audio: true,
video: true,
});
localVideo.srcObject = stream;