RecognizedAudio.WriteToWaveStream Method
Writes audio to a stream in Wave format.
Namespace: Microsoft.Speech.Recognition
Assembly: Microsoft.Speech (in microsoft.speech.dll)
Syntax
'Declaration
Public Sub WriteToWaveStream ( _
outputStream As Stream _
)
public void WriteToWaveStream (
Stream outputStream
)
public:
void WriteToWaveStream (
Stream^ outputStream
)
public void WriteToWaveStream (
Stream outputStream
)
public function WriteToWaveStream (
outputStream : Stream
)
Parameters
- outputStream
Any valid System.IO.Stream object, to which an application wishes to write audio data in Wave format
Remarks
Audio data is written to outputStream with a prepended with a 16 byte header so that audio data is in Wave format.
The format of data written by WriteToWaveStream exclusive of the prepended Wave header is in the same format as that written by WriteToAudioStream.
Example
The example below show a testing routine that uses WriteToWaveStream, and WriteToAudioStream to write all the recognized audio to a stream, as well as GetRange to write selected portions of that audio to a stream.
Note
Because of the granularity of ticks and the non-zero size of the wave header, the size of a write to stream generated from a call such as GetRange
(new
TimeSpan
(0),
new
TimeSpan
(audio.Duration.Ticks
/
2)
may not be exactly half that of the write from calls such as WriteToWaveStream(waveStream)
or WriteToAudioStream(audioStream)
. The example below takes this into account.
public void AudioRangeTest (RecognitionResult recognitionResult)
{
RecognizedAudio audio = recognitionResult.Audio;
// Write to stream using WriteToAudioStream
MemoryStream audioStream = new MemoryStream ();
audio.WriteToAudioStream (audioStream);
audioStream.Flush ();
// Write to stream using WriteToWave
MemoryStream waveStream = new MemoryStream ();
audio.WriteToWaveStream (waveStream);
waveStream.Flush ();
//Now check that the WriteToWave write is slightly bigger than the
//WriteToAudioStream, due to Wave Formatting.
if (audioStream.Length != waveStream.Length - 16 ) ){
MessageBox.Show(String.Format("Error: length of stream write by WriteToWaveStream(waveStream) is not 16 bytes larger than that of GetRange(new TimeSpan (0), audio.Duration)"));
//Now do the same with GetRange
Stream rangeStreamFull = new MemoryStream ();
RecognizedAudio range = audio.GetRange (new TimeSpan (0), audio.Duration);
range.WriteToWaveStream (rangeStreamFull);
rangeStreamFull.Flush ();
rangeStreamFull.Close ();
if (rangeStreamFull.Length != audioStream.Length){
MessageBox.Show(String.Format("Error: length of stream write by WriteToAudioStream(waveStream) does not match that of GetRange(new TimeSpan (0), audio.Duration)"));
}
//Now we test retrieving the first half the audio
rangeStreamHalf = new MemoryStream ();
range = audio.GetRange (new TimeSpan (0),
new TimeSpan (audio.Duration.Ticks / 2));
range.WriteToWaveStream (rangeStreamHalf);
rangeStreamHalf.Flush ();
rangeStreamHalf.Close ();
if ( ! (rangeStreamHalf.Length >= waveStream.Length / 2 - 20
&& rangeStreamHalf.Length <= waveStream.Length / 2 + 50)){
MessageBox.Show(String.Format("Error: When retrieving the first half of audio, length of audio.GetRange (new TimeSpan (0), new TimeSpan (audio.Duration.Ticks / 2)) is not approximately half that of WriteToWaveStream(waveStream)."));
}
//Now we test retrieving the second half the audio
rangeStream = new MemoryStream ();
range = audio.GetRange (new TimeSpan (audio.Duration.Ticks / 2),
new TimeSpan (audio.Duration.Ticks / 2));
range.WriteToWaveStream (rangeStream);
rangeStream.Flush ();
rangeStream.Close ();
if ( ! (rangeStreamHalf.Length >= waveStream.Length / 2 - 20
&& rangeStreamHalf.Length <= waveStream.Length / 2 + 50)){
MessageBox.Show(String.Format("Error: When retrieving the first half of audio, length of audio.GetRange (new TimeSpan (0), new TimeSpan (audio.Duration.Ticks / 2)) is not approximately half that of WriteToWaveStream(waveStream)."));
}
}
Thread Safety
All public static (Shared in Visual Basic) members of this type are thread-safe. Instance members are not guaranteed to be thread-safe.
Platforms
Development Platforms
Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition
Target Platforms
See Also
Reference
RecognizedAudio Class
RecognizedAudio Members
Microsoft.Speech.Recognition Namespace
System.TimeSpan
RecognizedAudio Class
RecognizedAudio.WriteToAudioStream Method
RecognizedAudio.GetRange Method