通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Recognizer Class

Package:
com.microsoft.cognitiveservices.speech
Maven Artifact:
com.microsoft.cognitiveservices.speech:client-sdk:1.44.0
  • java.lang.Object
    • com.microsoft.cognitiveservices.speech.Recognizer

Implements

java.lang.AutoCloseable

public class Recognizer
implements java.lang.AutoCloseable

Defines the base class Recognizer which mainly contains common event handlers. Note: close() must be called in order to release underlying resources held by the object.

Field Summary

Modifier and Type Field and Description
protected static final java.lang.String AUTH_TOKEN_ERROR_PROPERTY

Property name for the last authentication token error.
protected static final java.lang.String AUTH_TOKEN_EXPIRY_PROPERTY

Property name for the token expiration time in milliseconds.
protected static final java.lang.String AUTH_TOKEN_REFRESH_INTERVAL_MS_PROPERTY

Property name for the token refresh interval in milliseconds.
protected boolean disposed

Internal flag to indicate whether the object has been disposed.
protected java.util.concurrent.atomic.AtomicInteger eventCounter

Internal event counter to track event registration status.
final EventHandlerImpl<SessionEventArgs> sessionStarted

Defines event handler for session started event.
final EventHandlerImpl<SessionEventArgs> sessionStopped

Defines event handler for session stopped event.
final EventHandlerImpl<RecognitionEventArgs> speechEndDetected

Defines event handler for speech end detected event.
final EventHandlerImpl<RecognitionEventArgs> speechStartDetected

Defines event handler for speech start detected event.
protected final EventHandlerImpl<SessionEventArgs> tokenRequested

Defines event handler for token refresh event.

Constructor Summary

Modifier Constructor Description
protected Recognizer(AudioConfig audioInput, TokenCredential tokenCredential)

Creates and initializes an instance of a Recognizer

Method Summary

Modifier and Type Method and Description
protected final native long canceledSetCallback(long recoHandle)

Internal method to set canceled callback.
void close()

Dispose of associated resources.
protected void dispose(boolean disposing)

This method performs cleanup of resources.
protected void doAsyncRecognitionAction(Runnable recoImplAction)

Internal method to run recognition operation.
SafeHandle getImpl()

Returns the internal recognizer instance
protected final native long getPropertyBagFromRecognizerHandle(SafeHandle recoHandle, IntRef propertyHandle)

Internal method to get the property bag from the recognizer handle.
protected long recognize()

Internal method to start recognize once operation.
protected final native long recognizedSetCallback(long recoHandle)

Internal method to set recognized callback.
protected final native long recognizingSetCallback(long recoHandle)

Internal method to set recognizing callback.
protected void sessionStartedEventCallback(long eventArgs)

Internal method to handle native session started event.
protected final native long sessionStartedSetCallback(long recoHandle)

Internal method to set session started callback.
protected void sessionStoppedEventCallback(long eventArgs)

Internal method to handle native session stopped event.
protected final native long sessionStoppedSetCallback(long recoHandle)

Internal method to set session stopped callback.
protected void setUpTokenRefreshCallback(PropertyCollection property)

Sets up a callback for the token refresh event.
protected void speechEndDetectedEventCallback(long eventArgs)

Internal method to handle native speech end detected event.
protected final native long speechEndDetectedSetCallback(long recoHandle)

Internal method to set speech end detected callback.
protected void speechStartDetectedEventCallback(long eventArgs)

Internal method to handle native speech start detected event.
protected final native long speechStartDetectedSetCallback(long recoHandle)

Internal method to set speech start detected callback.
protected final native long startContinuousRecognition(SafeHandle recoHandle)

Internal method to start continuous recognition operation.
protected final native long startKeywordRecognition(SafeHandle recoHandle, SafeHandle keywordModelHandle)

Internal method to start keyword recognition operation.
protected final native long stopContinuousRecognition(SafeHandle recoHandle)

Internal method to stop continuous recognition operation.
protected final native long stopKeywordRecognition(SafeHandle recoHandle)

Internal method to stop keyword recognition operation.
protected void tokenRefreshEventCallback(long eventArgs)

Internal method to handle native token refresh event.
protected final native long tokenRefreshSetCallback(long recoHandle)

Internal method to set token refresh callback.
protected void updateAuthToken(PropertyCollection property)

Updates the authentication token in the given PropertyCollection.

Methods inherited from java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Field Details

AUTH_TOKEN_ERROR_PROPERTY

protected static final String AUTH_TOKEN_ERROR_PROPERTY

Property name for the last authentication token error.

AUTH_TOKEN_EXPIRY_PROPERTY

protected static final String AUTH_TOKEN_EXPIRY_PROPERTY

Property name for the token expiration time in milliseconds.

AUTH_TOKEN_REFRESH_INTERVAL_MS_PROPERTY

protected static final String AUTH_TOKEN_REFRESH_INTERVAL_MS_PROPERTY

Property name for the token refresh interval in milliseconds.

disposed

protected boolean disposed

Internal flag to indicate whether the object has been disposed.

eventCounter

protected AtomicInteger eventCounter

