Volume

---

The Volume API provides functions to check and control volumes.

Required Header

#include <sound_manager.h>

Overview

The Sound Manager Volume API allows you to:

• check/control output volumes
• handle a volume changed notification

The Sound Manager has predefined types of sounds.(system, notification, alarm, ringtone, media, call, voip, voice).

Current volume level of each type can be checked with sound_manager_get_volume(). To get the maximum supported volume level of each type, call sound_manager_get_max_volume(). The volume level of each type can be adjusted with sound_manager_set_volume().

The type of currently playing sound may be obtained by calling sound_manager_get_current_sound_type().

Functions
int	sound_manager_get_max_volume (sound_type_e type, int *max)
	Gets the maximum volume level supported for a particular sound type.
int	sound_manager_set_volume (sound_type_e type, int volume)
	Sets the volume level specified for a particular sound type.
int	sound_manager_get_volume (sound_type_e type, int *volume)
	Gets the volume level specified for a particular sound type.
int	sound_manager_get_current_sound_type (sound_type_e *type)
	Gets the type of the sound being currently played.
int	sound_manager_add_volume_changed_cb (sound_manager_volume_changed_cb callback, void *user_data, int *id)
	Adds a callback function to be invoked when the volume level is changed.
int	sound_manager_remove_volume_changed_cb (int id)
	Removes the volume change callback.
Typedefs
typedef void(*	sound_manager_volume_changed_cb )(sound_type_e type, unsigned int volume, void *user_data)
	Called when the system volume has changed.

---

Typedef Documentation

typedef void(* sound_manager_volume_changed_cb)(sound_type_e type, unsigned int volume, void *user_data)

Called when the system volume has changed.

Since :

2.3

Parameters:

[in]	type	The sound type of the changed volume
[in]	volume	The new volume value
[in]	user_data	The user data passed from the callback registration function

Precondition:

sound_manager_set_volume() will invoke this callback if you register it using sound_manager_add_volume_changed_cb().

See also:

sound_manager_add_volume_changed_cb()

sound_manager_remove_volume_changed_cb()

---

Enumeration Type Documentation

enum sound_type_e

Enumeration for sound type.

Since :

2.3

Enumerator:

SOUND_TYPE_SYSTEM	Sound type for system
SOUND_TYPE_NOTIFICATION	Sound type for notifications
SOUND_TYPE_ALARM	Sound type for alarm
SOUND_TYPE_RINGTONE	Sound type for ringtones (Since 2.4)
SOUND_TYPE_MEDIA	Sound type for media
SOUND_TYPE_CALL	Sound type for call (Since 2.4)
SOUND_TYPE_VOIP	Sound type for voip (Since 2.4)
SOUND_TYPE_VOICE	Sound type for voice

---

Function Documentation

int sound_manager_add_volume_changed_cb	(	sound_manager_volume_changed_cb	callback,
		void *	user_data,
		int *	id
	)

Adds a callback function to be invoked when the volume level is changed.

Since :

3.0

Parameters:

[in]	callback	Callback function to indicate change in volume
[in]	user_data	The user data to be passed to the callback function
[out]	id	The callback id

Returns:

0 on success, otherwise a negative error value

Return values:

SOUND_MANAGER_ERROR_NONE	Success
SOUND_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
SOUND_MANAGER_ERROR_INTERNAL	Internal error inside the sound system

Postcondition:

sound_manager_volume_changed_cb() will be invoked.

See also:

sound_manager_remove_volume_changed_cb()

sound_manager_volume_changed_cb()

int sound_manager_get_current_sound_type

(

sound_type_e *

type

)

Gets the type of the sound being currently played.

Since :

2.3

Parameters:

[out]

type

The current sound type

Returns:

0 on success, otherwise a negative error value

Return values:

SOUND_MANAGER_ERROR_NONE	Success
SOUND_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
SOUND_MANAGER_ERROR_NO_PLAYING_SOUND	No playing sound
SOUND_MANAGER_ERROR_INTERNAL	Internal error inside the sound system

int sound_manager_get_max_volume	(	sound_type_e	type,
		int *	max
	)

Gets the maximum volume level supported for a particular sound type.

Since :

2.3

Parameters:

[in]	type	The sound type
[out]	max	The maximum volume level

Returns:

0 on success, otherwise a negative error value

Return values:

SOUND_MANAGER_ERROR_NONE	Success
SOUND_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

sound_manager_set_volume()

sound_manager_get_volume()

int sound_manager_get_volume	(	sound_type_e	type,
		int *	volume
	)

Gets the volume level specified for a particular sound type.

Since :

2.3

Parameters:

[in]	type	The sound type
[out]	volume	The current volume level

Returns:

0 on success, otherwise a negative error value

Return values:

SOUND_MANAGER_ERROR_NONE	Success
SOUND_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
SOUND_MANAGER_ERROR_INTERNAL	Internal error inside the sound system

See also:

sound_manager_get_max_volume()

sound_manager_set_volume()

int sound_manager_remove_volume_changed_cb

(

int

id

)

Removes the volume change callback.

Since :

3.0

Parameters:

[in]

id

The id of the callback to remove

Returns:

0 on success, otherwise a negative error value

Return values:

SOUND_MANAGER_ERROR_NONE	Success
SOUND_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
SOUND_MANAGER_ERROR_INTERNAL	Internal error inside the sound system

See also:

sound_manager_add_volume_changed_cb()

int sound_manager_set_volume	(	sound_type_e	type,
		int	volume
	)

Sets the volume level specified for a particular sound type.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/volume.set

Parameters:

[in]	type	The sound type
[in]	volume	The volume level to be set

Returns:

0 on success, otherwise a negative error value

Return values:

SOUND_MANAGER_ERROR_NONE	Success
SOUND_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
SOUND_MANAGER_ERROR_PERMISSION_DENIED	Permission denied
SOUND_MANAGER_ERROR_INTERNAL	Internal error inside the sound system

See also:

sound_manager_get_max_volume()

sound_manager_get_volume()