io.spokestack.spokestack.android

Class MicrophoneInput

java.lang.Object

io.spokestack.spokestack.android.MicrophoneInput

All Implemented Interfaces:

SpeechInput, AutoCloseable

public final class MicrophoneInput
extends Object
implements SpeechInput

android microphone speech input.

This class wraps the android AudioRecord class for reading audio samples from the microphone. It is assumed that the application has been manifested for microphone input (android.permission.RECORD_AUDIO), and that it has asked the user for microphone permissions via android.support.v4.app.ActivityCompat.requestPermissions.

This class uses the configured sample rate and always reads single-chanel 16-bit PCM samples.

Constructor Summary

Constructors

Constructor and Description
MicrophoneInput(android.media.AudioRecord audioRecord) initializes a new microphone instance with an existing audio recorder; useful for testing/mocking.
MicrophoneInput(SpeechConfig config) initializes a new microphone instance and opens the audio recorder.

Method Summary

Modifier and Type	Method and Description
void	close() releases the resources associated with the microphone.
void	read(SpeechContext context, ByteBuffer frame) reads a frame from the microphone.

Methods inherited from class java.lang.Object

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

Constructor Detail

MicrophoneInput

public MicrophoneInput(SpeechConfig config)

initializes a new microphone instance and opens the audio recorder.

Parameters:

config - speech pipeline configuration

MicrophoneInput

public MicrophoneInput(android.media.AudioRecord audioRecord)

initializes a new microphone instance with an existing audio recorder; useful for testing/mocking.

Parameters:

audioRecord - android audio recorder instance to attach

Method Detail

close

public void close()

releases the resources associated with the microphone.

Specified by:

close in interface AutoCloseable

read

public void read(SpeechContext context,
                 ByteBuffer frame)
          throws AudioRecordError

reads a frame from the microphone.

Specified by:

read in interface SpeechInput

Parameters:

context - the current speech context

frame - the frame buffer to fill

Throws:

AudioRecordError - if audio cannot be read