Tizen Native API  6.5
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_updated_cb()), the playback info (mc_client_set_playback_updated_cb()), the metadata (mc_client_set_metadata_updated_cb()) or the playlist(mc_client_set_playlist_updated_cb()).
And client can send the custom command to server(mc_client_send_custom_cmd()).
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_updated_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_updated_cb (mc_client_h client)
 Unsets the callback for monitoring status of the media controller server.
int mc_client_set_playback_updated_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_updated_cb (mc_client_h client)
 Unsets the callback for monitoring playback status of the media controller server.
int mc_client_set_metadata_updated_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_updated_cb (mc_client_h client)
 Unsets the callback for monitoring metadata status of the media controller server.
int mc_client_set_shuffle_mode_updated_cb (mc_client_h client, mc_shuffle_mode_updated_cb callback, void *user_data)
 Sets the callback for monitoring shuffle mode of the media controller server.
int mc_client_unset_shuffle_mode_updated_cb (mc_client_h client)
 Unsets the callback for monitoring shuffle mode of the media controller server.
int mc_client_set_repeat_mode_updated_cb (mc_client_h client, mc_repeat_mode_updated_cb callback, void *user_data)
 Sets the callback for monitoring repeat mode of the media controller server.
int mc_client_unset_repeat_mode_updated_cb (mc_client_h client)
 Unsets the callback for monitoring repeat mode of the media controller server.
int mc_client_set_playback_ability_updated_cb (mc_client_h client, mc_playback_ability_updated_cb callback, void *user_data)
 Sets the callback for monitoring the playback ability of the media controller server.
int mc_client_unset_playback_ability_updated_cb (mc_client_h client)
 Unsets the callback for monitoring the playback ability of the media controller server.
