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(). To set the type of the currently playing sound forcibly, call sound_manager_set_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_set_current_sound_type (sound_type_e type) TIZEN_DEPRECATED_API
	Sets the type of the sound being currently played.
int	sound_manager_get_current_sound_type (sound_type_e *type)
	Gets the type of the sound being currently played.
int	sound_manager_unset_current_sound_type (void) TIZEN_DEPRECATED_API
	Unsets the type of the sound being currently played.
int	sound_manager_set_volume_changed_cb (sound_manager_volume_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API
	Registers a callback function to be invoked when the volume level is changed.
int	sound_manager_unset_volume_changed_cb (void) TIZEN_DEPRECATED_API
	Unregisters the volume change callback.
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.1

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_set_volume_changed_cb().

See also:: sound_manager_set_volume_changed_cb(); sound_manager_unset_volume_changed_cb()

Enumeration Type Documentation

enum sound_type_e

Enumeration for sound type.

Since :: 2.3.1

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 3.0)
SOUND_TYPE_MEDIA	Sound type for media
SOUND_TYPE_CALL	Sound type for call (Since 3.0)
SOUND_TYPE_VOIP	Sound type for voip (Since 3.0)
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.1

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.1

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.1

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_current_sound_type ( sound_type_e type )

Sets the type of the sound being currently played.

Deprecated:: Deprecated since 3.0.

Since :: 2.3.1

Parameters:

[in] type The sound type to 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_INTERNAL	Internal error inside the sound system

See also:: sound_manager_get_current_sound_type(); sound_manager_unset_current_sound_type()

int sound_manager_set_volume	(	sound_type_e	type,
		int	volume
	)

Sets the volume level specified for a particular sound type.

Since :: 2.3.1

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()

int sound_manager_set_volume_changed_cb	(	sound_manager_volume_changed_cb	callback,
		void *	user_data
	)

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

Deprecated:: Deprecated since 3.0. Use sound_manager_add_volume_changed_cb() instead.

Since :: 2.3.1

Parameters:

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

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_unset_volume_changed_cb(); sound_manager_volume_changed_cb()

int sound_manager_unset_current_sound_type ( void )

Unsets the type of the sound being currently played.

Deprecated:: Deprecated since 3.0.

Since :: 2.3.1

Returns:: 0 on success, otherwise a negative error value

Return values:

SOUND_MANAGER_ERROR_NONE	Success
SOUND_MANAGER_ERROR_INTERNAL	Internal error inside the sound system

See also:: sound_manager_set_current_sound_type(); sound_manager_get_current_sound_type()

int sound_manager_unset_volume_changed_cb ( void )

Unregisters the volume change callback.

Deprecated:: Deprecated since 3.0. Use sound_manager_remove_volume_changed_cb() instead.

Since :: 2.3.1

Returns:: 0 on success, otherwise a negative error value

Return values:

SOUND_MANAGER_ERROR_NONE	Success
SOUND_MANAGER_ERROR_INTERNAL	Internal error inside the sound system

See also:: sound_manager_set_volume_changed_cb()

Required Header

Overview

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation