ISpeechRecoResultDispatch Audio Method (SAPI 5.3)
Microsoft Speech API 5.3
Interface: ISpeechRecoResultDispatch
Audio Method
The Audio method creates an audio stream from the audio data in the result object.
The resulting stream can be used as input for SPVoice.SpeakStream. However, a single call to ISpeechRecoResultsDispatch.SpeakAudio performs the same action of speaking the recognized result
The audio portion of the recognition is not automatically available. By default, the recognition context does not retain audio. To retain it, call the RetainedAudio property and set it to SRAORetainAudio. While RetainedAudio can be toggled at anytime, audio for a specific phrase must be retained before recognition attempts begin. Therefore, RetainedAudio must be called before the phrase is spoken.
ISpeechRecoResultDispatch.Audio(
[StartElement As Long = 0],
[Elements As Long = -1]
) As ISpeechBaseStream
Parameters
- StartElement
[Optional] Specifies which element to use as a starting point. If omitted, zero is used and indicates the first alternate as the starting point. Because it is zero based, the second element would be one. - Elements
[Optional] Specifies the number of elements to retrieve. Default is -1 (that is, SPPR_ALL_ELEMENTS), which specifies all alternate elements are retrieved.
Return Value
The Audio method returns an ISpeechBaseStream object.
Remarks
Even if there are no elements, that is, StartElement = 0 and Elements = 0, the audio will still be played. Unrecognized results not having elements will still have audio.