startCapture

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

options

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