int mc_client_set_shuffle_ability_updated_cb (mc_client_h client, mc_shuffle_ability_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Sets the callback for monitoring the shuffle ability of the media controller server.
int mc_client_unset_shuffle_ability_updated_cb (mc_client_h client) TIZEN_DEPRECATED_API
 Unsets the callback for monitoring the shuffle ability of the media controller server.
int mc_client_set_repeat_ability_updated_cb (mc_client_h client, mc_repeat_ability_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Sets the callback for monitoring the repeat ability of the media controller server.
int mc_client_unset_repeat_ability_updated_cb (mc_client_h client) TIZEN_DEPRECATED_API
 Unsets the callback for monitoring the repeat ability of the media controller server.
int mc_client_set_ability_support_updated_cb (mc_client_h client, mc_ability_support_updated_cb callback, void *user_data)
 Sets the callback for monitoring the media controller server's support for an ability.
int mc_client_unset_ability_support_updated_cb (mc_client_h client)
 Unsets the callback for monitoring the media controller server's support for an ability.
int mc_client_set_display_mode_ability_updated_cb (mc_client_h client, mc_ability_supported_items_updated_cb callback, void *user_data)
 Sets the callback for monitoring the display mode ability of the media controller server.
int mc_client_unset_display_mode_ability_updated_cb (mc_client_h client)
 Unsets the callback for monitoring the display mode ability of the media controller server.
int mc_client_set_display_rotation_ability_updated_cb (mc_client_h client, mc_ability_supported_items_updated_cb callback, void *user_data)
 Sets the callback for monitoring the display rotation ability of the media controller server.
int mc_client_unset_display_rotation_ability_updated_cb (mc_client_h client)
 Unsets the callback for monitoring the display rotation ability of the media controller server.
int mc_client_set_cmd_reply_received_cb (mc_client_h client, mc_cmd_reply_received_cb callback, void *user_data)
 Sets the callback for receiving the result of the command from the media controller server.
int mc_client_unset_cmd_reply_received_cb (mc_client_h client)
 Unsets the callback for receiving common reply of the media controller server.
int mc_client_set_playlist_updated_cb (mc_client_h client, mc_playlist_updated_cb callback, void *user_data)
 Sets the callback for monitoring playlist status of the media controller server.
int mc_client_unset_playlist_updated_cb (mc_client_h client)
 Unsets the callback for monitoring playlist status of the media controller server.
int mc_client_set_subtitles_updated_cb (mc_client_h client, mc_bool_attribute_updated_cb callback, void *user_data)
 Sets the callback for monitoring the media controller server's subtitles display.
int mc_client_unset_subtitles_updated_cb (mc_client_h client)
 Unsets the callback for monitoring the media controller server's subtitles display.
int mc_client_set_360_mode_updated_cb (mc_client_h client, mc_bool_attribute_updated_cb callback, void *user_data)
 Sets the callback for monitoring the media controller server's 360 mode display.
int mc_client_unset_360_mode_updated_cb (mc_client_h client)
 Unsets the callback for monitoring the media controller server's 360 mode display.
int mc_client_set_display_mode_updated_cb (mc_client_h client, mc_display_mode_updated_cb callback, void *user_data)
 Sets the callback for monitoring the media controller server's display mode.
int mc_client_unset_display_mode_updated_cb (mc_client_h client)
 Unsets the callback for monitoring the media controller server's display mode.
int mc_client_set_display_rotation_updated_cb (mc_client_h client, mc_display_rotation_updated_cb callback, void *user_data)
 Sets the callback for monitoring the media controller server's display rotation.
int mc_client_unset_display_rotation_updated_cb (mc_client_h client)
 Unsets the callback for monitoring the media controller server's display rotation.
int mc_client_set_custom_event_received_cb (mc_client_h client, mc_client_custom_event_received_cb callback, void *user_data)
 Sets the callback for receiving the custom event from a media controller server.
int mc_client_unset_custom_event_received_cb (mc_client_h client)
 Unsets the callback for receiving the custom event from a media controller server.
int mc_client_send_event_reply (mc_client_h client, const char *server_name, const char *request_id, int result_code, bundle *data)
 Replies with the result of the requested event to 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_get_playlist_item_index (mc_playback_h playback, char **index) TIZEN_DEPRECATED_API
 Gets the index of the media in playlist.
int mc_client_get_playlist_item_info (mc_playback_h playback, char **playlist_name, char **index)
 Gets the playlist name and index of the media in playlist.
int mc_client_get_playback_content_type (mc_playback_h playback, mc_content_type_e *content_type)
 Gets the playback content type.
int mc_client_get_age_rating (mc_playback_h playback, mc_content_age_rating_e *age_rating)
 Gets the age rating of the content.
int mc_client_destroy_playback (mc_playback_h playback)
 Destroys playback.
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_get_server_icon (mc_client_h client, const char *server_name, char **uri)
 Gets the icon URI of the media controller server.
int mc_client_get_server_subtitles_enabled (mc_client_h client, const char *server_name, bool *enabled)
 Gets the latest subtitles display status.
int mc_client_get_server_360_mode_enabled (mc_client_h client, const char *server_name, bool *enabled)
 Gets the latest 360 mode display status.
int mc_client_get_server_display_mode (mc_client_h client, const char *server_name, mc_display_mode_e *mode)
 Gets the latest display mode.
int mc_client_get_server_display_rotation (mc_client_h client, const char *server_name, mc_display_rotation_e *rotation)
 Gets the latest display rotation.
int mc_client_get_server_playback_ability (mc_client_h client, const char *server_name, mc_playback_ability_h *ability)
 Gets the playback ability of the media controller server.
int mc_client_get_server_shuffle_ability_support (mc_client_h client, const char *server_name, mc_ability_support_e *support) TIZEN_DEPRECATED_API
 Gets the support value of the shuffle ability of the updated media controller server.
int mc_client_get_server_repeat_ability_support (mc_client_h client, const char *server_name, mc_ability_support_e *support) TIZEN_DEPRECATED_API
 Gets the support value of the repeat ability of the updated media controller server.
int mc_client_get_server_ability_support (mc_client_h client, const char *server_name, mc_ability_e ability, mc_ability_support_e *support)
 Gets the ability support of the media controller server.
int mc_client_get_server_display_mode_ability (mc_client_h client, const char *server_name, unsigned int *supported_modes)
 Gets the supported display mode of the updated media controller server.
int mc_client_get_server_display_rotation_ability (mc_client_h client, const char *server_name, unsigned int *supported_rotations)
 Gets the supported display rotation of the updated media controller server.
int mc_client_foreach_server (mc_client_h client, mc_activated_server_cb callback, void *user_data)
 Retrieves all created servers.
int mc_client_foreach_server_playlist (mc_client_h client, const char *server_name, mc_playlist_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Retrieves all playlists of the media controller server.
int mc_client_send_playback_action_cmd (mc_client_h client, const char *server_name, mc_playback_action_e action, char **request_id)
 Sends the playback action command to server.
int mc_client_send_playback_position_cmd (mc_client_h client, const char *server_name, unsigned long long position, char **request_id)
 Sends the playback position command to server.
int mc_client_send_shuffle_mode_cmd (mc_client_h client, const char *server_name, mc_shuffle_mode_e shuffle_mode, char **request_id)
 Sends the shuffle mode command to server.
int mc_client_send_repeat_mode_cmd (mc_client_h client, const char *server_name, mc_repeat_mode_e repeat_mode, char **request_id)
 Sends the repeat mode command to server.
int mc_client_send_playlist_cmd (mc_client_h client, const char *server_name, const char *playlist_name, const char *index, mc_playback_action_e action, unsigned long long position, char **request_id)
 Sends the playlist command to server.
int mc_client_send_custom_cmd (mc_client_h client, const char *server_name, const char *command, bundle *data, char **request_id)
 Sends the custom command to server.
int mc_client_send_search_cmd (mc_client_h client, const char *server_name, mc_search_h search, char **request_id)
 Sends the search command to server.
int mc_client_send_subtitles_cmd (mc_client_h client, const char *server_name, bool enable, char **request_id)
 Sends the subtitles command to server.
int mc_client_send_360_mode_cmd (mc_client_h client, const char *server_name, bool enable, char **request_id)
 Sends the 360 mode command to server.
int mc_client_send_display_mode_cmd (mc_client_h client, const char *server_name, mc_display_mode_e mode, char **request_id)
 Sends the display mode command to server.
int mc_client_send_display_rotation_cmd (mc_client_h client, const char *server_name, mc_display_rotation_e rotation, char **request_id)
 Sends the display rotation 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 the status of the media controller server is updated.
typedef void(* mc_playback_updated_cb )(const char *server_name, mc_playback_h playback, void *user_data)
 Called when the playback information of the media controller server is updated.
typedef void(* mc_metadata_updated_cb )(const char *server_name, mc_metadata_h metadata, void *user_data)
 Called when the metadata of the media controller server is updated.
typedef void(* mc_shuffle_mode_updated_cb )(const char *server_name, mc_shuffle_mode_e mode, void *user_data)
 Called when the shuffle mode of the media controller server is updated.
typedef void(* mc_repeat_mode_updated_cb )(const char *server_name, mc_repeat_mode_e mode, void *user_data)
 Called when the repeat mode of the media controller server is updated.
typedef void(* mc_playback_ability_updated_cb )(const char *server_name, mc_playback_ability_h ability, void *user_data)
 Called when the playback ability support of the media controller server is updated.
typedef void(* mc_shuffle_ability_updated_cb )(const char *server_name, mc_ability_support_e support, void *user_data) TIZEN_DEPRECATED_API
 Called when the shuffle ability support of the media controller server is updated.
typedef void(* mc_repeat_ability_updated_cb )(const char *server_name, mc_ability_support_e support, void *user_data) TIZEN_DEPRECATED_API
 Called when the repeat ability of the media controller server is updated.
typedef void(* mc_ability_support_updated_cb )(const char *server_name, mc_ability_e ability, mc_ability_support_e support, void *user_data)
 Called when a media controller server's support for an ability is updated.
typedef void(* mc_ability_supported_items_updated_cb )(const char *server_name, unsigned int supported_items, void *user_data)
 Called when a media controller server's supported items for an ability is updated.
typedef bool(* mc_activated_server_cb )(const char *server_name, void *user_data)
 Called when requesting the list of created servers.
typedef void(* mc_cmd_reply_received_cb )(const char *server_name, const char *request_id, int result_code, bundle *data, void *user_data)
 Called when the result of the command from the server is received.
typedef bool(* mc_subscribed_server_cb )(const char *server_name, void *user_data)
 Called when requesting the list of subscribed servers.
typedef void(* mc_playlist_updated_cb )(const char *server_name, mc_playlist_update_mode_e mode, const char *playlist_name, mc_playlist_h playlist, void *user_data)
 Called when the playlist of the media controller server is updated.
typedef void(* mc_client_custom_event_received_cb )(const char *server_name, const char *request_id, const char *event, bundle *data, void *user_data)
 Called when receiving custom event of media controller servers.
typedef void(* mc_bool_attribute_updated_cb )(const char *server_name, bool enabled, void *user_data)
 Called when the status of a media controller server's boolean attribute (subtitles or 360 mode) is updated.
typedef void(* mc_display_mode_updated_cb )(const char *server_name, mc_display_mode_e mode, void *user_data)
 Called when a media controller server's display mode is updated.
typedef void(* mc_display_rotation_updated_cb )(const char *server_name, mc_display_rotation_e rotation, void *user_data)
 Called when a media controller server's display rotation is updated.

Typedef Documentation

typedef void(* mc_ability_support_updated_cb)(const char *server_name, mc_ability_e ability, mc_ability_support_e support, void *user_data)

Called when a media controller server's support for an ability is updated.

Since :
5.5
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_nameThe app_id of the media controller server which sent the notification
[in]abilityThe ability
[in]supportThe support value of the ability of the updated media controller server
[in]user_dataThe user data passed from the callback function
See also:
mc_client_set_ability_support_updated_cb()
typedef void(* mc_ability_supported_items_updated_cb)(const char *server_name, unsigned int supported_items, void *user_data)

Called when a media controller server's supported items for an ability is updated.

Since :
5.5
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_nameThe app_id of the media controller server which sent the notification
[in]supported_itemsThe supported items of the updated media controller server
[in]user_dataThe user data passed from the callback function
See also:
mc_client_set_display_mode_ability_updated_cb()
mc_client_set_display_rotation_ability_updated_cb()
typedef bool(* mc_activated_server_cb)(const char *server_name, void *user_data)

Called when requesting the list of created servers.

Since :
2.4
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_nameThe app_id of the created media controller server
[in]user_dataThe 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_bool_attribute_updated_cb)(const char *server_name, bool enabled, void *user_data)

Called when the status of a media controller server's boolean attribute (subtitles or 360 mode) is updated.

Since :
5.5
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_nameThe app_id of the media controller server which sent the notification
[in]enabledThe new status of the attribute
[in]user_dataThe user data passed from the callback function
See also:
mc_client_set_subtitles_updated_cb()
mc_client_set_360_mode_updated_cb()
typedef void(* mc_client_custom_event_received_cb)(const char *server_name, const char *request_id, const char *event, bundle *data, void *user_data)

Called when receiving custom event of media controller servers.

Since :
4.0
Remarks:
The callback is called in the dbus event loop.
The data should be released using bundle_free().
The server_name, request_id and event should not be released by the application.
The server_name, request_id and event can be used only in the callback. To use outside, make a copy.
Parameters:
[in]server_nameThe app_id of the subscribed media controller server
[in]request_idThe id of the custom event request
[in]eventThe name of the custom event
[in]dataThe data can include other information associated with the event
[in]user_dataThe user data passed from the mc_client_set_custom_event_received_cb() function
Returns:
true to continue with the next iteration of the loop, otherwise false to break out of the loop
Precondition:
mc_client_set_custom_event_received_cb()
See also:
mc_client_set_custom_event_received_cb()
mc_client_unset_custom_event_received_cb()
typedef void(* mc_cmd_reply_received_cb)(const char *server_name, const char *request_id, int result_code, bundle *data, void *user_data)

Called when the result of the command from the server is received.

Since :
4.0
Remarks:
The callback is called in the dbus event loop.
data should be released using bundle_free().
The server_name and request_id should not be released by the application.
The server_name and request_id can be used only in the callback. To use outside, make a copy.
Parameters:
[in]server_nameThe app_id of the media controller server which sent the reply
[in]request_idThe id of the command request
[in]result_codeThe result code of the action, mc_result_code_e since 6.0
[in]dataThe extra data
[in]user_dataThe user data passed from the mc_client_set_cmd_reply_received_cb() function
Precondition:
mc_client_send_custom_cmd()
mc_client_set_cmd_reply_received_cb()
See also:
mc_client_send_custom_cmd()
typedef void(* mc_display_mode_updated_cb)(const char *server_name, mc_display_mode_e mode, void *user_data)

Called when a media controller server's display mode is updated.

Since :
5.5
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_nameThe app_id of the media controller server which sent the notification
[in]modeThe display mode
[in]user_dataThe user data passed from the callback function
See also:
mc_client_set_display_mode_updated_cb()
typedef void(* mc_display_rotation_updated_cb)(const char *server_name, mc_display_rotation_e rotation, void *user_data)

Called when a media controller server's display rotation is updated.

Since :
5.5
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_nameThe app_id of the media controller server which sent the notification
[in]rotationThe display rotation
[in]user_dataThe user data passed from the callback function
See also:
mc_client_set_display_rotation_updated_cb()
typedef void(* mc_metadata_updated_cb)(const char *server_name, mc_metadata_h metadata, void *user_data)

Called when the metadata of the media controller server is updated.

Since :
2.4
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. To use outside, make a copy using mc_metadata_clone().
Parameters:
[in]server_nameThe app_id of the media controller server which sent the notification
[in]metadataThe metadata of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_metadata_updated_cb() function
Precondition:
mc_client_set_metadata_updated_cb()
See also:
mc_client_set_metadata_updated_cb()
mc_metadata_get()
typedef void(* mc_playback_ability_updated_cb)(const char *server_name, mc_playback_ability_h ability, void *user_data)

Called when the playback ability support of the media controller server is updated.

Since :
5.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.
And ability also can be used only in the callback. To use outside, make a copy using mc_playback_ability_clone().
Parameters:
[in]server_nameThe app_id of the media controller server which sent the notification
[in]abilityThe ability of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_playback_ability_updated_cb() function
Precondition:
mc_client_set_playback_ability_updated_cb()
See also:
mc_client_set_playback_ability_updated_cb()
mc_playback_action_is_supported()
typedef void(* mc_playback_updated_cb)(const char *server_name, mc_playback_h playback, void *user_data)

Called when the playback information of the media controller server is updated.

Since :
2.4
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_nameThe app_id of the media controller server which sent the notification
[in]playbackThe playback information of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_playback_updated_cb() function
Precondition:
mc_client_set_playback_updated_cb()
See also:
mc_client_set_playback_updated_cb()
mc_client_get_playback_state()
mc_client_get_playback_position()
mc_client_get_playlist_item_info()
typedef void(* mc_playlist_updated_cb)(const char *server_name, mc_playlist_update_mode_e mode, const char *playlist_name, mc_playlist_h playlist, void *user_data)

Called when the playlist of the media controller server is updated.

Since :
4.0
Remarks:
The callback is called in the dbus event loop.
The server_name, playlist_name and playlist should not be released by the application.
The server_name and playlist_name can be used only in the callback. To use outside, make a copy.
And playlist also can be used only in the callback. To use outside, make a copy using mc_playlist_clone().
Parameters:
[in]server_nameThe app_id of the media controller server which sent the notification
[in]modeThe playlist update mode of the updated media controller server
[in]playlist_nameUpdated playlist name
[in]playlistThe handle of the media controller playlist
[in]user_dataThe user data passed from the mc_client_set_playlist_updated_cb() function
Precondition:
mc_client_set_playlist_updated_cb()
See also:
mc_client_set_playlist_updated_cb()
mc_playlist_foreach_playlist()
typedef void(* mc_repeat_ability_updated_cb)(const char *server_name, mc_ability_support_e support, void *user_data) TIZEN_DEPRECATED_API

Called when the repeat ability of the media controller server is updated.

Deprecated:
Deprecated since 5.5. Use mc_ability_support_updated_cb() instead.
Since :
5.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_nameThe app_id of the media controller server which sent the notification
[in]supportThe support value of the ability of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_repeat_ability_updated_cb() function
Precondition:
mc_client_set_repeat_ability_updated_cb()
See also:
mc_client_set_repeat_ability_updated_cb()
typedef void(* mc_repeat_mode_updated_cb)(const char *server_name, mc_repeat_mode_e mode, void *user_data)

Called when the repeat mode of the media controller server is updated.

Since :
4.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_nameThe app_id of the media controller server which sent the notification
[in]modeThe repeat mode of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_repeat_mode_updated_cb() function
Precondition:
mc_client_set_repeat_mode_updated_cb()
See also:
mc_client_set_repeat_mode_updated_cb()
typedef void(* mc_server_state_updated_cb)(const char *server_name, mc_server_state_e state, void *user_data)

Called when the status of the media controller server is updated.

Since :
2.4
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_nameThe app_id of the media controller server which sent the notification
[in]stateThe state of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_server_updated_cb() function
Precondition:
mc_client_set_server_updated_cb()
See also:
mc_client_set_server_updated_cb()
typedef void(* mc_shuffle_ability_updated_cb)(const char *server_name, mc_ability_support_e support, void *user_data) TIZEN_DEPRECATED_API

Called when the shuffle ability support of the media controller server is updated.

Deprecated:
Deprecated since 5.5. Use mc_ability_support_updated_cb() instead.
Since :
5.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_nameThe app_id of the media controller server which sent the notification
[in]supportThe support value of the ability of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_shuffle_ability_updated_cb() function
Precondition:
mc_client_set_shuffle_ability_updated_cb()
See also:
mc_client_set_shuffle_ability_updated_cb()
typedef void(* mc_shuffle_mode_updated_cb)(const char *server_name, mc_shuffle_mode_e mode, void *user_data)

Called when the shuffle mode of the media controller server is updated.

Since :
4.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_nameThe app_id of the media controller server which sent the notification
[in]modeThe shuffle mode of the updated media controller server
[in]user_dataThe user data passed from the mc_client_set_shuffle_mode_updated_cb() function
Precondition:
mc_client_set_shuffle_mode_updated_cb()
See also:
mc_client_set_shuffle_mode_updated_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.
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_nameThe app_id of the subscribed media controller server
[in]user_dataThe 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 :
2.4
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]clientThe handle of the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
See also:
mc_client_destroy()
int mc_client_destroy ( mc_client_h  client)

Destroys client.

Since :
2.4
Parameters:
[in]clientThe handle of 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_INVALID_OPERATIONInvalid operation
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()

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
See also:
mc_client_set_playback_updated_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 :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback function to be invoked, will be called for each 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
int mc_client_foreach_server_playlist ( mc_client_h  client,
const char *  server_name,
mc_playlist_cb  callback,
void *  user_data 
)

Retrieves all playlists of the media controller server.

Deprecated:
Deprecated since 5.5. Use mc_playlist_foreach_playlist() instead.

This function gets all playlists of the media controller server. The callback function will be invoked for every retrieved playlist. If there are no playlists, the callback will not be invoked.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]callbackThe callback function to be invoked
[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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_playlist_cb()
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 of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
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_age_rating ( mc_playback_h  playback,
mc_content_age_rating_e age_rating 
)

Gets the age rating of the content.

Gets the age rating of the current playing media.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]playbackThe handle to playback
[out]age_ratingAge rating of the content
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
Precondition:
The playback update callback should be set with mc_client_set_playback_updated_cb().
See also:
mc_client_set_playback_updated_cb()
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:
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]clientThe handle of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory

