Package org.webrtc.audio

Class WebRtcAudioRecord

java.lang.Object

org.webrtc.audio.WebRtcAudioRecord

public class WebRtcAudioRecord
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	AUDIO_RECORD_START
private static final int	AUDIO_RECORD_STOP
private static final long	AUDIO_RECORD_THREAD_JOIN_TIMEOUT_MS
private final int	audioFormat
private IAudioRecordListener	audioRecordListener
private final JavaAudioDeviceModule.SamplesReadyCallback	audioSamplesReadyCallback
private final int	audioSource
private static final int	BUFFER_SIZE_FACTOR
private static final int	BUFFERS_PER_SECOND
private ByteBuffer	byteBuffer
private static final int	CALLBACK_BUFFER_SIZE_MS
private static final int	CHECK_REC_STATUS_DELAY_MS
static final int	DEFAULT_AUDIO_FORMAT
static final int	DEFAULT_AUDIO_SOURCE
private byte[]	emptyBytes
private Map<String,ByteBuffer>	encodedByteBuffers
private final JavaAudioDeviceModule.AudioRecordErrorCallback	errorCallback
private final ScheduledExecutorService	executor
private ScheduledFuture<String>	future
private final boolean	isAcousticEchoCancelerSupported
private final boolean	isNoiseSuppressorSupported
private static org.slf4j.Logger	logger
private boolean	microphoneMute
private long	nativeAudioRecord
private final JavaAudioDeviceModule.AudioRecordStateCallback	stateCallback
private static final String	TAG

Constructor Summary

Constructors

Constructor	Description
WebRtcAudioRecord(Object context, Object audioManager)	Audio thread which keeps calling ByteBuffer.read() waiting for audio to be recorded.
WebRtcAudioRecord(Object context, ScheduledExecutorService scheduler, Object audioManager, int audioSource, int audioFormat, JavaAudioDeviceModule.AudioRecordErrorCallback errorCallback, JavaAudioDeviceModule.AudioRecordStateCallback stateCallback, JavaAudioDeviceModule.SamplesReadyCallback audioSamplesReadyCallback, boolean isAcousticEchoCancelerSupported, boolean isNoiseSuppressorSupported, IAudioRecordListener audioRecordListener)

Method Summary

Modifier and Type	Method	Description
private static void	assertTrue(boolean condition)
private static String	audioStateToString(int state)
private void	doAudioRecordStateCallback(int audioState)
private boolean	enableBuiltInAEC(boolean enable)
private boolean	enableBuiltInNS(boolean enable)
void	encodedDataIsReady(long nativeAudioRecordJni, String trackId, int bytes)
IAudioRecordListener	getAudioRecordListener()
Map<String,ByteBuffer>	getEncodedByteBuffers()
private int	initRecording(int sampleRate, int channels)
(package private) boolean	isAcousticEchoCancelerSupported()
(package private) boolean	isAudioConfigVerified()
(package private) boolean	isAudioSourceMatchingRecordingSession()
(package private) boolean	isNoiseSuppressorSupported()
private void	nativeCacheDirectBufferAddress(long nativeAudioRecordJni, ByteBuffer byteBuffer)
private void	nativeCacheDirectBufferAddressForEncodedAudio(long nativeAudioRecordJni, String trackId, ByteBuffer byteBuffer)
private void	nativeDataIsRecorded(long nativeAudioRecordJni, int bytes, long captureTimestampNs)
void	nativeEncodedDataIsReady(long nativeAudioRecordJni, String trackId, int bytes)
void	notifyEncodedData(String trackId, ByteBuffer audio)
private void	releaseAudioResources()
private void	reportWebRtcAudioRecordError(String errorMessage)
private void	reportWebRtcAudioRecordInitError(String errorMessage)
private void	reportWebRtcAudioRecordStartError(JavaAudioDeviceModule.AudioRecordStartErrorCode errorCode, String errorMessage)
void	setMicrophoneMute(boolean mute)
void	setNativeAudioRecord(long nativeAudioRecord)
private boolean	startRecording()
private boolean	stopRecording()
void	triggerAudioRecordStarted()	Prefer a specific AudioDeviceInfo device for recording.
void	triggerAudioRecordStopped()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

logger

private static org.slf4j.Logger logger

TAG

private static final String TAG

See Also:

• Constant Field Values

CALLBACK_BUFFER_SIZE_MS

private static final int CALLBACK_BUFFER_SIZE_MS

See Also:

• Constant Field Values

BUFFERS_PER_SECOND

private static final int BUFFERS_PER_SECOND

See Also:

• Constant Field Values

BUFFER_SIZE_FACTOR

private static final int BUFFER_SIZE_FACTOR

See Also:

• Constant Field Values

AUDIO_RECORD_THREAD_JOIN_TIMEOUT_MS

private static final long AUDIO_RECORD_THREAD_JOIN_TIMEOUT_MS

See Also:

• Constant Field Values

DEFAULT_AUDIO_SOURCE

public static final int DEFAULT_AUDIO_SOURCE

See Also:

• Constant Field Values

DEFAULT_AUDIO_FORMAT

public static final int DEFAULT_AUDIO_FORMAT

See Also:

• Constant Field Values

AUDIO_RECORD_START

private static final int AUDIO_RECORD_START

See Also:

