Playing a Tone Sequence

This tutorial describes how to play a sequence of tones.

You have to configure DevSound for playing a tone sequence.

The following settings can be configured before or during tone play:

To change the volume of the audio device to a specific value, use the CMMFDevSound::SetVolume() function. The volume can be set to any value from 0 to CMMFDevSound::MaxVolume().

To define a period over which the volume rises from 0 to the normal volume level, use the CMMFDevSound::SetVolumeRamp() function.

Note: The CMMFDevSound::SetVolumeRamp() function is only available during tone play.
To set the speaker balance, use the CMMFDevSound::SetPlayBalanceL() function. This function has two parameters:
- aLeftPercentage - the left speaker volume percentage.
- aRightPercentage - the right speaker volume percentage.
To set the priority setting for this instance of DevSound to access the audio device, use the CMMFDevSound::SetPrioritySettings() method. Priority settings are used by the Audio Policy component to resolve multiple requests to access the audio hardware.

Call the CMMFDevSound::PlayToneSequenceL(const TDesC8 &) function to start playing a tone sequence. This method has one parameter, &aData, the tone sequence that is to be played.
Call the MDevSoundObserver::ToneFinished(TInt) function to complete successfully a tone sequence playing. If a tone sequence is not valid, MDevSoundObserver::ToneFinished(TInt) returns with an error of KErrCorrupt. Note: Further calls to CMMFDevSound::PlayToneSequenceL(const TDesC8 &) can be made both before and after the MDevSoundObserver::ToneFinished(TInt) callback is received.

Parent topic: Playing Tones

Related tasks

Pausing and Resuming a Tone