Gets the playback content type.

Gets the content type of the current playing media. If there is no content type info, result value is MC_CONTENT_TYPE_UNDECIDED.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]playbackThe handle to playback
[out]content_typeThe content type of the playback
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
Precondition:
The playback update callback should be set with mc_client_set_playback_updated_cb().
See also:
mc_client_set_playback_updated_cb()
int mc_client_get_playback_position ( mc_playback_h  playback,
unsigned long long *  position 
)

Gets the playback position.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
Precondition:
The playback update callback should be set with mc_client_set_playback_updated_cb().
See also:
mc_client_set_playback_updated_cb()

Gets the playback state.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
Precondition:
The playback update callback should be set with mc_client_set_playback_updated_cb().
See also:
mc_client_set_playback_updated_cb()
int mc_client_get_playlist_item_index ( mc_playback_h  playback,
char **  index 
)

Gets the index of the media in playlist.

Deprecated:
Deprecated since 5.0. Use mc_client_get_playlist_item_info() instead.

Gets the index of the current playing media in a playlist. If the media controller server didn't set the index, the value is NULL.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The index should be released using free().
Parameters:
[in]playbackThe handle to playback
[out]indexThe index of the media
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
The playback update callback should be set with mc_client_set_playback_updated_cb().
See also:
mc_client_set_playback_updated_cb()
mc_playlist_foreach_playlist()
int mc_client_get_playlist_item_info ( mc_playback_h  playback,
char **  playlist_name,
char **  index 
)

