Adding equalizer to the Symbian C++ audio player

Template:KBCS

Article Metadata

---

Tested with

Devices(s): Nokia N95

---

Compatibility

Platform(s): S60 3rd Edition

---

Article

Keywords: CAudioEqualizerUtility, TEfAudioEqualizerUtilityPreset

Created: User:Technical writer 1 (09 Oct 2008)

Last edited: hamishwillee (26 Jun 2011)

Overview

S60 has several audio enhancement APIs that can be used to modify the audio experience. One of them is the CAudioEqualizerUtility API.

This snippet can be self-signed.

Preconditions

The audio player must be fully constructed before constructing the instance of the API. This can be done with the following lines of code:

 iMdaAudioPlayerUtility = 
   CMdaAudioPlayerUtility::NewFilePlayerL(aFileName,
                                          *this,
                                          EMdaPriorityNormal,
                                          EMdaPriorityPreferenceTimeAndQuality);

MMP file

The following capabilities and libraries are required:

CAPABILITY NONE

LIBRARY AudioEqualizerUtility.lib

Header audioequalizerutility.h

Source file

First you need to construct the equalizer instance:

 iAudioEqualizerUtility =
   CAudioEqualizerUtility::NewL(*iMdaAudioPlayerUtility);

Use the following code to query equalizer presets:

 TArray<TEfAudioEqualizerUtilityPreset> allPresets = 
   iAudioEqualizerUtility->Presets();

Use the following code to apply an equalizer preset:

 iAudioEqualizerUtility->ApplyPresetL(preSetIndex);
 // where preSetIndex is 0 to (iAudioEqualizerUtility->Presets().Count() – 1)

Test application

File:PlayerExtrasExample.zip

See also

CS001130 - Adding doppler effects to the audio player

CS001131 - Adding source location effects to the audio player

CS001132 - Adding listener's location effects to the audio player

CS001133 - Adding bass boost to the audio player

CS001134 - Adding stereo widening to the audio player

CS001135 - Adding reverb to the audio player