Tizen Native API  3.0
Media Controller Client

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()), or the metadata(mc_client_set_metadata_update_cb()). to send the custom command(mc_client_send_custom_command()), to create/destroy the handle(mc_client_create()/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)
 Sets the callback for monitoring status of the media controller server.
int mc_client_unset_server_update_cb (mc_client_h client)
 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)
 Sets the callback for monitoring playback status of the media controller server.
int mc_client_unset_playback_update_cb (mc_client_h client)
 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)
 Sets the callback for monitoring metadata status of the media controller server.
int mc_client_unset_metadata_update_cb (mc_client_h client)
 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)
 Sets the callback for monitoring shuffle mode of the media controller server.
int mc_client_unset_shuffle_mode_update_cb (mc_client_h client)
 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)
 Sets the callback for monitoring repeat mode of the media controller server.
int mc_client_unset_repeat_mode_update_cb (mc_client_h client)
 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)
 Gets the metadata.
int mc_client_destroy_metadata (mc_metadata_h metadata)
 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 activated Server.
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.
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.
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)
 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)
 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 activated servers.
typedef void(* mc_command_reply_received_cb )(const char *server_name, int result_code, bundle *data, void *user_data)
 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 activated servers.

Since :
2.4
Remarks:
The callback is called in the dbus event loop.
Parameters:
[in]server_name,Theapp_id of the activated media controller server
[in]user_dataThe user data passed from the mc_client_foreach_server() fuction
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)

Called when receiving the command processing result from the server.

Since :
2.4
Remarks:
The callback is called in the dbus event loop.
Parameters:
[in]server_nameThe app_id of the updated media controller server
[in]result_codeThe result code of custom command
[in]dataThe extra data
[in]user_dataThe user data passed from the mc_client_send_custom_command() fuction
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 :
2.4
Remarks:
The callback is called in the dbus event loop.
Parameters:
[in]server_name,Theapp_id of the updated media controller server
[in]metadata,themetadata of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_metadata_update_cb() fuction
Precondition:
mc_client_set_metadata_update_cb()
See also:
mc_client_set_metadata_update_cb()
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 :
2.4
Remarks:
The callback is called in the dbus event loop.
Parameters:
[in]server_name,Theapp_id of the updated media controller server
[in]playback,Theplayback information of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_playback_update_cb() fuction
Precondition:
mc_client_set_playback_update_cb()
See also:
mc_client_set_playback_update_cb()
typedef void(* mc_repeat_mode_changed_cb)(const char *server_name, mc_repeat_mode_e mode, void *user_data)

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

Since :
2.4
Remarks:
The callback is called in the dbus event loop.
Parameters:
[in]server_name,Theapp_id of the updated media controller server
[in]mode,Therepeat mode of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_repeat_mode_update_cb() fuction
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 :
2.4
Remarks:
The callback is called in the dbus event loop.
Parameters:
[in]server_name,Theapp_id of the updated media controller server
[in]state,Thestate of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_server_update_cb() fuction
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)

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

Since :
2.4
Remarks:
The callback is called in the dbus event loop.
Parameters:
[in]server_name,Theapp_id of the updated media controller server
[in]mode,Theshuffle mode of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_shuffle_mode_update_cb() fuction
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 :
2.4
Remarks:
The callback is called in the dbus event loop.
Parameters:
[in]server_name,Theapp_id of the subscribed media controller server
[in]user_dataThe user data passed from the mc_client_foreach_server_subscribed() fuction
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 :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
You must release client using mc_client_destroy().
Parameters:
[out]clientThe handle to the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYNot enough memory is available
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
See also:
mc_client_destroy()
int mc_client_destroy ( mc_client_h  client)

Destroys client.

Since :
2.4
Parameters:
[in]clientThe handle to the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
METADATA_EXTRACTOR_ERROR_NONESuccessful
METADATA_EXTRACTOR_ERROR_INVALID_PARAMETERInvalid parameter
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()

Destroys metadata.

Since :
2.4
Parameters:
[in]metadataThe handle to metadata
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
Precondition:
Sets mc_client_set_metadata_update_cb() function to create metadata
See also:
mc_client_set_metadata_update_cb()