Gets the playlist name and index of the media in playlist.

Gets the playlist name and index of the current playing media in a playlist.
If the media controller server didn't set the info, playlist_name and index will be set to NULL.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The playlist_name and index should be released using free().
Parameters:
[in]playbackThe handle to playback
[out]playlist_nameThe playlist name media included
[out]indexThe index of the media
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
The playback update callback should be set with mc_client_set_playback_updated_cb().
See also:
mc_client_set_playback_updated_cb()
mc_playlist_foreach_playlist()
int mc_client_get_server_360_mode_enabled ( mc_client_h  client,
const char *  server_name,
bool *  enabled 
)

Gets the latest 360 mode display status.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]enabledThe status of the latest 360 mode display
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
int mc_client_get_server_ability_support ( mc_client_h  client,
const char *  server_name,
mc_ability_e  ability,
mc_ability_support_e support 
)

Gets the ability support of the media controller server.

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
If the server's ability support is not set, the result value is MC_ABILITY_SUPPORTED_UNDECIDED.
It means you can send the corresponding command to the server, but it's not guaranteed that the server can handle it.
If the media controller server is deactivated, this function will return MC_ABILITY_SUPPORTED_UNDECIDED.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]abilityThe ability
[out]supportThe support value of the ability
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
Get a server name handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_get_latest_server_info()
mc_client_foreach_server()
mc_client_get_server_playback_ability()
mc_client_get_server_display_mode_ability()
mc_client_get_server_display_rotation_ability()
int mc_client_get_server_display_mode ( mc_client_h  client,
const char *  server_name,
mc_display_mode_e mode 
)

