How to export a recorded sound |
|
After completing one or more recording sessions, the current recorded sound, or a defined range within the recorded sound, can be resampled and exported into a disk file; the first thing to decide is the format of the exported sound: for this purpose you need to set the EncodeFormats.ForExporting property to one of the available encoding formats.
Each encoding format set into the EncodeFormats.ForExporting property has its own settings which can be controlled through sub-properties of the EncodeFormats property: for example, if the chosen encoding format should be ENCODING_FORMAT_WAV you would have to modify settings of the EncodeFormats.WAV property, if chosen encoding format should be ENCODING_FORMAT_MP3 you would have to modify settings of the EncodeFormats.MP3 property and so on for the remaining accepted encoding formats.
At this point the recorded sound can be resampled and exported to a disk file calling the RecordedSound.RequestExportToFile method: depending upon the size of the loaded sound, the export session could result in a lengthy operation so it will be performed on a separate thread: during the export session, the container application will be notified about the exporting advancement through the CallbackForRecordersEvents delegate which is invoked with the nEvent parameter set to EV_REC_SOUND_EXPORT_PERC
The exporting session can be canceled through the RecordedSound.CancelExportToFile method.
During an exporting session in which the recorded sound is being down-mixed to lower frequencies (for example from 44100 Hz to 11025 Hz), the SetDownmixFilterQuality method allows applying an anti-aliasing filter to exported sounds, allowing better quality results.