ai.olami.android

Class RecorderSpeechRecognizer

java.lang.Object

ai.olami.android.RecorderSpeechRecognizer

public class RecorderSpeechRecognizer
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RecorderSpeechRecognizer.Error Error type
static class	RecorderSpeechRecognizer.RecognizeState Recognize process state
static class	RecorderSpeechRecognizer.RecordState Recording state

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TAG

Method Summary

Modifier and Type	Method and Description
void	cancel() Cancel all processes and give up to get recognition result.
static RecorderSpeechRecognizer	create(IRecorderSpeechRecognizerListener listener, APIConfiguration config) Create a RecorderSpeechRecognizer instance.
static RecorderSpeechRecognizer	create(IRecorderSpeechRecognizerListener listener, SpeechRecognizer recognizer) Create a RecorderSpeechRecognizer instance by a specified speech recognizer.
void	enableSaveRecordToFile(boolean saveToFile, java.lang.String fileName) Enable/Disable to save the recorded audio to file.
RecorderSpeechRecognizer.RecognizeState	getRecognizeState() Get current recognize process state.
RecorderSpeechRecognizer.RecordState	getRecordState() Get current recording state.
void	release() Stop or cancel all processes and then release resources.
void	setEndUserIdentifier(java.lang.String cusId) Set the identification to identify the End-user.
void	setLengthOfVADEnd(int milliseconds) Set length of end time of the VAD in milliseconds to stop voice recording automatically.
void	setListener(IRecorderSpeechRecognizerListener listener) Set callback listener.
void	setRecognizer(SpeechRecognizer recognizer) Set speech recognizer.
void	setResultQueryFrequency(int milliseconds) Set the frequency in milliseconds of the recognition result query, then the recognizer client will query the result once every milliseconds you set.
void	setSpeechUploadLength(int milliseconds) Set audio length in milliseconds to upload, then the recognizer client will upload parts of audio once every milliseconds you set.
void	setTimeout(int milliseconds) Set timeout in milliseconds of each HTTP API request.
void	start() Enable microphone then start the voice recording and the recognize processing.
void	stop() Stop the voice recorder and wait for the final recognition result.

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

Method Detail

create

public static RecorderSpeechRecognizer create(IRecorderSpeechRecognizerListener listener,
                                              APIConfiguration config)

Create a RecorderSpeechRecognizer instance.

Parameters:

listener - - The specified callback listener.

config - - API configurations.

Returns:

RecorderSpeechRecognizer instance.

create

public static RecorderSpeechRecognizer create(IRecorderSpeechRecognizerListener listener,
                                              SpeechRecognizer recognizer)

Create a RecorderSpeechRecognizer instance by a specified speech recognizer.

Parameters:

listener - - The specified callback listener.

recognizer - - Configured speech recognizer.

Returns:

RecorderSpeechRecognizer instance.

setListener

public void setListener(IRecorderSpeechRecognizerListener listener)

Set callback listener.

Parameters:

listener - The specified callback listener.

setRecognizer

public void setRecognizer(SpeechRecognizer recognizer)

Set speech recognizer.

Parameters:

recognizer - - Configured speech recognizer.

setEndUserIdentifier

public void setEndUserIdentifier(java.lang.String cusId)

Set the identification to identify the End-user. This is helpful in some of NLU/NLI functions, such as context support.

Parameters:

cusId - - End-user identifier.

setTimeout

public void setTimeout(int milliseconds)

Set timeout in milliseconds of each HTTP API request. Note that each process may contain more than one request.

Parameters:

milliseconds - - Timeout in milliseconds.

setLengthOfVADEnd

public void setLengthOfVADEnd(int milliseconds)

Set length of end time of the VAD in milliseconds to stop voice recording automatically.

Parameters:

milliseconds - - length of end time in milliseconds for the speech input idle.

setSpeechUploadLength

public void setSpeechUploadLength(int milliseconds)

Set audio length in milliseconds to upload, then the recognizer client will upload parts of audio once every milliseconds you set.

Parameters:

milliseconds - - How long of the audio in milliseconds do you want to upload once.

setResultQueryFrequency

public void setResultQueryFrequency(int milliseconds)

Set the frequency in milliseconds of the recognition result query, then the recognizer client will query the result once every milliseconds you set.

Parameters:

milliseconds - - How long in milliseconds do you want to query once.

getRecordState

public RecorderSpeechRecognizer.RecordState getRecordState()

Get current recording state.

Returns:

- Recording state.

getRecognizeState

public RecorderSpeechRecognizer.RecognizeState getRecognizeState()

Get current recognize process state.

Returns:

- Recognize process state.

start

public void start()
           throws java.lang.InterruptedException,
                  java.lang.IllegalStateException

Enable microphone then start the voice recording and the recognize processing.

Throws:

java.lang.InterruptedException - There is something wrong.

java.lang.IllegalStateException - You are using this method in a wrong operation state.

stop

public void stop()

Stop the voice recorder and wait for the final recognition result.

cancel

public void cancel()

Cancel all processes and give up to get recognition result.

release

public void release()

Stop or cancel all processes and then release resources. This will not make any callback even if you use him to terminate any process.

enableSaveRecordToFile

public void enableSaveRecordToFile(boolean saveToFile,
                                   java.lang.String fileName)

Enable/Disable to save the recorded audio to file.

Parameters:

saveToFile - - Set TRUE to enable, set FALSE to disable.

fileName - - Name of the file you want to store the audio.