Gets the latest display mode.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The default display mode is MC_DISPLAY_MODE_FULL_SCREEN.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]modeThe info of the latest display mode
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
int mc_client_get_server_display_mode_ability ( mc_client_h  client,
const char *  server_name,
unsigned int *  supported_modes 
)

Gets the supported display mode of the updated media controller server.

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
If a display mode is not present in the supported_modes, then the server's support for this mode is MC_ABILITY_SUPPORTED_NO and you can't send the corresponding command to the server.
If the media controller server is deactivated, this function will return MC_ABILITY_SUPPORTED_NO.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]supported_modesThe supported display mode, values of mc_display_mode_e combined with bitwise 'or'.
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
Get a server name handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_get_latest_server_info()
mc_client_foreach_server()
mc_client_get_server_playback_ability()
mc_client_get_server_ability_support()
mc_client_get_server_display_rotation_ability()
int mc_client_get_server_display_rotation ( mc_client_h  client,
const char *  server_name,
mc_display_rotation_e rotation 
)

Gets the latest display rotation.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The default display rotation is MC_DISPLAY_ROTATION_NONE.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]rotationThe info of the latest display rotation
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
int mc_client_get_server_display_rotation_ability ( mc_client_h  client,
const char *  server_name,
unsigned int *  supported_rotations 
)

