ISpRecoResult
The ISpRecoResult interface is used by an application to retrieve information about the SR engine's hypotheses, recognitions, and false recognitions.
The most common use of the ISpRecoResult interface is retrieval of text recognized by the SR engine (see ISpPhrase::GetText). The ISpRecoResult interface also supports the retrieval of the original audio that the SR engine recognized. SAPI can automatically retain the audio for an application using ISpRecoContext::SetAudioOptions.
An application can set interest in SR engine hypotheses by calling ISpEventSource::SetInterest with SPEI_HYPOTHESIS. As each hypothesis event is received, the application can examine the proposed text and update its UI to display dynamic run-time recognition status.
An application can set interest in the SR engine's failed recognitions by calling ISpEventSource::SetInterest with SPEI_FALSE_RECOGNITION. If a false recognition occurs, the application can examine the audio (or even a partial recognition result) to reprocess the recognition or attempt to process the partially recognized text. SAPI does not require that an SR engine send a phrase with the false recognition event.
| ISpRecoResult Methods | Description |
|---|---|
| ISpPhrase | Inherits from ISpPhrase and those methods are accessible from an ISpRecoResult object. |
| GetResultTimes | Retrieves the time information associated with the result. |
| GetAlternates | Retrieves an array containing alternate phrases. |
| GetAudio | Creates an audio stream for a given number of elements. |
| SpeakAudio | Retrieves and speaks the specified audio. |
| Serialize | Creates a serialized copy of the recognition result object. |
| ScaleAudio | Converts the format of the retained audio to a different audio format. |
| GetRecoContext | Returns the recognition context object that is associated with this result. |