Destroys playback.

Since :
2.4
Parameters:
[in]playbackThe handle to playback
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
Precondition:
Sets mc_client_set_playback_update_cb() function to create playback
See also:
mc_client_set_playback_update_cb()
int mc_client_foreach_server ( mc_client_h  client,
mc_activated_server_cb  callback,
void *  user_data 
)

Retrieves all activated Server.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]callbackThe callback to be invoked when the list of the registered media controller server created completely.
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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 :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]subscription_typeThe subscription type
[in]callbackThe callback to be invoked when the list of the subscribed media controller server.
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
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 :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
If there is no activated media controller server, return value of the server name is NULL.
Parameters:
[in]clientThe handle to the media controller client
[out]server_nameThe app_id of the latest media controller server
[out]server_stateThe state of the latest media controller server
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
int mc_client_get_metadata ( mc_metadata_h  metadata,
mc_meta_e  attribute,
char **  value 
)

Gets the metadata.

Since :
2.4
Remarks:
You must release metadata using mc_client_destroy_metadata().
And also You must release value using free(). If the attribute value of the metadata is empty, return value is NULL.
Parameters:
[in]metadataThe handle to metadata
[in]attributeThe key attribute name to get
[out]valueThe value of the attribute
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid 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 :
2.4
Remarks:
You must release playback using mc_client_destroy_playback().
Parameters:
[in]playbackThe handle to playback
[out]positionThe position of the playback in milliseconds
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Sets mc_client_set_playback_update_cb() function to get the position
See also:
mc_client_set_playback_update_cb()

Gets the playback state.

Since :
2.4
Remarks:
You must release playback using mc_client_destroy_playback().
Parameters:
[in]playbackThe handle to playback
[out]stateThe state of the playback
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Sets mc_client_set_playback_update_cb() function to get the state
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 :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
You must release metadata using mc_client_destroy_metadata().
If there is no metadata, return value of the metadata is NULL.
Parameters:
[in]clientThe handle to the media controller client
[in]server_nameThe app_id of the server to requesting
[out]metadataThe handle to metadata
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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 :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
You must release playback using mc_client_destroy_playback().
If there is no playback info, return value of the playback is NULL.
Parameters:
[in]clientThe handle to the media controller client
[in]server_nameThe app_id of the server to requesting
[out]playbackThe handle to playback
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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 :
2.4
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]clientThe handle to the media controller client
[in]server_nameThe app_id of the server to requesting
[out]modeThe info of the latest shuffle mode
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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 :
2.4
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]clientThe handle to the media controller client
[in]server_nameThe app_id of the server to requesting
[out]modeThe info of the latest shuffle mode
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4

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

Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]server_nameThe app_id of the media controller server
[in]commandThe command to be sent
[in]dataThe extra data
[in]callbackThe callback to be invoked when the custom command execute completely.
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]server_nameThe app_id of the media controller server
[in]stateThe playback state command to send media controller server
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4

If media controller client call this function, basically the media controller client recieve the callback from all media controller servers.

Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]callbackThe callback to be invoked when the metadata status is changed
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4

If media controller client call this function, basically the media controller client recieve the callback from all media controller servers.

Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]callbackThe callback to be invoked when the playback status is changed
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4

If media controller client call this function, basically the media controller client recieve the callback from all media controller servers.

Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]callbackThe callback to be invoked when the repeat mode is changed
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4

If media controller client call this function, basically the media controller client recieve the callback from all media controller servers.

Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]callbackThe callback to be invoked when the media controller server status is changed
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4

If media controller client call this function, basically the media controller client recieve the callback from all media controller servers.

Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]callbackThe callback to be invoked when the shuffle mode is changed
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4

If media controller client subscribe media controller server,
the media controller client recieve callback from subscribed media controller server.
If media controller client subscribe media controller server one or more,
the media controller client can recieve 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.

Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]subscription_typeThe subscription type
[in]server_nameThe app_id of the media controller server
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
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()

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

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()

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

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()

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

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()

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

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()

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

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission 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.

Since :
2.4

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

Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to the media controller client
[in]subscription_typeThe subscription type
[in]server_nameThe app_id of the media controller server
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
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()