Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



System Sounds Overview


Purpose

Provides a simple and consistent way for applications to produce sounds for common events such as messages and errors.

Sounds are specified logically, so that the actual corresponding physical sounds produced can vary with device configuration. Sounds can be file based (e.g. WAV), tones, or a fixed tone sequences.

[Top]


Architectural relationships

This API is a layer over the Media Server, which handles playing the audio.

[Top]


Description

The API has three key concepts: logical sound, sound player, and system sound information.


Logical sound

A sound to play is specified logically using two UIDs. The first specifies the category of the sound, such as rings, alarms, errors, and messages; the second, which is optional, specifies an instance of that category, such as new SMS arrived, or battery low.

The pair of UIDs is encapsulated in TBaSystemSoundType.


Sound player

The sound player plays the sound specified by a TBaSystemSoundType. 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. A default sound is used if no match at all is found.

The sound player class is CoeSoundPlayer.


System sound information

The characteristics of a physical sound that corresponds to a logical sound are encapsulated in a TBaSystemSoundInfo.

You can get and set the physical sound for a logical sound through BaSystemSound.

[Top]


See also

Using Multimedia Framework Client