Operations Summary: | |
void | audioReleased(in ResultEvent e) |
void | grammarFinalized(in ResultEvent e) |
void | resultAccepted(in ResultEvent e) |
void | resultCreated(in ResultEvent e) |
void | resultRejected(in ResultEvent e) |
void | resultUpdated(in ResultEvent e) |
void | trainingInfoReleased(in ResultEvent e) |
Operations Inherited from Bonobo::Unknown | |
ref, unref, queryInterface |
Operation Details: |
A AUDIO_RELEASED
event has occured. This event is
only issued to finalized results. See the documentation of the
isAudioAvailable
method the FinalResult
interface for details.
The event is issued to each ResultListener
attached
to the Recognizer
and to the Result
.
If a GRAMMAR_FINALIZED
event was issued, then the
matched Grammar
is known, and the event is also
issued to each ResultListener
attached to that
Grammar
.
Result
event. ResultEvent#AUDIO_RELEASED
FinalResult#isAudioAvailable
A GRAMMAR_FINALIZED
event has occured because the
Recognizer
has determined which Grammar
is matched by the incoming speech.
The event is issued to each ResultListener
attached
to the Recognizer
, Result
, and matched
Grammar
.
Result
event. ResultEvent#GRAMMAR_FINALIZED
An RESULT_ACCEPTED
event has occured indicating
that a Result
has transitioned from the
UNFINALIZED
state to the ACCEPTED
state.
Since the Result
source for this event is finalized,
the Result
object can be safely cast to the
FinalResult
interface.
Because the result is accepted, the matched Grammar
for the result is guaranteed to be non-null. If the matched
Grammar
is a RuleGrammar
, then the
result object can be safely cast to FinalRuleResult
(methods of FinalDictationResult
throw an exception).
If the matched Grammar
is a
DictationGrammar
, then the result object can be
safely cast to FinalDictationResult
(methods of
FinalRuleResult
throw an exception).
The event is issued to each ResultListener
attached
to the Recognizer
, Result
, and matched
Grammar
.
The RESULT_ACCEPTED
event is issued following the
RECOGNIZER_SUSPENDED
RecognizerEvent
and while the Recognizer
is in the
SUSPENDED
state. Once the RESULT_ACCEPTED
event has been processed by all listeners, the
Recognizer
automatically commits all changes to
grammars and returns to the LISTENING
state. The
only exception is when a call has been made to suspend
without a following call to commitChanges
. In this
case the Recognizer
remains SUSPENDED
until commitChanges
is called.
Result
event. ResultEvent#RESULT_ACCEPTED
FinalResult
FinalRuleResult
FinalDictationResult
RecognizerEvent
Recognizer#commitChanges
A RESULT_CREATED
event is issued when a
Recognizer
detects incoming speech that may match
an active grammar of an application.
The event is issued to each ResultListener
attached
to the Recognizer
. (ResultListeners
attached to a Grammar
or to a Result
never receive a RESULT_CREATED
event.)
The RESULT_CREATED
follows the
RECOGNIZER_PROCESSING
event that is issued
RecognizerListeners
to indicate that the
Recognizer
has changed from the
LISTENING
to the PROCESSING
state.
Result
event. ResultEvent#RESULT_CREATED
RecognizerEvent#RECOGNIZER_PROCESSING
An RESULT_REJECTED
event has occured indicating
that a Result
has transitioned from the
UNFINALIZED
state to the REJECTED
state.
The casting behavior of a rejected result is the same as for a
RESULT_ACCEPTED
event. The exception is that if
the grammar is not known (no GRAMMAR_FINALIZED
event),
then the result cannot be cast to either
FinalRuleResult
or FinalDictationResult
.
The state behavior and grammar committing actions are the same as
for the RESULT_ACCEPTED
event.
The event is issued to each ResultListener
attached
to the Recognizer
and to the Result
.
If a GRAMMAR_FINALIZED
event was issued, then the
matched Grammar
is known, and the event is also
issued to each ResultListener
attached to that
Grammar
.
Result
event. ResultEvent#RESULT_REJECTED
FinalResult
FinalRuleResult
FinalDictationResult
A RESULT_UPDATED
event has occured because a token
has been finalized and/or the unfinalized text of a result has
changed.
The event is issued to each ResultListener
attached
to the Recognizer
, to each ResultListener
attached to the Result
, and if the
GRAMMAR_FINALIZED
event has already been released
to each ResultListener
attached to the matched
Grammar
.
Result
event. ResultEvent#RESULT_UPDATED
A TRAINING_INFO_RELEASED
event has occured. This
event is only issued to finalized results. See the documentation
of the isTrainingInfoAvailable
method of the
FinalResult
interface for details.
The event is issued to each ResultListener
attached
to the Recognizer
and to the Result
.
If a GRAMMAR_FINALIZED
event was issued, then the
matched Grammar
is known, and the event is also
issued to each ResultListener
attached to that
Grammar
.
Result
event. ResultEvent#TRAINING_INFO_RELEASED
FinalResult#isTrainingInfoAvailable