The Media Controller Client API provides functions for requesting the information to the server.

Required Header

#include <media_controller_client.h>

Overview

The Media Controller Client API allows you to check the activated server status (mc_client_set_server_update_cb()), the playback info (mc_client_set_playback_update_cb()), the metadata (mc_client_set_metadata_update_cb())).
And client can send the custom command to server(mc_client_send_custom_command()).
Before doing those things you should create handle(mc_client_create()). And if you don't use handle anymore, you have to destroy it(mc_client_destroy()). If there is no the activated server, you can get the latest server information by using mc_client_get_latest_server_info().

Functions
int	mc_client_create (mc_client_h *client)
	Creates a media controller client.
int	mc_client_set_server_update_cb (mc_client_h client, mc_server_state_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API
	Sets the callback for monitoring status of the media controller server.
int	mc_client_unset_server_update_cb (mc_client_h client) TIZEN_DEPRECATED_API
	Unsets the callback for monitoring status of the media controller server.
int	mc_client_set_playback_update_cb (mc_client_h client, mc_playback_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API
	Sets the callback for monitoring playback status of the media controller server.
int	mc_client_unset_playback_update_cb (mc_client_h client) TIZEN_DEPRECATED_API
	Unsets the callback for monitoring playback status of the media controller server.
int	mc_client_set_metadata_update_cb (mc_client_h client, mc_metadata_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API
	Sets the callback for monitoring metadata status of the media controller server.
int	mc_client_unset_metadata_update_cb (mc_client_h client) TIZEN_DEPRECATED_API
	Unsets the callback for monitoring metadata status of the media controller server.
int	mc_client_set_shuffle_mode_update_cb (mc_client_h client, mc_shuffle_mode_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API
	Sets the callback for monitoring shuffle mode of the media controller server.
int	mc_client_unset_shuffle_mode_update_cb (mc_client_h client) TIZEN_DEPRECATED_API
	Unsets the callback for monitoring shuffle mode of the media controller server.
int	mc_client_set_repeat_mode_update_cb (mc_client_h client, mc_repeat_mode_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API
	Sets the callback for monitoring repeat mode of the media controller server.
int	mc_client_unset_repeat_mode_update_cb (mc_client_h client) TIZEN_DEPRECATED_API
	Unsets the callback for monitoring repeat mode of the media controller server.
int	mc_client_subscribe (mc_client_h client, mc_subscription_type_e subscription_type, const char *server_name)
	Subscribes media controller server for monitoring status.
int	mc_client_unsubscribe (mc_client_h client, mc_subscription_type_e subscription_type, const char *server_name)
	Unsubscribes media controller server for monitoring status.
int	mc_client_foreach_server_subscribed (mc_client_h client, mc_subscription_type_e subscription_type, mc_subscribed_server_cb callback, void *user_data)
	Retrieves all subscribed Server.
int	mc_client_get_playback_state (mc_playback_h playback, mc_playback_states_e *state)
	Gets the playback state.
int	mc_client_get_playback_position (mc_playback_h playback, unsigned long long *position)
	Gets the playback position.
int	mc_client_destroy_playback (mc_playback_h playback)
	Destroys playback.
int	mc_client_get_metadata (mc_metadata_h metadata, mc_meta_e attribute, char **value) TIZEN_DEPRECATED_API
	Gets the metadata.
int	mc_client_destroy_metadata (mc_metadata_h metadata) TIZEN_DEPRECATED_API
	Destroys metadata.
int	mc_client_get_latest_server_info (mc_client_h client, char *server_name, mc_server_state_e server_state)
	Gets the latest media controller server info.
int	mc_client_get_server_playback_info (mc_client_h client, const char server_name, mc_playback_h playback)
	Gets the latest playback info.
int	mc_client_get_server_metadata (mc_client_h client, const char server_name, mc_metadata_h metadata)
	Gets the latest metadata.
int	mc_client_get_server_shuffle_mode (mc_client_h client, const char server_name, mc_shuffle_mode_e mode)
	Gets the latest shuffle mode.
int	mc_client_get_server_repeat_mode (mc_client_h client, const char server_name, mc_repeat_mode_e mode)
	Gets the latest repeat mode.
int	mc_client_foreach_server (mc_client_h client, mc_activated_server_cb callback, void *user_data)
	Retrieves all created servers.
int	mc_client_send_playback_state_command (mc_client_h client, const char *server_name, mc_playback_states_e state) TIZEN_DEPRECATED_API
	Sends the playback state command to server.
int	mc_client_send_custom_command (mc_client_h client, const char server_name, const char command, bundle data, mc_command_reply_received_cb callback, void user_data) TIZEN_DEPRECATED_API
	Sends the custom command to server.
int	mc_client_destroy (mc_client_h client)
	Destroys client.
Typedefs
typedef void(*	mc_server_state_updated_cb )(const char server_name, mc_server_state_e state, void user_data)
	Called when updating status of the media controller server.
typedef void(*	mc_playback_updated_cb )(const char server_name, mc_playback_h playback, void user_data)
	Called when updating the playback information of the media controller server.
typedef void(*	mc_metadata_updated_cb )(const char server_name, mc_metadata_h metadata, void user_data)
	Called when updating the metadata of the media controller server.
typedef void(*	mc_shuffle_mode_changed_cb )(const char server_name, mc_shuffle_mode_e mode, void user_data) TIZEN_DEPRECATED_API
	Called when updating the shuffle mode of the media controller server.
typedef void(*	mc_repeat_mode_changed_cb )(const char server_name, mc_repeat_mode_e mode, void user_data) TIZEN_DEPRECATED_API
	Called when updating the repeat mode of the media controller server.
typedef bool(*	mc_activated_server_cb )(const char server_name, void user_data)
	Called when requesting the list of created servers.
typedef void(*	mc_command_reply_received_cb )(const char server_name, int result_code, bundle data, void *user_data) TIZEN_DEPRECATED_API
	Called when receiving the command processing result from the server.
typedef bool(*	mc_subscribed_server_cb )(const char server_name, void user_data)
	Called when requesting the list of subscribed servers.

Typedef Documentation

typedef bool(* mc_activated_server_cb)(const char *server_name, void *user_data)

Called when requesting the list of created servers.

Since :: 3.0

Remarks:: The callback is called in the main loop. The server_name should not be released by the application.
The server_name can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	server_name	The app_id of the created media controller server.
[in]	user_data	The user data passed from the mc_client_foreach_server() function

Returns:: true to continue with the next iteration of the loop, otherwise false to break out of the loop

Precondition:: mc_client_foreach_server()

See also:: mc_client_foreach_server()

typedef void(* mc_command_reply_received_cb)(const char *server_name, int result_code, bundle *data, void *user_data) TIZEN_DEPRECATED_API

Called when receiving the command processing result from the server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Remarks:: The callback is called in the dbus event loop. data should be released using bundle_free().

Parameters:

[in]	server_name	The app_id of the media controller server which sent the reply, It can be used only in the callback. To use outside, make a copy.
[in]	result_code	The result code of custom command
[in]	data	The extra data
[in]	user_data	The user data passed from the mc_client_send_custom_command() function

Precondition:: mc_client_send_custom_command()

See also:: mc_client_send_custom_command()

typedef void(* mc_metadata_updated_cb)(const char *server_name, mc_metadata_h metadata, void *user_data)

Called when updating the metadata of the media controller server.

Since :: 3.0

Remarks:: The callback is called in the dbus event loop. The server_name and metadata should not be released by the application.
The server_name can be used only in the callback. To use outside, make a copy. And metadata also can be used only in the callback.

Parameters:

[in]	server_name	The app_id of the media controller server which sent the notification.
[in]	metadata	the metadata of the updated media controller server.
[in]	user_data	The user data passed from the mc_client_set_metadata_update_cb() function

Precondition:: mc_client_set_metadata_update_cb()

See also:: mc_client_set_metadata_update_cb(); mc_client_get_metadata()

typedef void(* mc_playback_updated_cb)(const char *server_name, mc_playback_h playback, void *user_data)

Called when updating the playback information of the media controller server.

Since :: 3.0

Remarks:: The callback is called in the dbus event loop. The server_name and playback should not be released by the application.
The server_name can be used only in the callback. To use outside, make a copy. And playback also can be used only in the callback.

Parameters:

[in]	server_name	The app_id of the media controller server which sent the notification.
[in]	playback	The playback information of the updated media controller server.
[in]	user_data	The user data passed from the mc_client_set_playback_update_cb() function

Precondition:: mc_client_set_playback_update_cb()

See also:: mc_client_set_playback_update_cb(); mc_client_get_playback_state(); mc_client_get_playback_position()

typedef void(* mc_repeat_mode_changed_cb)(const char *server_name, mc_repeat_mode_e mode, void *user_data) TIZEN_DEPRECATED_API

Called when updating the repeat mode of the media controller server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Remarks:: The callback is called in the dbus event loop.

Parameters:

[in]	server_name	The app_id of the media controller server which sent the notification. It can be used only in the callback. To use outside, make a copy.
[in]	mode	The repeat mode of the updated media controller server
[in]	user_data	The user data passed from the mc_client_set_repeat_mode_update_cb() function

Precondition:: mc_client_set_repeat_mode_update_cb()

See also:: mc_client_set_repeat_mode_update_cb()

typedef void(* mc_server_state_updated_cb)(const char *server_name, mc_server_state_e state, void *user_data)

Called when updating status of the media controller server.

Since :: 3.0

Remarks:: The callback is called in the dbus event loop. The server_name should not be released by the application.
The server_name can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	server_name	The app_id of the media controller server which sent the notification.
[in]	state	The state of the updated media controller server
[in]	user_data	The user data passed from the mc_client_set_server_update_cb() function

Precondition:: mc_client_set_server_update_cb()

See also:: mc_client_set_server_update_cb()

typedef void(* mc_shuffle_mode_changed_cb)(const char *server_name, mc_shuffle_mode_e mode, void *user_data) TIZEN_DEPRECATED_API

Called when updating the shuffle mode of the media controller server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Remarks:: The callback is called in the dbus event loop.

Parameters:

[in]	server_name	The app_id of the media controller server which sent the notification. It can be used only in the callback. To use outside, make a copy.
[in]	mode	The shuffle mode of the updated media controller server
[in]	user_data	The user data passed from the mc_client_set_shuffle_mode_update_cb() function

Precondition:: mc_client_set_shuffle_mode_update_cb()

See also:: mc_client_set_shuffle_mode_update_cb()

typedef bool(* mc_subscribed_server_cb)(const char *server_name, void *user_data)

Called when requesting the list of subscribed servers.

Since :: 3.0

Remarks:: The callback is called in the dbus event loop. The server_name should not be released by the application.
The server_name can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	server_name	The app_id of the subscribed media controller server..
[in]	user_data	The user data passed from the mc_client_foreach_server_subscribed() function

Returns:: true to continue with the next iteration of the loop, otherwise false to break out of the loop

Precondition:: mc_client_foreach_server_subscribed()

See also:: mc_client_foreach_server_subscribed()

Function Documentation

int mc_client_create ( mc_client_h * client )

Creates a media controller client.

The media controller client binds the latest media controller server when handlers are created.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Remarks:: The client should be released using mc_client_destroy(). You can create only one client handle for each process.

Parameters:

[out] client The handle to the media controller client

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

See also:: mc_client_destroy()

int mc_client_destroy ( mc_client_h client )

Destroys client.

Since :: 3.0

Parameters:

[in] client The handle to the media controller client

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

Return values:

METADATA_EXTRACTOR_ERROR_NONE	Successful
METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create()

int mc_client_destroy_metadata ( mc_metadata_h metadata )

Destroys metadata.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Parameters:

[in] metadata The handle to metadata

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:: Sets mc_client_set_metadata_update_cb() function to create metadata

See also:: mc_client_set_metadata_update_cb()

int mc_client_destroy_playback ( mc_playback_h playback )

Destroys playback.

Since :: 3.0

Parameters:

[in] playback The handle to playback

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: mc_client_set_playback_update_cb(); mc_client_get_server_playback_info()

int mc_client_foreach_server	(	mc_client_h	client,
		mc_activated_server_cb	callback,
		void *	user_data
	)

Retrieves all created servers.

This function gets all created media controller servers. The callback function will be invoked for every created media controller server. If there are no media controller servers, the callback will not be invoked.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	callback	The callback function to be invoked, will be called for each server
[in]	user_data	The user data to be passed to the callback function

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create()

int mc_client_foreach_server_subscribed	(	mc_client_h	client,
		mc_subscription_type_e	subscription_type,
		mc_subscribed_server_cb	callback,
		void *	user_data
	)

Retrieves all subscribed Server.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	subscription_type	The subscription type
[in]	callback	The callback to be invoked when the list of the subscribed media controller server.
[in]	user_data	The user data to be passed to the callback function

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create(); Subscribe the media controller server for monitoring status by calling mc_client_subscribe()

See also:: mc_client_create(); mc_client_subscribe()

int mc_client_get_latest_server_info	(	mc_client_h	client,
		char **	server_name,
		mc_server_state_e *	server_state
	)

Gets the latest media controller server info.

The media controller client will get the most recently updated information by the server.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Remarks:: The server_name should be released using free().
If there is no activated media controller server, return value of the server name is NULL.
Before a media controller server sets the playback state to MC_PLAYBACK_STATE_PLAYING, the server_state is MC_SERVER_STATE_NONE. After a media controller server sets the playback state to MC_PLAYBACK_STATE_PLAYING, the server_state is MC_SERVER_STATE_ACTIVATE. After a media controller server is destroyed, server_state is MC_SERVER_STATE_DEACTIVATE.

Parameters:

[in]	client	The handle to the media controller client
[out]	server_name	The app_id of the latest media controller server
[out]	server_state	The state of the latest media controller server

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

int mc_client_get_metadata	(	mc_metadata_h	metadata,
		mc_meta_e	attribute,
		char **	value
	)

Gets the metadata.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Remarks:: The metadata should be released using mc_client_destroy_metadata().
And also The value should be released using free(). If the attribute value of the metadata is empty, return value is NULL.

Parameters:

[in]	metadata	The handle to metadata
[in]	attribute	The key attribute name to get
[out]	value	The value of the attribute

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:: Sets mc_client_set_metadata_update_cb() function to get the metadata

See also:: mc_client_set_metadata_update_cb()

int mc_client_get_playback_position	(	mc_playback_h	playback,
		unsigned long long *	position
	)

Gets the playback position.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	playback	The handle to playback
[out]	position	The position of the playback in milliseconds

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: The playback update callback should be set with mc_client_set_playback_update_cb().

See also:: mc_client_set_playback_update_cb()

int mc_client_get_playback_state	(	mc_playback_h	playback,
		mc_playback_states_e *	state
	)

Gets the playback state.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	playback	The handle to playback
[out]	state	The state of the playback

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: The playback update callback should be set with mc_client_set_playback_update_cb().

See also:: mc_client_set_playback_update_cb()

int mc_client_get_server_metadata	(	mc_client_h	client,
		const char *	server_name,
		mc_metadata_h *	metadata
	)

Gets the latest metadata.

The media controller client will get the most recently updated information from server_name.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Remarks:: The metadata should be released using \n If there is no metadata, return value of the metadata is NULL.

Parameters:

[in]	client	The handle to the media controller client
[in]	server_name	The app_id of the media controller server
[out]	metadata	The handle to metadata

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

int mc_client_get_server_playback_info	(	mc_client_h	client,
		const char *	server_name,
		mc_playback_h *	playback
	)

Gets the latest playback info.

The media controller client will get the most recently updated information from server_name.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Remarks:: The playback should be released using mc_client_destroy_playback().
If there is no playback info, return value of the playback is NULL.

Parameters:

[in]	client	The handle to the media controller client
[in]	server_name	The app_id of the media controller server
[out]	playback	The handle to playback

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

int mc_client_get_server_repeat_mode	(	mc_client_h	client,
		const char *	server_name,
		mc_repeat_mode_e *	mode
	)

Gets the latest repeat mode.

The media controller client will get the most recently updated information from server_name.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Remarks:: If there is no repeat mode info, return value is MC_REPEAT_MODE_OFF.

Parameters:

[in]	client	The handle to the media controller client
[in]	server_name	The app_id of the media controller server
[out]	mode	The info of the latest shuffle mode

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

int mc_client_get_server_shuffle_mode	(	mc_client_h	client,
		const char *	server_name,
		mc_shuffle_mode_e *	mode
	)

Gets the latest shuffle mode.

The media controller client will get the most recently updated information from server_name.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Remarks:: If there is no shuffle mode info, return value is MC_SHUFFLE_MODE_OFF.

Parameters:

[in]	client	The handle to the media controller client
[in]	server_name	The app_id of the media controller server
[out]	mode	The info of the latest shuffle mode

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

int mc_client_send_custom_command	(	mc_client_h	client,
		const char *	server_name,
		const char *	command,
		bundle *	data,
		mc_command_reply_received_cb	callback,
		void *	user_data
	)

Sends the custom command to server.

Deprecated:: Deprecated since 4.0.

If there is the result for command from server, the media controller client will get the result of the custom command by mc_command_reply_received_cb() callback.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	server_name	The app_id of the media controller server
[in]	command	The command to be sent
[in]	data	The extra data
[in]	callback	The callback to be invoked when the custom command execute completely.
[in]	user_data	The user data to be passed to the callback function

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create()

int mc_client_send_playback_state_command	(	mc_client_h	client,
		const char *	server_name,
		mc_playback_states_e	state
	)

Sends the playback state command to server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	server_name	The app_id of the media controller server
[in]	state	The playback state to send to media controller server

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_get_server_playback_info()

int mc_client_set_metadata_update_cb	(	mc_client_h	client,
		mc_metadata_updated_cb	callback,
		void *	user_data
	)

Sets the callback for monitoring metadata status of the media controller server.

Deprecated:: Deprecated since 4.0.

The media controller client which calls this function will receive notifications from all media controller servers.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	callback	The callback to be invoked when the metadata status is changed
[in]	user_data	The user data to be passed to the callback function

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_set_playback_update_cb	(	mc_client_h	client,
		mc_playback_updated_cb	callback,
		void *	user_data
	)

Sets the callback for monitoring playback status of the media controller server.

Deprecated:: Deprecated since 4.0.

The media controller client which calls this function will receive notifications from all media controller servers.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	callback	The callback to be invoked when the playback status is changed
[in]	user_data	The user data to be passed to the callback function

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_set_repeat_mode_update_cb	(	mc_client_h	client,
		mc_repeat_mode_changed_cb	callback,
		void *	user_data
	)

Sets the callback for monitoring repeat mode of the media controller server.

Deprecated:: Deprecated since 4.0.

The media controller client which calls this function will receive notifications from all media controller servers.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	callback	The callback to be invoked when the repeat mode is changed
[in]	user_data	The user data to be passed to the callback function

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_set_server_update_cb	(	mc_client_h	client,
		mc_server_state_updated_cb	callback,
		void *	user_data
	)

Sets the callback for monitoring status of the media controller server.

Deprecated:: Deprecated since 4.0.

The media controller client which calls this function will receive notifications from all media controller servers.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	callback	The callback to be invoked when the media controller server status is changed
[in]	user_data	The user data to be passed to the callback function

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_set_shuffle_mode_update_cb	(	mc_client_h	client,
		mc_shuffle_mode_changed_cb	callback,
		void *	user_data
	)

Sets the callback for monitoring shuffle mode of the media controller server.

Deprecated:: Deprecated since 4.0.

The media controller client which calls this function will receive notifications from all media controller servers.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	callback	The callback to be invoked when the shuffle mode is changed
[in]	user_data	The user data to be passed to the callback function

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_subscribe	(	mc_client_h	client,
		mc_subscription_type_e	subscription_type,
		const char *	server_name
	)

Subscribes media controller server for monitoring status.

If media controller client subscribe media controller server,
the media controller client receive callback from subscribed media controller server.
If media controller client subscribe media controller server one or more,
the media controller client can receive callback from only subscribed media controller server.
If you want to subscribe for the all media controller server again,
unset mode update callback and set the callback for the monitoring status again.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	subscription_type	The subscription type
[in]	server_name	The app_id of the media controller server

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create(); Set the callback for monitoring status of the media controller server

Postcondition:: Unsubscribe the media controller server for monitoring status by calling mc_client_unsubscribe()

See also:: mc_client_create(); mc_client_unsubscribe()

int mc_client_unset_metadata_update_cb ( mc_client_h client )

Unsets the callback for monitoring metadata status of the media controller server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in] client The handle to the media controller client

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_unset_playback_update_cb ( mc_client_h client )

Unsets the callback for monitoring playback status of the media controller server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in] client The handle to the media controller client

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_unset_repeat_mode_update_cb ( mc_client_h client )

Unsets the callback for monitoring repeat mode of the media controller server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in] client The handle to the media controller client

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_unset_server_update_cb ( mc_client_h client )

Unsets the callback for monitoring status of the media controller server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in] client The handle to the media controller client

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_unset_shuffle_mode_update_cb ( mc_client_h client )

Unsets the callback for monitoring shuffle mode of the media controller server.

Deprecated:: Deprecated since 4.0.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in] client The handle to the media controller client

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create().

See also:: mc_client_create(); mc_client_destroy()

int mc_client_unsubscribe	(	mc_client_h	client,
		mc_subscription_type_e	subscription_type,
		const char *	server_name
	)

Unsubscribes media controller server for monitoring status.

If media controller client unsubscribe media controller server,
the media controller client don't receive callback from unsubscribed media controller server.
If media controller client unsubscribe all subscribed media controller server,
the media controller client don't receive callback from all media controller server.
After unset and set update callback function is called again, the media controller client can receive callback from all media controller servers.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/mediacontroller.client

Parameters:

[in]	client	The handle to the media controller client
[in]	subscription_type	The subscription type
[in]	server_name	The app_id of the media controller server

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

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Create a media controller client handle by calling mc_client_create(); Subscribe the media controller server for monitoring status by calling mc_client_subscribe()

See also:: mc_client_create(); mc_client_subscribe()

Required Header

Overview

Functions

Typedefs

Typedef Documentation

Function Documentation