Gets the supported display rotation of the updated media controller server.

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
If a display rotation is not present in the supported_rotations, then the server's support for this mode is MC_ABILITY_SUPPORTED_NO and you can't send the corresponding command to the server.
If the media controller server is deactivated, this function will return MC_ABILITY_SUPPORTED_NO.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]supported_rotationsThe supported display rotation, values of mc_display_rotation_e combined with bitwise 'or'
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
Get a server name handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_get_latest_server_info()
mc_client_foreach_server()
mc_client_get_server_playback_ability()
mc_client_get_server_ability_support()
mc_client_get_server_display_mode_ability()
int mc_client_get_server_icon ( mc_client_h  client,
const char *  server_name,
char **  uri 
)

Gets the icon URI of the media controller server.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The uri should be released using free().
If there is no URI info, return value of the uri is NULL.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]uriThe icon URI
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
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:
The metadata should be released using mc_metadata_destroy().
If there is no metadata, return value of the metadata is NULL.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]metadataThe handle to metadata
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
int mc_client_get_server_playback_ability ( mc_client_h  client,
const char *  server_name,
mc_playback_ability_h ability 
)

Gets the playback ability of the media controller server.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The ability should be released using mc_playback_ability_destroy().
If the media controller server is deactivated, this function will return MC_ABILITY_SUPPORTED_UNDECIDED.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]abilityThe handle to ability
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
Get a server name handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_get_latest_server_info()
mc_client_foreach_server()
mc_playback_action_is_supported()
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:
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]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]playbackThe handle to playback
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
int mc_client_get_server_repeat_ability_support ( mc_client_h  client,
const char *  server_name,
mc_ability_support_e support 
)

Gets the support value of the repeat ability of the updated media controller server.

Deprecated:
Deprecated since 5.5. Use mc_client_get_server_ability_support() instead.
Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
If the server's ability support is not set, the result value is MC_ABILITY_SUPPORTED_UNDECIDED.
It means you can send the corresponding command to the server, but it's not guaranteed that the server can handle it.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]supportThe support value of the repeat ability
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
Get a server name handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_get_latest_server_info()
mc_client_foreach_server()
mc_client_get_server_playback_ability()
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 of the media controller client
[in]server_nameThe app_id of the media controller server
[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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
int mc_client_get_server_shuffle_ability_support ( mc_client_h  client,
const char *  server_name,
mc_ability_support_e support 
)

Gets the support value of the shuffle ability of the updated media controller server.

Deprecated:
Deprecated since 5.5. Use mc_client_get_server_ability_support() instead.
Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
If the server's ability support is not set, the result value is MC_ABILITY_SUPPORTED_UNDECIDED.
It means you can send the corresponding command to the server, but it's not guaranteed that the server can handle it.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]supportThe support value of the shuffle ability
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
Get a server name handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_get_latest_server_info()
mc_client_foreach_server()
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 of the media controller client
[in]server_nameThe app_id of the media controller server
[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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
int mc_client_get_server_subtitles_enabled ( mc_client_h  client,
const char *  server_name,
bool *  enabled 
)

Gets the latest subtitles display status.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[out]enabledThe status of the latest subtitles display
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
int mc_client_send_360_mode_cmd ( mc_client_h  client,
const char *  server_name,
bool  enable,
char **  request_id 
)

Sends the 360 mode command to server.

If the server sends the result of the command, the media controller client will get the result of the 360 mode command by mc_cmd_reply_received_cb() callback.

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the 360 mode command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]enableThe request status to send to media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_custom_cmd ( mc_client_h  client,
const char *  server_name,
const char *  command,
bundle data,
char **  request_id 
)

Sends the custom command to server.

If the server sends the result of the command, the media controller client will get the result of the custom command by mc_cmd_reply_received_cb() callback.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the custom command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP since 5.5.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]commandThe command to be sent
[in]dataThe extra data
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_display_mode_cmd ( mc_client_h  client,
const char *  server_name,
mc_display_mode_e  mode,
char **  request_id 
)

Sends the display mode command to server.

If the server sends the result of the command, the media controller client will get the result of the display mode command by mc_cmd_reply_received_cb() callback.

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the display mode command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]modeThe display mode to send to media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_display_rotation_cmd ( mc_client_h  client,
const char *  server_name,
mc_display_rotation_e  rotation,
char **  request_id 
)

Sends the display rotation command to server.

If the server sends the result of the command, the media controller client will get the result of the display rotation command by mc_cmd_reply_received_cb() callback.

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the display rotation command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]rotationThe display rotation to send to media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_event_reply ( mc_client_h  client,
const char *  server_name,
const char *  request_id,
int  result_code,
bundle data 
)

