Share via


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(newTimeSpan(0),newTimeSpan(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