start Capture
Starts capturing the audio of the browser with the default options.
Return
the started capture session
Since
9.6.0
See also
Throws
when another capture session of this browser is active
when the browser is closed
Starts capturing the audio of the browser.
The session captures all audio the browser plays, including silence when nothing plays. Muting the browser with mute does not affect the captured audio. The captured audio is silent when Chromium runs with the --mute-audio switch.
While the session is active, Chromium treats the browser as visible, so the page is not throttled and its document.visibilityState is visible, and it keeps the display from going to sleep.
The buffers captured before an observer is registered are not delivered to it. To receive the audio from its beginning, register the observers on the returned session before the page starts playing.
A browser can have only one active capture session. Stop it before starting a new one.
Return
the started capture session
Since
9.6.0
Parameters
the options of the capture session
Throws
when the options are not supported
when another capture session of this browser is active
when the browser is closed