livekit-android-sdk/io.livekit.android.audio/ScreenAudioCapturer

ScreenAudioCapturer

class ScreenAudioCapturer @RequiresPermission(value = "android.permission.RECORD_AUDIO") constructor(mediaProjection: MediaProjection, captureConfigurator: AudioPlaybackCaptureConfigurator = DEFAULT_CONFIGURATOR) : MixerAudioBufferCallback

A mixer for capturing screen share audio.

Requires a media projection, which can be obtained from the screen share track.

Additionally, for screen capture to work properly while your app is in the background, a foreground service with the type microphone must be running. Otherwise, audio capture will not return any audio data.

Example usage:

Constructors

ScreenAudioCapturer

@RequiresPermission(value = "android.permission.RECORD_AUDIO")

constructor(mediaProjection: MediaProjection, captureConfigurator: AudioPlaybackCaptureConfigurator = DEFAULT_CONFIGURATOR)

Types

Companion

object Companion

Properties

gain

var gain: Float

A multiplier to adjust the volume of the captured audio data.

Functions

initAudioRecord

fun initAudioRecord(audioFormat: Int, channelCount: Int, sampleRate: Int): Boolean

onBuffer

override fun onBuffer(buffer: ByteBuffer, audioFormat: Int, channelCount: Int, sampleRate: Int, bytesRead: Int, captureTimeNs: Long): Long

Called when new audio samples are ready.

onBufferRequest

open override fun onBufferRequest(originalBuffer: ByteBuffer, audioFormat: Int, channelCount: Int, sampleRate: Int, bytesRead: Int, captureTimeNs: Long): MixerAudioBufferCallback.BufferResponse?

releaseAudioResources

fun releaseAudioResources()

Release any audio resources associated with this capturer. This is not managed by LiveKit, so you must call this function when finished to prevent memory leaks.