Tizen Native API
4.0
|
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_command()).
Before doing those things you should create handle(mc_client_create()). And if you don't use handle anymore, you have to destroy it(mc_client_destroy()). If there is no the activated server, you can get the latest server information by using mc_client_get_latest_server_info().
Functions | |
int | mc_client_create (mc_client_h *client) |
Creates a media controller client. | |
int | mc_client_set_server_update_cb (mc_client_h client, mc_server_state_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API |
Sets the callback for monitoring status of the media controller server. | |
int | mc_client_unset_server_update_cb (mc_client_h client) TIZEN_DEPRECATED_API |
Unsets the callback for monitoring status of the media controller server. | |
int | mc_client_set_playback_update_cb (mc_client_h client, mc_playback_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API |
Sets the callback for monitoring playback status of the media controller server. | |
int | mc_client_unset_playback_update_cb (mc_client_h client) TIZEN_DEPRECATED_API |
Unsets the callback for monitoring playback status of the media controller server. | |
int | mc_client_set_metadata_update_cb (mc_client_h client, mc_metadata_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API |
Sets the callback for monitoring metadata status of the media controller server. | |
int | mc_client_unset_metadata_update_cb (mc_client_h client) TIZEN_DEPRECATED_API |
Unsets the callback for monitoring metadata status of the media controller server. | |
int | mc_client_set_shuffle_mode_update_cb (mc_client_h client, mc_shuffle_mode_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API |
Sets the callback for monitoring shuffle mode of the media controller server. | |
int | mc_client_unset_shuffle_mode_update_cb (mc_client_h client) TIZEN_DEPRECATED_API |
Unsets the callback for monitoring shuffle mode of the media controller server. | |
int | mc_client_set_repeat_mode_update_cb (mc_client_h client, mc_repeat_mode_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API |
Sets the callback for monitoring repeat mode of the media controller server. | |
int | mc_client_unset_repeat_mode_update_cb (mc_client_h client) TIZEN_DEPRECATED_API |
Unsets the callback for monitoring repeat mode of the media controller server. | |
int | mc_client_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_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_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) |
Gets the index of the media in playlist. | |
int | mc_client_destroy_playback (mc_playback_h playback) |
Destroys playback. | |
int | mc_client_get_metadata (mc_metadata_h metadata, mc_meta_e attribute, char **value) TIZEN_DEPRECATED_API |
Gets the metadata. | |
int | mc_client_destroy_metadata (mc_metadata_h metadata) TIZEN_DEPRECATED_API |
Destroys metadata. | |
int | mc_client_get_latest_server_info (mc_client_h client, char **server_name, mc_server_state_e *server_state) |
Gets the latest media controller server info. | |
int | mc_client_get_server_playback_info (mc_client_h client, const char *server_name, mc_playback_h *playback) |
Gets the latest playback info. | |
int | mc_client_get_server_metadata (mc_client_h client, const char *server_name, mc_metadata_h *metadata) |
Gets the latest metadata. | |
int | mc_client_get_server_shuffle_mode (mc_client_h client, const char *server_name, mc_shuffle_mode_e *mode) |
Gets the latest shuffle mode. | |
int | mc_client_get_server_repeat_mode (mc_client_h client, const char *server_name, mc_repeat_mode_e *mode) |
Gets the latest repeat mode. | |
int | mc_client_foreach_server (mc_client_h client, mc_activated_server_cb callback, void *user_data) |
Retrieves all created servers. | |
int | mc_client_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. | |
int | mc_client_send_playback_state_command (mc_client_h client, const char *server_name, mc_playback_states_e state) TIZEN_DEPRECATED_API |
Sends the playback state command to server. | |
int | mc_client_send_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_custom_command (mc_client_h client, const char *server_name, const char *command, bundle *data, mc_command_reply_received_cb callback, void *user_data) TIZEN_DEPRECATED_API |
Sends the custom command to server. | |
int | mc_client_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_destroy (mc_client_h client) |
Destroys client. | |
Typedefs | |
typedef void(* | mc_server_state_updated_cb )(const char *server_name, mc_server_state_e state, void *user_data) |
Called when updating status of the media controller server. | |
typedef void(* | mc_playback_updated_cb )(const char *server_name, mc_playback_h playback, void *user_data) |
Called when updating the playback information of the media controller server. | |
typedef void(* | mc_metadata_updated_cb )(const char *server_name, mc_metadata_h metadata, void *user_data) |
Called when updating the metadata of the media controller server. | |
typedef void(* | mc_shuffle_mode_changed_cb )(const char *server_name, mc_shuffle_mode_e mode, void *user_data) TIZEN_DEPRECATED_API |
Called when updating the shuffle mode of the media controller server. | |
typedef void(* | mc_repeat_mode_changed_cb )(const char *server_name, mc_repeat_mode_e mode, void *user_data) TIZEN_DEPRECATED_API |
Called when updating the repeat mode of the media controller server. | |
typedef void(* | mc_shuffle_mode_updated_cb )(const char *server_name, mc_shuffle_mode_e mode, void *user_data) |
Called when updating the shuffle mode of the media controller server. | |
typedef void(* | mc_repeat_mode_updated_cb )(const char *server_name, mc_repeat_mode_e mode, void *user_data) |
Called when updating the repeat mode of the media controller server. | |
typedef bool(* | mc_activated_server_cb )(const char *server_name, void *user_data) |
Called when requesting the list of created servers. | |
typedef void(* | mc_command_reply_received_cb )(const char *server_name, int result_code, bundle *data, void *user_data) TIZEN_DEPRECATED_API |
Called when receiving the command processing result from the server. | |
typedef 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 updating the playlist of the media controller server. | |
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 Documentation
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_name The app_id of the created media controller server. [in] user_data The user data passed from the mc_client_foreach_server() function
- Returns:
true
to continue with the next iteration of the loop, otherwisefalse
to break out of the loop
- Precondition:
- mc_client_foreach_server()
- See also:
- mc_client_foreach_server()
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_name The app_id of the subscribed media controller server. [in] request_id The id of the custom event request [in] event The name of the custom event [in] data The data can include other information associated with the event [in] user_data The user data passed from the mc_client_set_custom_event_received_cb() function
- Returns:
true
to continue with the next iteration of the loop, otherwisefalse
to break out of the loop
- Precondition:
- mc_client_set_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_name The app_id of the media controller server which sent the reply, [in] request_id The id of the command request [in] result_code The result code of the action [in] data The extra data [in] user_data The user data passed from the mc_client_set_cmd_reply_received_cb() function
- See also:
- mc_client_send_custom_cmd()
typedef void(* mc_command_reply_received_cb)(const char *server_name, int result_code, bundle *data, void *user_data) TIZEN_DEPRECATED_API |
Called when receiving the command processing result from the server.
- Deprecated:
- Deprecated since 4.0. Use mc_cmd_reply_received_cb() instead.
- Since :
- 2.4
- Remarks:
- The callback is called in the dbus event loop. data should be released using bundle_free().
- Parameters:
-
[in] server_name The app_id of the media controller server which sent the reply, It can be used only in the callback. To use outside, make a copy. [in] result_code The result code of custom command [in] data The extra data [in] user_data The user data passed from the mc_client_send_custom_command() function
- Precondition:
- mc_client_send_custom_command()
- See also:
- mc_client_send_custom_command()
typedef void(* mc_metadata_updated_cb)(const char *server_name, mc_metadata_h metadata, void *user_data) |
Called when updating the metadata of the media controller server.
- Since :
- 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_name The app_id of the media controller server which sent the notification. [in] metadata the metadata of the updated media controller server. [in] user_data The user data passed from the mc_client_set_metadata_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_updated_cb)(const char *server_name, mc_playback_h playback, void *user_data) |
Called when updating the playback information of the media controller server.
- Since :
- 2.4
- Remarks:
- The callback is called in the dbus event loop. The server_name and playback should not be released by the application.
The server_name can be used only in the callback. To use outside, make a copy. And playback also can be used only in the callback.
- Parameters:
-
[in] server_name The app_id of the media controller server which sent the notification. [in] playback The playback information of the updated media controller server. [in] user_data The user data passed from the mc_client_set_playback_updated_cb() function
- Precondition:
- mc_client_set_playback_updated_cb()
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 updating the playlist of the media controller server.
- 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_name The app_id of the media controller server which sent the notification. [in] mode The playlist update mode of the updated media controller server [in] playlist_name Updated playlist name. [in] playlist The handle to the media controller playlist. [in] user_data The user data passed from the mc_client_set_playlist_updated_cb() function
- Precondition:
- mc_client_set_playlist_updated_cb()
typedef void(* mc_repeat_mode_changed_cb)(const char *server_name, mc_repeat_mode_e mode, void *user_data) TIZEN_DEPRECATED_API |
Called when updating the repeat mode of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_repeat_mode_updated_cb() instead.
- Since :
- 2.4
- Remarks:
- The callback is called in the dbus event loop.
- Parameters:
-
[in] server_name The app_id of the media controller server which sent the notification. It can be used only in the callback. To use outside, make a copy. [in] mode The repeat mode of the updated media controller server [in] user_data The user data passed from the mc_client_set_repeat_mode_update_cb() function
- Precondition:
- mc_client_set_repeat_mode_update_cb()
typedef void(* mc_repeat_mode_updated_cb)(const char *server_name, mc_repeat_mode_e mode, void *user_data) |
Called when updating the repeat mode of the media controller server.
- Since :
- 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_name The app_id of the media controller server which sent the notification.. [in] mode The repeat mode of the updated media controller server [in] user_data The user data passed from the mc_client_set_repeat_mode_updated_cb() function
- Precondition:
- 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 updating status of the media controller server.
- 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_name The app_id of the media controller server which sent the notification. [in] state The state of the updated media controller server [in] user_data The user data passed from the mc_client_set_server_updated_cb() function
- Precondition:
- mc_client_set_server_updated_cb()
- See also:
- mc_client_set_server_updated_cb()
typedef void(* mc_shuffle_mode_changed_cb)(const char *server_name, mc_shuffle_mode_e mode, void *user_data) TIZEN_DEPRECATED_API |
Called when updating the shuffle mode of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_shuffle_mode_updated_cb() instead.
- Since :
- 2.4
- Remarks:
- The callback is called in the dbus event loop.
- Parameters:
-
[in] server_name The app_id of the media controller server which sent the notification. It can be used only in the callback. To use outside, make a copy. [in] mode The shuffle mode of the updated media controller server [in] user_data The user data passed from the mc_client_set_shuffle_mode_update_cb() function
- Precondition:
- mc_client_set_shuffle_mode_update_cb()
typedef void(* mc_shuffle_mode_updated_cb)(const char *server_name, mc_shuffle_mode_e mode, void *user_data) |
Called when updating the shuffle mode of the media controller server.
- Since :
- 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_name The app_id of the media controller server which sent the notification. [in] mode The shuffle mode of the updated media controller server [in] user_data The user data passed from the mc_client_set_shuffle_mode_updated_cb() function
- Precondition:
- 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_name The app_id of the subscribed media controller server.. [in] user_data The user data passed from the mc_client_foreach_server_subscribed() function
- Returns:
true
to continue with the next iteration of the loop, otherwisefalse
to break out of the loop
- Precondition:
- 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] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY Out of memory MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- See also:
- mc_client_destroy()
int mc_client_destroy | ( | mc_client_h | client | ) |
Destroys client.
- Since :
- 2.4
- Parameters:
-
[in] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
METADATA_EXTRACTOR_ERROR_NONE Successful METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
int mc_client_destroy_metadata | ( | mc_metadata_h | metadata | ) |
Destroys metadata.
- Deprecated:
- Deprecated since 4.0. Use mc_metadata_destroy() instead.
- Since :
- 2.4
- Parameters:
-
[in] metadata The handle to metadata
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter
- Precondition:
- Sets mc_client_set_metadata_update_cb() function to create metadata
- See also:
- mc_client_set_metadata_update_cb()
int mc_client_destroy_playback | ( | mc_playback_h | playback | ) |
Destroys playback.
- Since :
- 2.4
- Parameters:
-
[in] playback The handle to playback
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter
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] client The handle to the media controller client [in] callback The callback function to be invoked, will be called for each server [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
int mc_client_foreach_server_playlist | ( | mc_client_h | client, |
const char * | server_name, | ||
mc_playlist_cb | callback, | ||
void * | user_data | ||
) |
Retrieves all playlists of the media controller server.
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] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] callback The callback function to be invoked. [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY Out 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] client The handle to the media controller client [in] subscription_type The subscription type [in] callback The callback to be invoked when the list of the subscribed media controller server. [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create()
- Subscribe the media controller server for monitoring status by calling mc_client_subscribe()
- See also:
- mc_client_create()
- mc_client_subscribe()
int mc_client_get_latest_server_info | ( | mc_client_h | client, |
char ** | server_name, | ||
mc_server_state_e * | server_state | ||
) |
Gets the latest media controller server info.
The media controller client will get the most recently updated information by the server.
- Since :
- 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] client The handle to the media controller client [out] server_name The app_id of the latest media controller server [out] server_state The state of the latest media controller server
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
int mc_client_get_metadata | ( | mc_metadata_h | metadata, |
mc_meta_e | attribute, | ||
char ** | value | ||
) |
Gets the metadata.
- Deprecated:
- Deprecated since 4.0. Use mc_metadata_get() instead.
- Since :
- 2.4
- Remarks:
- The metadata should be released using
mc_client_destroy_metadata()
.
And also The value should be released using free(). If the attribute value of the metadata is empty, return value is NULL.
- Parameters:
-
[in] metadata The handle to metadata [in] attribute The key attribute name to get [out] value The value of the attribute
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter
- Precondition:
- Sets mc_client_set_metadata_update_cb() function to get the metadata
- See also:
- mc_client_set_metadata_update_cb()
int mc_client_get_playback_position | ( | mc_playback_h | playback, |
unsigned long long * | position | ||
) |
Gets the playback position.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] playback The handle to playback [out] position The position of the playback in milliseconds
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- The playback update callback should be set with mc_client_set_playback_updated_cb().
- See also:
- mc_client_set_playback_updated_cb()
int mc_client_get_playback_state | ( | mc_playback_h | playback, |
mc_playback_states_e * | state | ||
) |
Gets the playback state.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] playback The handle to playback [out] state The state of the playback
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- The playback update callback should be set with mc_client_set_playback_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.
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] playback The handle to playback [out] index The index of the media
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY Out of memory MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- The playback update callback should be set with mc_client_set_playback_updated_cb().
int mc_client_get_server_metadata | ( | mc_client_h | client, |
const char * | server_name, | ||
mc_metadata_h * | metadata | ||
) |
Gets the latest metadata.
The media controller client will get the most recently updated information from server_name.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Remarks:
- The metadata should be released using
mc_metadata_destroy()\n
If there is no metadata, return value of the metadata is NULL.
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [out] metadata The handle to metadata
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
int mc_client_get_server_playback_info | ( | mc_client_h | client, |
const char * | server_name, | ||
mc_playback_h * | playback | ||
) |
Gets the latest playback info.
The media controller client will get the most recently updated information from server_name.
- Since :
- 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] client The handle to the media controller client [in] server_name The app_id of the media controller server [out] playback The handle to playback
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
int mc_client_get_server_repeat_mode | ( | mc_client_h | client, |
const char * | server_name, | ||
mc_repeat_mode_e * | mode | ||
) |
Gets the latest repeat mode.
The media controller client will get the most recently updated information from server_name.
- Since :
- 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] client The handle to the media controller client [in] server_name The app_id of the media controller server [out] mode The info of the latest shuffle mode
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
int mc_client_get_server_shuffle_mode | ( | mc_client_h | client, |
const char * | server_name, | ||
mc_shuffle_mode_e * | mode | ||
) |
Gets the latest shuffle mode.
The media controller client will get the most recently updated information from server_name.
- Since :
- 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] client The handle to the media controller client [in] server_name The app_id of the media controller server [out] mode The info of the latest shuffle mode
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
int mc_client_send_custom_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.
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] command The command to be sent [in] data The extra data [out] request_id The 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_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
int mc_client_send_custom_command | ( | mc_client_h | client, |
const char * | server_name, | ||
const char * | command, | ||
bundle * | data, | ||
mc_command_reply_received_cb | callback, | ||
void * | user_data | ||
) |
Sends the custom command to server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_send_custom_cmd() instead.
If there is the result for command from server, the media controller client will get the result of the custom command by mc_command_reply_received_cb() callback.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] command The command to be sent [in] data The extra data [in] callback The callback to be invoked when the custom command execute completely. [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
int mc_client_send_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.
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] request_id The id of the event request, received in the mc_client_set_custom_event_received_cb() function. [in] result_code The result code of custom event [in] data The extra data
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY Out of memory MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller server handle by calling mc_server_create().
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.
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] action The playback action command to send to the media controller server [out] request_id The 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_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
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.
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] position The position of the playback in milliseconds to send to media controller server. [out] request_id The 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_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
int mc_client_send_playback_state_command | ( | mc_client_h | client, |
const char * | server_name, | ||
mc_playback_states_e | state | ||
) |
Sends the playback state command to server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_send_playback_action_cmd() instead.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] state The playback state to send to media controller server
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
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.
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] playlist_name The playlist name of the server [in] index The index of the media in playlist to send to the media controller server [in] action The playback action command to send to the media controller server [in] position The position of the playback in milliseconds to send to media controller server [out] request_id The 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_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
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.
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] repeat_mode The repeat mode to send to media controller server [out] request_id The 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_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
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.
- Parameters:
-
[in] client The handle to the media controller client [in] server_name The app_id of the media controller server [in] shuffle_mode The shuffle mode to send to media controller server [out] request_id The 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_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
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] client The handle to the media controller client [in] callback The callback to be invoked when the reply is received [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
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.
- Since :
- 4.0
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to media controller client [in] callback The callback to be invoked when the media controller client receives custom event from a media controller server. [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY Out of memory MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller server handle by calling mc_server_create().
int mc_client_set_metadata_update_cb | ( | mc_client_h | client, |
mc_metadata_updated_cb | callback, | ||
void * | user_data | ||
) |
Sets the callback for monitoring metadata status of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_set_metadata_updated_cb() instead.
The media controller client which calls this function will receive notifications from all media controller servers.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] callback The callback to be invoked when the metadata status is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_set_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] client The handle to the media controller client [in] callback The callback to be invoked when the metadata status is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_set_playback_update_cb | ( | mc_client_h | client, |
mc_playback_updated_cb | callback, | ||
void * | user_data | ||
) |
Sets the callback for monitoring playback status of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_set_playback_updated_cb() instead.
The media controller client which calls this function will receive notifications from all media controller servers.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] callback The callback to be invoked when the playback status is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_set_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] client The handle to the media controller client [in] callback The callback to be invoked when the playback status is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_set_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] client The handle to the media controller client [in] callback The callback to be invoked when the playlist status is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY Out of memory MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
int mc_client_set_repeat_mode_update_cb | ( | mc_client_h | client, |
mc_repeat_mode_changed_cb | callback, | ||
void * | user_data | ||
) |
Sets the callback for monitoring repeat mode of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_set_repeat_mode_updated_cb() instead.
The media controller client which calls this function will receive notifications from all media controller servers.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] callback The callback to be invoked when the repeat mode is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_set_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] client The handle to the media controller client [in] callback The callback to be invoked when the repeat mode is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_set_server_update_cb | ( | mc_client_h | client, |
mc_server_state_updated_cb | callback, | ||
void * | user_data | ||
) |
Sets the callback for monitoring status of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_set_server_updated_cb() instead.
The media controller client which calls this function will receive notifications from all media controller servers.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] callback The callback to be invoked when the media controller server status is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_set_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] client The handle to the media controller client [in] callback The callback to be invoked when the media controller server status is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_set_shuffle_mode_update_cb | ( | mc_client_h | client, |
mc_shuffle_mode_changed_cb | callback, | ||
void * | user_data | ||
) |
Sets the callback for monitoring shuffle mode of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_set_shuffle_mode_updated_cb() instead.
The media controller client which calls this function will receive notifications from all media controller servers.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] callback The callback to be invoked when the shuffle mode is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_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] client The handle to the media controller client [in] callback The callback to be invoked when the shuffle mode is changed [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_subscribe | ( | mc_client_h | client, |
mc_subscription_type_e | subscription_type, | ||
const char * | server_name | ||
) |
Subscribes media controller server for monitoring status.
If media controller client subscribe media controller server,
the media controller client receive callback from subscribed media controller server.
If media controller client subscribe media controller server one or more,
the media controller client can receive callback from only subscribed media controller server.
If you want to subscribe for the all media controller server again,
unset mode update callback and set the callback for the monitoring status again.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] subscription_type The subscription type [in] server_name The app_id of the media controller server
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create()
- Set the callback for monitoring status of the media controller server
- Postcondition:
- Unsubscribe the media controller server for monitoring status by calling mc_client_unsubscribe()
int mc_client_unset_cmd_reply_received_cb | ( | mc_client_h | client | ) |
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] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
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.
- Since :
- 4.0
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller server handle by calling mc_server_create().
int mc_client_unset_metadata_update_cb | ( | mc_client_h | client | ) |
Unsets the callback for monitoring metadata status of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_unset_metadata_updated_cb() instead.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_metadata_updated_cb | ( | mc_client_h | client | ) |
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] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_playback_update_cb | ( | mc_client_h | client | ) |
Unsets the callback for monitoring playback status of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_unset_playback_updated_cb() instead.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_playback_updated_cb | ( | mc_client_h | client | ) |
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] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_playlist_updated_cb | ( | mc_client_h | client | ) |
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] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
int mc_client_unset_repeat_mode_update_cb | ( | mc_client_h | client | ) |
Unsets the callback for monitoring repeat mode of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_unset_repeat_mode_updated_cb() instead.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_repeat_mode_updated_cb | ( | mc_client_h | client | ) |
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] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_server_update_cb | ( | mc_client_h | client | ) |
Unsets the callback for monitoring status of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_unset_server_updated_cb() instead.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_server_updated_cb | ( | mc_client_h | client | ) |
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] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_shuffle_mode_update_cb | ( | mc_client_h | client | ) |
Unsets the callback for monitoring shuffle mode of the media controller server.
- Deprecated:
- Deprecated since 4.0. Use mc_client_unset_shuffle_mode_updated_cb() instead.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unset_shuffle_mode_updated_cb | ( | mc_client_h | client | ) |
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] client The handle to the media controller client
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create().
- See also:
- mc_client_create()
- mc_client_destroy()
int mc_client_unsubscribe | ( | mc_client_h | client, |
mc_subscription_type_e | subscription_type, | ||
const char * | server_name | ||
) |
Unsubscribes media controller server for monitoring status.
If media controller client unsubscribe media controller server,
the media controller client don't receive callback from unsubscribed media controller server.
If media controller client unsubscribe all subscribed media controller server,
the media controller client don't receive callback from all media controller server.
After unset and set update callback function is called again, the media controller client can receive callback from all media controller servers.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/mediacontroller.client
- Parameters:
-
[in] client The handle to the media controller client [in] subscription_type The subscription type [in] server_name The app_id of the media controller server
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
MEDIA_CONTROLLER_ERROR_NONE Successful MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- Precondition:
- Create a media controller client handle by calling mc_client_create()
- Subscribe the media controller server for monitoring status by calling mc_client_subscribe()
- See also:
- mc_client_create()
- mc_client_subscribe()