Replies with the result of the requested event to the media controller server.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The media controller client get the server_name and request_id through the mc_client_custom_event_received_cb().
If request_id is not null there, the media controller client should send the reply to the media controller server with the request_id.
If request_id is null, this function will return MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER.
If the server_name application doesn't support receiving the event reply, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP since 5.5.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]request_idThe id of the event request, received in the mc_client_set_custom_event_received_cb() function
[in]result_codeThe result code of custom event, mc_result_code_e since 6.0
[in]dataThe extra data
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller server handle by calling mc_server_create().
See also:
mc_client_create()
mc_client_set_custom_event_received_cb()
mc_client_unset_custom_event_received_cb()
mc_client_destroy()
int mc_client_send_playback_action_cmd ( mc_client_h  client,
const char *  server_name,
mc_playback_action_e  action,
char **  request_id 
)

Sends the playback action command to server.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the playback action command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP since 5.5.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]actionThe playback action command to send to the media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_get_server_playback_info()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_playback_position_cmd ( mc_client_h  client,
const char *  server_name,
unsigned long long  position,
char **  request_id 
)

Sends the playback position command to server.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the playback position command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP since 5.5.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]positionThe position of the playback in milliseconds to send to media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_get_server_playback_info()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_playlist_cmd ( mc_client_h  client,
const char *  server_name,
const char *  playlist_name,
const char *  index,
mc_playback_action_e  action,
unsigned long long  position,
char **  request_id 
)

Sends the playlist command to server.

The media controller client can send "index" of the playlist to the media controller server with playback action and position.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the playlist command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP since 5.5.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]playlist_nameThe playlist name of the server
[in]indexThe index of the media in playlist to send to the media controller server
[in]actionThe playback action command to send to the media controller server
[in]positionThe position of the playback in milliseconds to send to media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_repeat_mode_cmd ( mc_client_h  client,
const char *  server_name,
mc_repeat_mode_e  repeat_mode,
char **  request_id 
)

Sends the repeat mode command to server.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the repeat mode, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP since 5.5.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]repeat_modeThe repeat mode to send to media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_get_server_playback_info()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_search_cmd ( mc_client_h  client,
const char *  server_name,
mc_search_h  search,
char **  request_id 
)

Sends the search command to server.

If the server sends the result of the command, the media controller client will get the result of the search command by mc_cmd_reply_received_cb() callback.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the search command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP since 5.5.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]searchThe search handle to be sent
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
Create search handle and set data by calling mc_search_create() and mc_search_set_condition().
See also:
mc_client_create()
mc_client_set_cmd_reply_received_cb()
mc_search_create()
mc_search_set_condition()
int mc_client_send_shuffle_mode_cmd ( mc_client_h  client,
const char *  server_name,
mc_shuffle_mode_e  shuffle_mode,
char **  request_id 
)

Sends the shuffle mode command to server.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the shuffle mode, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP since 5.5.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]shuffle_modeThe shuffle mode to send to media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_get_server_playback_info()
mc_client_set_cmd_reply_received_cb()
int mc_client_send_subtitles_cmd ( mc_client_h  client,
const char *  server_name,
bool  enable,
char **  request_id 
)

Sends the subtitles command to server.

If the server sends the result of the command, the media controller client will get the result of the subtitles command by mc_cmd_reply_received_cb() callback.

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Remarks:
The request_id should be released using free().
If the request_id is null, the server will not send the reply of the command.
If the server_name application doesn't support the subtitles command, this function will return MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APP.
Parameters:
[in]clientThe handle of the media controller client
[in]server_nameThe app_id of the media controller server
[in]enableThe request status to send to media controller server
[out]request_idThe id of the command request, it will be passed to the mc_cmd_reply_received_cb() function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTROLLER_ERROR_ABILITY_LIMITED_BY_SERVER_APPLimited by server application
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_set_cmd_reply_received_cb()
int mc_client_set_360_mode_updated_cb ( mc_client_h  client,
mc_bool_attribute_updated_cb  callback,
void *  user_data 
)

Sets the callback for monitoring the media controller server's 360 mode display.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the 360 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_360_mode_updated_cb()
int mc_client_set_ability_support_updated_cb ( mc_client_h  client,
mc_ability_support_updated_cb  callback,
void *  user_data 
)

Sets the callback for monitoring the media controller server's support for an ability.

The media controller client which calls this function will receive notifications from all media controller servers. This function can be used to monitor the following abilities:
MC_ABILITY_SHUFFLE,
MC_ABILITY_REPEAT,
MC_ABILITY_PLAYBACK_POSITION,
MC_ABILITY_PLAYLIST,
MC_ABILITY_CLIENT_CUSTOM,
MC_ABILITY_SEARCH,
MC_ABILITY_SUBTITLES,
MC_ABILITY_360_MODE,
To monitor the media controller server's support for other abilities, use corresponding function.
For a playback ability, use mc_client_set_playback_ability_updated_cb().
For a display mode ability, use mc_client_set_display_mode_ability_updated_cb().
For a display rotation ability, use mc_client_set_display_rotation_ability_updated_cb().

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the ability 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_ability_support_updated_cb()
mc_client_set_playback_ability_updated_cb()
mc_client_set_display_mode_ability_updated_cb()
mc_client_set_display_rotation_ability_updated_cb()
int mc_client_set_cmd_reply_received_cb ( mc_client_h  client,
mc_cmd_reply_received_cb  callback,
void *  user_data 
)