• Constant Field Values

AUDIO_RECORD_STOP

private static final int AUDIO_RECORD_STOP

See Also:

• Constant Field Values

CHECK_REC_STATUS_DELAY_MS

private static final int CHECK_REC_STATUS_DELAY_MS

See Also:

• Constant Field Values

audioSource

private final int audioSource

audioFormat

private final int audioFormat

nativeAudioRecord

private long nativeAudioRecord

byteBuffer

@Nullable
private ByteBuffer byteBuffer

executor

private final ScheduledExecutorService executor

future

@Nullable
private ScheduledFuture<String> future

microphoneMute

private volatile boolean microphoneMute

emptyBytes

private byte[] emptyBytes

errorCallback

@Nullable
private final JavaAudioDeviceModule.AudioRecordErrorCallback errorCallback

stateCallback

@Nullable
private final JavaAudioDeviceModule.AudioRecordStateCallback stateCallback

audioSamplesReadyCallback

@Nullable
private final JavaAudioDeviceModule.SamplesReadyCallback audioSamplesReadyCallback

isAcousticEchoCancelerSupported

private final boolean isAcousticEchoCancelerSupported

isNoiseSuppressorSupported

private final boolean isNoiseSuppressorSupported

audioRecordListener

private IAudioRecordListener audioRecordListener

encodedByteBuffers

private Map<String,ByteBuffer> encodedByteBuffers

Constructor Details

WebRtcAudioRecord

WebRtcAudioRecord(Object context,
 Object audioManager)

Audio thread which keeps calling ByteBuffer.read() waiting for audio to be recorded. Feeds recorded data to the native counterpart as a periodic sequence of callbacks using DataIsRecorded(). This thread uses a Process.THREAD_PRIORITY_URGENT_AUDIO priority.

WebRtcAudioRecord

public WebRtcAudioRecord(Object context,
 ScheduledExecutorService scheduler,
 Object audioManager,
 int audioSource,
 int audioFormat,
 @Nullable
 JavaAudioDeviceModule.AudioRecordErrorCallback errorCallback,
 @Nullable
 JavaAudioDeviceModule.AudioRecordStateCallback stateCallback,
 @Nullable
 JavaAudioDeviceModule.SamplesReadyCallback audioSamplesReadyCallback,
 boolean isAcousticEchoCancelerSupported,
 boolean isNoiseSuppressorSupported,
 IAudioRecordListener audioRecordListener)

Method Details

setNativeAudioRecord

public void setNativeAudioRecord(long nativeAudioRecord)

isAcousticEchoCancelerSupported

boolean isAcousticEchoCancelerSupported()

isNoiseSuppressorSupported

boolean isNoiseSuppressorSupported()

isAudioConfigVerified

boolean isAudioConfigVerified()

isAudioSourceMatchingRecordingSession

boolean isAudioSourceMatchingRecordingSession()

enableBuiltInAEC

private boolean enableBuiltInAEC(boolean enable)

enableBuiltInNS

private boolean enableBuiltInNS(boolean enable)

initRecording

private int initRecording(int sampleRate,
 int channels)

triggerAudioRecordStarted

public void triggerAudioRecordStarted()

Prefer a specific AudioDeviceInfo device for recording. Calling after recording starts is valid but may cause a temporary interruption if the audio routing changes.

triggerAudioRecordStopped

public void triggerAudioRecordStopped()

getAudioRecordListener

public IAudioRecordListener getAudioRecordListener()

startRecording

private boolean startRecording()

stopRecording

private boolean stopRecording()

assertTrue

private static void assertTrue(boolean condition)

nativeCacheDirectBufferAddress

private void nativeCacheDirectBufferAddress(long nativeAudioRecordJni,
 ByteBuffer byteBuffer)

nativeDataIsRecorded

private void nativeDataIsRecorded(long nativeAudioRecordJni,
 int bytes,
 long captureTimestampNs)

nativeCacheDirectBufferAddressForEncodedAudio

private void nativeCacheDirectBufferAddressForEncodedAudio(long nativeAudioRecordJni,
 String trackId,
 ByteBuffer byteBuffer)

nativeEncodedDataIsReady

public void nativeEncodedDataIsReady(long nativeAudioRecordJni,
 String trackId,
 int bytes)

encodedDataIsReady

public void encodedDataIsReady(long nativeAudioRecordJni,
 String trackId,
 int bytes)

setMicrophoneMute

public void setMicrophoneMute(boolean mute)

releaseAudioResources

private void releaseAudioResources()

reportWebRtcAudioRecordInitError

private void reportWebRtcAudioRecordInitError(String errorMessage)

reportWebRtcAudioRecordStartError

private void reportWebRtcAudioRecordStartError(JavaAudioDeviceModule.AudioRecordStartErrorCode errorCode,
 String errorMessage)

reportWebRtcAudioRecordError

private void reportWebRtcAudioRecordError(String errorMessage)

doAudioRecordStateCallback

private void doAudioRecordStateCallback(int audioState)

audioStateToString

private static String audioStateToString(int state)

notifyEncodedData

public void notifyEncodedData(String trackId,
 ByteBuffer audio)

Parameters:

audio - => 20ms of encoded audio data

getEncodedByteBuffers

public Map<String,ByteBuffer> getEncodedByteBuffers()