FMExChannelFMExChannel2D → FMExStream

FMExStream Class

Unlike the FMExAudioPlayer and FMExAudio decoupling, the FMExStream class acts both as an audio storage container and a playback mechanism. FMExAudio decodes and uncompresses audio in full, where as FMExStream stores audio data in its native file format. This is preferable for long-playing compressed formats such Ogg Vorbis, or MP3, or sequenced formats like MOD or MIDI. A two minute 44.1 kHz, 16 bit, stereo sample would use approximately 20MB of RAM as an FMExAudio instance, but can be streamed from a high-quality Ogg or MP3 format using less than 500 KB of RAM with the FMExStream class.

Important: Use the FolderItem.OpenAsFMExStream class extension or the FMEx.CreateStream method to create a new FMExStream instance. This class cannot be constructed using the New keyword.

Important: You must successfully initialize FMOD Ex via the FMEx.StartUp method before creating FMExStream objects. Also note that all existing FMExStream instances become invalidated after calling FMEx.ShutDown. Please see the Restarting FMOD Ex section for details on how to properly restart FMOD Ex should the need arise.

Note: The FMExStream class is ideal for long-format compressed audio such music or narration, but requires more CPU resources to decode data on-the-fly and has some playback limitations. The FMExAudio class is better suited for short audio samples which may playback multiple times simultaneously (game sound effects for example).

Properties

Expand All | Collapse All

Methods

Expand All | Collapse All