Sets the callback for receiving the result of the command from the media controller server.

The media controller client which calls this function will receives the result of the command from all media controller servers.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the reply is received
[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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_unset_cmd_reply_received_cb()
mc_client_destroy()

Sets the callback for receiving the custom event from a media controller server.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle to media controller client
[in]callbackThe callback to be invoked when the media controller client receives custom event from a 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller server handle by calling mc_server_create().
See also:
mc_client_create()
mc_client_custom_event_received_cb()
mc_client_unset_custom_event_received_cb()
mc_client_send_event_reply()
mc_client_destroy()

Sets the callback for monitoring the display mode ability of the media controller server.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the ability 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_display_mode_ability_updated_cb()
int mc_client_set_display_mode_updated_cb ( mc_client_h  client,
mc_display_mode_updated_cb  callback,
void *  user_data 
)

Sets the callback for monitoring the media controller server's display mode.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the display 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_display_mode_updated_cb()

Sets the callback for monitoring the display rotation ability of the media controller server.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the ability 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_display_rotation_ability_updated_cb()
int mc_client_set_display_rotation_updated_cb ( mc_client_h  client,
mc_display_rotation_updated_cb  callback,
void *  user_data 
)

Sets the callback for monitoring the media controller server's display rotation.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the display rotation 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_display_rotation_updated_cb()
int mc_client_set_metadata_updated_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.

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

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_metadata_updated_cb()
int mc_client_set_playback_ability_updated_cb ( mc_client_h  client,
mc_playback_ability_updated_cb  callback,
void *  user_data 
)

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

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

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the ability 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_playback_ability_updated_cb()
int mc_client_set_playback_updated_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.

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

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_playback_updated_cb()
int mc_client_set_playlist_updated_cb ( mc_client_h  client,
mc_playlist_updated_cb  callback,
void *  user_data 
)

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

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

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the playlist 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_playlist_updated_cb()
mc_client_unset_playlist_updated_cb()
int mc_client_set_repeat_ability_updated_cb ( mc_client_h  client,
mc_repeat_ability_updated_cb  callback,
void *  user_data 
)

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

Deprecated:
Deprecated since 5.5. Use mc_client_set_ability_support_updated_cb() instead.

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

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the ability 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
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_updated_cb ( mc_client_h  client,
mc_repeat_mode_updated_cb  callback,
void *  user_data 
)

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

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

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_repeat_mode_updated_cb()
int mc_client_set_server_updated_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.

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

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_server_updated_cb()
int mc_client_set_shuffle_ability_updated_cb ( mc_client_h  client,
mc_shuffle_ability_updated_cb  callback,
void *  user_data 
)

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

Deprecated:
Deprecated since 5.5. Use mc_client_set_ability_support_updated_cb() instead.

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

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the ability 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
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_updated_cb ( mc_client_h  client,
mc_shuffle_mode_updated_cb  callback,
void *  user_data 
)

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

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

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_shuffle_mode_updated_cb()
int mc_client_set_subtitles_updated_cb ( mc_client_h  client,
mc_bool_attribute_updated_cb  callback,
void *  user_data 
)

Sets the callback for monitoring the media controller server's subtitles display.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
[in]callbackThe callback to be invoked when the subtitles 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_unset_subtitles_updated_cb()
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 :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut of memory
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 the media controller server's 360 mode display.

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

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

Unsets the callback for monitoring the media controller server's support for an ability.

The media controller client which calls this function will not receive notifications from all media controller servers. This function can be used for the following abilities:
MC_ABILITY_SHUFFLE,
MC_ABILITY_REPEAT,
MC_ABILITY_PLAYBACK_POSITION,
MC_ABILITY_PLAYLIST,
MC_ABILITY_CLIENT_CUSTOM,
MC_ABILITY_SEARCH,
MC_ABILITY_SUBTITLES,
MC_ABILITY_360_MODE,
To stop monitoring the media controller server's support for other abilities, use corresponding function.
For a playback ability, use mc_client_unset_playback_ability_updated_cb().
For a display mode ability, use mc_client_unset_display_mode_ability_updated_cb().
For a display rotation ability, use mc_client_unset_display_rotation_ability_updated_cb().

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

Unsets the callback for receiving common reply of the media controller server.

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

Unsets the callback for receiving the custom event from a media controller server.

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

Unsets the callback for monitoring the display mode ability of the media controller server.

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

Unsets the callback for monitoring the media controller server's display mode.

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

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

Unsets the callback for monitoring the display rotation ability of the media controller server.

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

Unsets the callback for monitoring the media controller server's display rotation.

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

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

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

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

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

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

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

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

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

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

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

Deprecated:
Deprecated since 5.5. Use mc_client_unset_ability_support_updated_cb() instead.
Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
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 :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_set_repeat_mode_updated_cb()

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

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

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

Deprecated:
Deprecated since 5.5. Use mc_client_unset_ability_support_updated_cb() instead.
Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
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 :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_set_shuffle_mode_updated_cb()

Unsets the callback for monitoring the media controller server's subtitles display.

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

Since :
5.5
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of the media controller client
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
Precondition:
Create a media controller client handle by calling mc_client_create().
See also:
mc_client_create()
mc_client_destroy()
mc_client_set_subtitles_updated_cb()
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 :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediacontroller.client
Parameters:
[in]clientThe handle of 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_PERMISSION_DENIEDPermission denied
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_INVALID_OPERATIONInvalid operation
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()