Categories: Symbian C++ | Code Examples | Multimedia | Audio

From Forum Nokia Wiki

Knowledge Base Home

Overview

The S60 platform has several audio enhancement APIs that can be used to modify the audio experience. One of them is the CListenerLocation API. This API makes the listener's location for the audio source appear to change.

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 ListenerLocationEffect.lib

HEADER ListenerLocationBase.h

Source file

First you need to construct the reverb utility instance:

iListener = CListenerLocation::NewL( *iMdaAudioPlayerUtility );

To set the listener's location effect on, you need to set the X,Y, and Z coordinates for the listener, and then enable and apply the effect on the player.

iListener->SetLocationCartesianL( iPositionX, iPositionY, iPositionZ );
  
 if(!iListener->IsEnabled())
          iListener->EnableL(); 
  
  iListener->ApplyL();

You can also add a 3D effect by having a timer that periodically changes the coordinates of the effect.

To set the listeners location effect off, just call the following line of code:

iListener->DisableL();

Test application

Image:3D AudioEfects.zip

See also

CS001130 - Adding doppler effects to the audio player

CS001131 - Adding source 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

CS001136 - Adding equalizer to the audio player