Internal event counter to track event registration status.

sessionStarted

public final EventHandlerImpl sessionStarted

Defines event handler for session started event.

sessionStopped

public final EventHandlerImpl sessionStopped

Defines event handler for session stopped event.

speechEndDetected

public final EventHandlerImpl speechEndDetected

Defines event handler for speech end detected event.

speechStartDetected

public final EventHandlerImpl speechStartDetected

Defines event handler for speech start detected event.

tokenRequested

protected final EventHandlerImpl tokenRequested

Defines event handler for token refresh event.

Constructor Details

Recognizer

protected Recognizer(AudioConfig audioInput, TokenCredential tokenCredential)

Creates and initializes an instance of a Recognizer

Parameters:

audioInput - An optional audio input configuration associated with the recognizer
tokenCredential - An optional audio input configuration associated with the recognizer

Method Details

canceledSetCallback

protected final native long canceledSetCallback(long recoHandle)

Internal method to set canceled callback.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

close

public void close()

Dispose of associated resources. Note: close() must be called in order to release underlying resources held by the object.

dispose

protected void dispose(boolean disposing)

This method performs cleanup of resources. The Boolean parameter disposing indicates whether the method is called from Dispose (if disposing is true) or from the finalizer (if disposing is false). Derived classes should override this method to dispose resource if needed.

Parameters:

disposing - Flag to request disposal.

doAsyncRecognitionAction

protected void doAsyncRecognitionAction(Runnable recoImplAction)

Internal method to run recognition operation.

Parameters:

recoImplAction - The runnable of the recognition operation.

getImpl

public SafeHandle getImpl()

Returns the internal recognizer instance

Returns:

The internal recognizer instance

getPropertyBagFromRecognizerHandle

protected final native long getPropertyBagFromRecognizerHandle(SafeHandle recoHandle, IntRef propertyHandle)

Internal method to get the property bag from the recognizer handle.

Parameters:

recoHandle - The native recognizer handle.
propertyHandle - The native property handle.

Returns:

The native result handle of the operation.

recognize

protected long recognize()

Internal method to start recognize once operation.

Returns:

The native result handle of the recognition.

recognizedSetCallback

protected final native long recognizedSetCallback(long recoHandle)

Internal method to set recognized callback.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

recognizingSetCallback

protected final native long recognizingSetCallback(long recoHandle)

Internal method to set recognizing callback.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

sessionStartedEventCallback

protected void sessionStartedEventCallback(long eventArgs)

Internal method to handle native session started event.

Parameters:

eventArgs - The native event args.

sessionStartedSetCallback

protected final native long sessionStartedSetCallback(long recoHandle)

Internal method to set session started callback.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

sessionStoppedEventCallback

protected void sessionStoppedEventCallback(long eventArgs)

Internal method to handle native session stopped event.

Parameters:

eventArgs - The native event args.

sessionStoppedSetCallback

protected final native long sessionStoppedSetCallback(long recoHandle)

Internal method to set session stopped callback.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

setUpTokenRefreshCallback

protected void setUpTokenRefreshCallback(PropertyCollection property)

Sets up a callback for the token refresh event.

Parameters:

property - The property collection.

speechEndDetectedEventCallback

protected void speechEndDetectedEventCallback(long eventArgs)

Internal method to handle native speech end detected event.

Parameters:

eventArgs - The native event args.

speechEndDetectedSetCallback

protected final native long speechEndDetectedSetCallback(long recoHandle)

Internal method to set speech end detected callback.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

speechStartDetectedEventCallback

protected void speechStartDetectedEventCallback(long eventArgs)

Internal method to handle native speech start detected event.

Parameters:

eventArgs - The native event args.

speechStartDetectedSetCallback

protected final native long speechStartDetectedSetCallback(long recoHandle)

Internal method to set speech start detected callback.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

startContinuousRecognition

protected final native long startContinuousRecognition(SafeHandle recoHandle)

Internal method to start continuous recognition operation.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

startKeywordRecognition

protected final native long startKeywordRecognition(SafeHandle recoHandle, SafeHandle keywordModelHandle)

Internal method to start keyword recognition operation.

Parameters:

recoHandle - The native recognizer handle.
keywordModelHandle - The native keyword model handle.

Returns:

The native result handle of the operation.

stopContinuousRecognition

protected final native long stopContinuousRecognition(SafeHandle recoHandle)

Internal method to stop continuous recognition operation.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

stopKeywordRecognition

protected final native long stopKeywordRecognition(SafeHandle recoHandle)

Internal method to stop keyword recognition operation.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

tokenRefreshEventCallback

protected void tokenRefreshEventCallback(long eventArgs)

Internal method to handle native token refresh event.

Parameters:

eventArgs - The native event args.

tokenRefreshSetCallback

protected final native long tokenRefreshSetCallback(long recoHandle)

Internal method to set token refresh callback.

Parameters:

recoHandle - The native recognizer handle.

Returns:

The native result handle of the operation.

updateAuthToken

protected void updateAuthToken(PropertyCollection property)

Updates the authentication token in the given PropertyCollection.

Parameters:

property

Applies to