CoeSoundPlayer Class Reference

#include <mw/coesndpy.h>

Link against: cone.lib

class CoeSoundPlayer
Public Member Enumerations
enumanonymous { ENoRepeat, ERepeatForever }
Public Member Functions
IMPORT_C voidCancelSound(const TBaSystemSoundType &)
voidPlaySound(const TBaSystemSoundType &)
voidPlaySound(const TBaSystemSoundType &, TInt, const TTimeIntervalMicroSeconds32 &)
voidPlaySoundNow(const TBaSystemSoundType &)
voidPlaySoundNow(const TBaSystemSoundType &, TInt, const TTimeIntervalMicroSeconds32 &)

Detailed Description

Utility class for simple sound playing.

Must be used in the same thread as an active UI Control Framework environment (CCoeEnv).

This class plays the sound specified by a TBaSystemSoundType object. The caller can request the sound to be repeated, and the time between repeats. If the exact sound cannot be found on a particular device, a match only by category (first UID) is used. No sound will play if a match is not found.

Member Enumeration Documentation

Enum anonymous

EnumeratorValueDescription
ENoRepeat1
ERepeatForeverKMaxTInt

Member Function Documentation

CancelSound ( const TBaSystemSoundType & )

IMPORT_C voidCancelSound(const TBaSystemSoundType &aType)[static]

Stops playing the specified sound.

ParameterDescription
aTypeThe sound to stop playing.

PlaySound ( const TBaSystemSoundType & )

voidPlaySound(const TBaSystemSoundType &aType)[static, inline]

Plays the specified sound.

This function only interrupts another, currently playing, sound if the new sound has a higher priority than the currently playing sound. If you wish to interrupt any currently playing sound and play a new one, use PlaySoundNow() instead of PlaySound().

ParameterDescription
aTypeThe sound to play.

PlaySound ( const TBaSystemSoundType &, TInt, const TTimeIntervalMicroSeconds32 & )

voidPlaySound(const TBaSystemSoundType &aType,
TIntaPlayCount,
const TTimeIntervalMicroSeconds32 &aGap
)[static, inline]

Plays the specified sound for the specifed number of times with the specified interval.

This function only interrupts another, currently playing, sound if the new sound has a higher priority than the current one. If you wish to interrupt any currently playing sound and play a new one, use PlaySoundNow() instead of PlaySound().

ParameterDescription
aTypeThe sound to play.
aPlayCountThe number of times the sound is played.
aGapThe interval in microseconds between each time the sound is played.

PlaySoundNow ( const TBaSystemSoundType & )

voidPlaySoundNow(const TBaSystemSoundType &aType)[static, inline]

Plays the specified sound, interrupting any other sound that is currently playing.

ParameterDescription
aTypeThe sound to play.

PlaySoundNow ( const TBaSystemSoundType &, TInt, const TTimeIntervalMicroSeconds32 & )

voidPlaySoundNow(const TBaSystemSoundType &aType,
TIntaPlayCount,
const TTimeIntervalMicroSeconds32 &aGap
)[static, inline]

Plays the specified sound the specifed number of times with the specified interval, interrupting any other sound that is currently playing.

ParameterDescription
aTypeThe sound to play.
aPlayCountThe number of times the sound is played.
aGapThe interval in microseconds between each time the sound is played.