From: hj kim Date: Wed, 18 Jul 2018 02:27:25 +0000 (+0900) Subject: [ACR-1268]Change APIs profile for the newly added ones. From Common to Mobile only X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=dcc1308007b1ac4ae4d40457108bee78cf29a17c;p=platform%2Fcore%2Fapi%2Fmedia-controller.git [ACR-1268]Change APIs profile for the newly added ones. From Common to Mobile only Change-Id: If84e173763253ebbd16172d5c832c4aa37d2570e --- diff --git a/doc/media_controller_doc.h b/doc/media_controller_doc.h index 4642c1f..12c9857 100755 --- a/doc/media_controller_doc.h +++ b/doc/media_controller_doc.h @@ -51,7 +51,7 @@ * \#include * * @section CAPI_MEDIA_CONTROLLER_SERVER_MODULE_OVERVIEW Overview -* The @ref CAPI_MEDIA_CONTROLLER_SERVER_MODULE API allows you to send the playback info (#mc_server_set_playback_state(), #mc_server_set_playback_position(), #mc_server_set_playlist_item_index()), the metadata (#mc_server_set_metadata() and playlist (#mc_server_set_playlist_item_index(), #mc_server_create_playlist()). and to receive the custom command (#mc_server_set_custom_command_received_cb()), to update the status information on the latest server (#mc_server_update_playback_info(), #mc_server_update_metadata(). \n +* The @ref CAPI_MEDIA_CONTROLLER_SERVER_MODULE API allows you to send the playback info (#mc_server_set_playback_state(), #mc_server_set_playback_position(), #mc_server_set_playlist_item_index()), the metadata (#mc_server_set_metadata() and playlist (#mc_server_set_playlist_item_index(), #mc_server_create_playlist()). and to receive the custom command (#mc_server_set_custom_cmd_received_cb()), to update the status information on the latest server (#mc_server_update_playback_info(), #mc_server_update_metadata(). \n * Before doing those things you should create handle(#mc_server_create()). And if you don't use handle anymore, you have to destroy it(#mc_server_destroy()). * */ diff --git a/include/media_controller_client.h b/include/media_controller_client.h index 9a9e22f..d3b6616 100755 --- a/include/media_controller_client.h +++ b/include/media_controller_client.h @@ -133,7 +133,7 @@ typedef void (*mc_repeat_mode_changed_cb)(const char *server_name, mc_repeat_mod /** * @brief Called when updating the shuffle mode of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop. * The @a server_name should not be released by the application. \n @@ -151,7 +151,7 @@ typedef void (*mc_shuffle_mode_updated_cb)(const char *server_name, mc_shuffle_m /** * @brief Called when updating the repeat mode of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop. * The @a server_name should not be released by the application. \n @@ -207,7 +207,7 @@ typedef void (*mc_command_reply_received_cb)(const char *server_name, int result /** * @brief Called when the result of the command from the server is received. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop. @a data should be released using bundle_free(). * The @a server_name and @ request_id should not be released by the application. \n @@ -248,7 +248,7 @@ typedef bool (*mc_subscribed_server_cb)(const char *server_name, void *user_data /** * @brief Called when updating the playlist of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop. * The @a server_name, @a playlist_name and @a playlist should not be released by the application. \n @@ -270,7 +270,7 @@ typedef void (*mc_playlist_updated_cb)(const char *server_name, mc_playlist_upda /** * @brief Called when receiving custom event of media controller servers. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop. The @a data should be released using bundle_free(). \n * The @a server_name, @a request_id and @a event should not be released by the application. \n @@ -531,7 +531,7 @@ int mc_client_unset_repeat_mode_update_cb(mc_client_h client) TIZEN_DEPRECATED_A /** * @brief Sets the callback for monitoring status of the media controller server. * @details The media controller client which calls this function will receive notifications from all media controller servers. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -552,7 +552,7 @@ int mc_client_set_server_updated_cb(mc_client_h client, mc_server_state_updated_ /** * @brief Unsets the callback for monitoring status of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -572,7 +572,7 @@ int mc_client_unset_server_updated_cb(mc_client_h client); /** * @brief Sets the callback for monitoring playback status of the media controller server. * @details The media controller client which calls this function will receive notifications from all media controller servers. \n - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -593,7 +593,7 @@ int mc_client_set_playback_updated_cb(mc_client_h client, mc_playback_updated_cb /** * @brief Unsets the callback for monitoring playback status of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -613,7 +613,7 @@ int mc_client_unset_playback_updated_cb(mc_client_h client); /** * @brief Sets the callback for monitoring metadata status of the media controller server. * @details The media controller client which calls this function will receive notifications from all media controller servers. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -634,7 +634,7 @@ int mc_client_set_metadata_updated_cb(mc_client_h client, mc_metadata_updated_cb /** * @brief Unsets the callback for monitoring metadata status of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -654,7 +654,7 @@ int mc_client_unset_metadata_updated_cb(mc_client_h client); /** * @brief Sets the callback for monitoring shuffle mode of the media controller server. * @details The media controller client which calls this function will receive notifications from all media controller servers. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -675,7 +675,7 @@ int mc_client_set_shuffle_mode_updated_cb(mc_client_h client, mc_shuffle_mode_up /** * @brief Unsets the callback for monitoring shuffle mode of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -695,7 +695,7 @@ int mc_client_unset_shuffle_mode_updated_cb(mc_client_h client); /** * @brief Sets the callback for monitoring repeat mode of the media controller server. * @details The media controller client which calls this function will receive notifications from all media controller servers. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -716,7 +716,7 @@ int mc_client_set_repeat_mode_updated_cb(mc_client_h client, mc_repeat_mode_upda /** * @brief Unsets the callback for monitoring repeat mode of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -736,7 +736,7 @@ int mc_client_unset_repeat_mode_updated_cb(mc_client_h client); /** * @brief Sets the callback for receiving the result of the command from the media controller server. * @details The media controller client which calls this function will receives the result of the command from all media controller servers. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -758,7 +758,7 @@ int mc_client_set_cmd_reply_received_cb(mc_client_h client, mc_cmd_reply_receive /** * @brief Unsets the callback for receiving common reply of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -779,7 +779,7 @@ int mc_client_unset_cmd_reply_received_cb(mc_client_h client); /** * @brief Sets the callback for monitoring playlist status of the media controller server. * @details The media controller client which calls this function will receive notifications from all media controller servers. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -804,7 +804,7 @@ int mc_client_set_playlist_updated_cb(mc_client_h client, mc_playlist_updated_cb /** * @brief Unsets the callback for monitoring playlist status of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -824,7 +824,7 @@ int mc_client_unset_playlist_updated_cb(mc_client_h client); /** * @brief Sets the callback for receiving the custom event from a media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -849,7 +849,7 @@ int mc_client_set_custom_event_received_cb(mc_client_h client, mc_client_custom_ /** * @brief Unsets the callback for receiving the custom event from a media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -870,7 +870,7 @@ int mc_client_unset_custom_event_received_cb(mc_client_h client); /** * @brief Replies with the result of the requested event to the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -1018,7 +1018,7 @@ int mc_client_get_playback_position(mc_playback_h playback, unsigned long long * /** * @brief Gets the index of the media in playlist. * @details 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_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -1049,8 +1049,8 @@ int mc_client_get_playlist_item_index(mc_playback_h playback, char **index); * otherwise a negative error value * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful * @retval #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter - * @pre The playback update callback should be set with mc_client_set_playback_updated_cb(). * @see mc_client_set_playback_updated_cb() + * @see mc_client_get_server_playback_info() */ int mc_client_destroy_playback(mc_playback_h playback); @@ -1230,7 +1230,7 @@ int mc_client_foreach_server(mc_client_h client, mc_activated_server_cb callback * @details 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_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -1278,7 +1278,7 @@ int mc_client_send_playback_state_command(mc_client_h client, const char *server /** * @brief Sends the playback action command to server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -1304,7 +1304,7 @@ int mc_client_send_playback_action_cmd(mc_client_h client, const char *server_na /** * @brief Sends the playback position command to server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -1330,7 +1330,7 @@ int mc_client_send_playback_position_cmd(mc_client_h client, const char *server_ /** * @brief Sends the shuffle mode command to server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -1356,7 +1356,7 @@ int mc_client_send_shuffle_mode_cmd(mc_client_h client, const char *server_name, /** * @brief Sends the repeat mode command to server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -1408,7 +1408,7 @@ int mc_client_send_custom_command(mc_client_h client, const char *server_name, c /** * @brief Sends the playlist command to server. * @details The media controller client can send "index" of the playlist to the media controller server with playback action and position. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client @@ -1437,7 +1437,7 @@ int mc_client_send_playlist_cmd(mc_client_h client, const char *server_name, con /** * @brief Sends the custom command to server. * @details 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_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.client diff --git a/include/media_controller_metadata.h b/include/media_controller_metadata.h index 5c63c81..153ad18 100755 --- a/include/media_controller_metadata.h +++ b/include/media_controller_metadata.h @@ -39,7 +39,7 @@ extern "C" { * @details This function copies the media controller metadata handle from a source to * destination. The mc_metadata_h is created internally and available through media controller metadata functions. * - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The @a dst should be released using @c mc_metadata_destroy(). * @@ -63,7 +63,7 @@ int mc_metadata_clone(mc_metadata_h src, mc_metadata_h *dst); * handle no longer can be used to perform any operations. A new handle has to * be created before next usage. * - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @param[in] metadata The handle to the media controller metadata * @@ -79,7 +79,7 @@ int mc_metadata_destroy(mc_metadata_h metadata); /** * @brief Gets the metadata. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The @a value should be released using free(). \n * If the attribute value of the metadata is empty, return value is NULL. diff --git a/include/media_controller_playlist.h b/include/media_controller_playlist.h index 2f5bdd6..b9d3aea 100755 --- a/include/media_controller_playlist.h +++ b/include/media_controller_playlist.h @@ -37,7 +37,7 @@ extern "C" { /** * @brief Called for every playlist. * - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The @a playlist should not be released by the application. \n * To use the @a playlist outside this function, copy the handle with the mc_playlist_clone() function. \n @@ -62,7 +62,7 @@ typedef bool (*mc_playlist_cb)(mc_playlist_h playlist, void *user_data); /** * @brief Called for every playlist item in the playlist. * - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The @a index and @a metadata should not be released by the application. \n * The @a index can be used only in the callback. To use outside, make a copy. @@ -86,7 +86,7 @@ typedef bool (*mc_playlist_item_cb)(const char *index, mc_metadata_h metadata, v /** * @brief Gets the name of the playlist. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The @a playlist_name should be released using free(). * @@ -113,7 +113,7 @@ int mc_playlist_get_name(mc_playlist_h playlist, char **playlist_name); * @details This function gets all items in a playlist. * The callback function will be invoked for every retrieved playlist item. * If there are no items on the playlist, the callback will not be invoked. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @param[in] playlist The handle to the media controller playlist * @param[in] callback The callback function to be invoked @@ -142,7 +142,7 @@ int mc_playlist_foreach_item(mc_playlist_h playlist, mc_playlist_item_cb callbac * @details This function copies the media controller playlist handle from a source to * destination. The mc_playlist_h is created internally and available through media controller playlist functions. * - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The @a dst should be released using mc_playlist_destroy(). * @@ -166,7 +166,7 @@ int mc_playlist_clone(mc_playlist_h src, mc_playlist_h *dst); * handle no longer can be used to perform any operations. A new handle has to * be created before next usage. * - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @param[in] playlist The handle to the media controller playlist * diff --git a/include/media_controller_server.h b/include/media_controller_server.h index fd04d6d..150218d 100755 --- a/include/media_controller_server.h +++ b/include/media_controller_server.h @@ -58,7 +58,7 @@ typedef void (*mc_server_playback_state_command_received_cb)(const char* client_ /** * @brief Called when the server receives the playback action command from the client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop.\n * If @a request_id is not null, the server should send the reply to the client with the @a request_id. @@ -79,7 +79,7 @@ typedef void (*mc_server_playback_action_cmd_received_cb)(const char* client_nam /** * @brief Called when the server receives the playback position from the client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop.\n * If @a request_id is not null, the server should send the reply to the client with the @a request_id. @@ -100,7 +100,7 @@ typedef void (*mc_server_playback_position_cmd_received_cb)(const char* client_n /** * @brief Called when the server receives the shuffle mode from the client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop.\n * If @a request_id is not null, the server should send the reply to the client with the @a request_id. @@ -121,7 +121,7 @@ typedef void (*mc_server_shuffle_mode_cmd_received_cb)(const char* client_name, /** * @brief Called when the server receives the repeat mode from the client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop.\n * If @a request_id is not null, the server should send the reply to the client with the @a request_id. @@ -164,7 +164,7 @@ typedef void (*mc_server_custom_command_received_cb)(const char* client_name, co /** * @brief Called when the Server receives playlist command from the client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop. \n * If @a request_id is not null, the server should send the reply to the client with the @a request_id. @@ -190,7 +190,7 @@ typedef void (*mc_server_playlist_cmd_received_cb)(const char* client_name, cons * @brief Called when the Server receives custom command from the client. * @details This callback is called when server receives custom command from client. * If you want to reply to the command, call mc_server_send_cmd_reply() function. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop. @a data should be released using bundle_free().\n * If @a request_id is not null, the server should send the reply to the client with the @a request_id. @@ -213,7 +213,7 @@ typedef void (*mc_server_custom_cmd_received_cb)(const char* client_name, const /** * @brief Called when requesting the list of created clients. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the main loop. \n * The @a client_name should not be released by the application. \n @@ -233,7 +233,7 @@ typedef bool (*mc_activated_client_cb)(const char *client_name, void *user_data) /** * @brief Called when the result of the event from the client is received. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @remarks The callback is called in the dbus event loop. @a data should be released using bundle_free(). \n * The @a client_name and @a request_id should not be released by the application. \n @@ -324,9 +324,9 @@ int mc_server_set_playback_position(mc_server_h server, unsigned long long posit /** * @brief Sets the index of the current playing media in the playlist to update the latest playback info. \n - * @defails If a media controller server has a playlist, the server can register and share it with media controller client. A playlist is a set of "index" and "media metadata".\n + * @details If a media controller server has a playlist, the server can register and share it with media controller client. A playlist is a set of "index" and "media metadata".\n * The media controller server can let media controller clients know the index of current playing media by using this function. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -503,7 +503,7 @@ int mc_server_unset_playback_state_command_received_cb(mc_server_h server) TIZEN /** * @brief Sets the callback for receiving playback action command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -524,7 +524,7 @@ int mc_server_set_playback_action_cmd_received_cb(mc_server_h server, mc_server_ /** * @brief Unsets the callback for receiving playback action command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -543,7 +543,7 @@ int mc_server_unset_playback_action_cmd_received_cb(mc_server_h server); /** * @brief Sets the callback for receiving playback position command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -564,7 +564,7 @@ int mc_server_set_playback_position_cmd_received_cb(mc_server_h server, mc_serve /** * @brief Unsets the callback for receiving playback position command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -583,7 +583,7 @@ int mc_server_unset_playback_position_cmd_received_cb(mc_server_h server); /** * @brief Sets the callback for receiving shuffle mode command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -604,7 +604,7 @@ int mc_server_set_shuffle_mode_cmd_received_cb(mc_server_h server, mc_server_shu /** * @brief Unsets the callback for receiving shuffle mode command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -623,7 +623,7 @@ int mc_server_unset_shuffle_mode_cmd_received_cb(mc_server_h server); /** * @brief Sets the callback for receiving repeat mode command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -644,7 +644,7 @@ int mc_server_set_repeat_mode_cmd_received_cb(mc_server_h server, mc_server_repe /** * @brief Unsets the callback for receiving repeat mode command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -723,7 +723,7 @@ int mc_server_unset_custom_command_received_cb(mc_server_h server) TIZEN_DEPRECA * @retval #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied * @pre Create a media controller server handle by calling mc_server_create(). - * @pre mc_server_command_received_cb() + * @pre mc_server_set_custom_command_received_cb() * @see mc_server_create() * @see mc_server_destroy() */ @@ -731,7 +731,7 @@ int mc_server_send_command_reply(mc_server_h server, const char *client_name, in /** * @brief Sets the callback for receiving playlist command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -752,7 +752,7 @@ int mc_server_set_playlist_cmd_received_cb(mc_server_h server, mc_server_playlis /** * @brief Unsets the callback for receiving playlist command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -771,7 +771,7 @@ int mc_server_unset_playlist_cmd_received_cb(mc_server_h server); /** * @brief Sets the callback for receiving custom command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -792,7 +792,7 @@ int mc_server_set_custom_cmd_received_cb(mc_server_h server, mc_server_custom_cm /** * @brief Unsets the callback for receiving custom command from client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -811,7 +811,7 @@ int mc_server_unset_custom_cmd_received_cb(mc_server_h server); /** * @brief Replies the result of the requested command to the client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -846,7 +846,7 @@ int mc_server_send_cmd_reply(mc_server_h server, const char *client_name, const * @details This function gets all created media controller clients. * The callback function will be invoked for every created media controller client. * If there are no media controller clients, the callback will not be invoked. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -870,7 +870,7 @@ int mc_server_foreach_client(mc_server_h server, mc_activated_client_cb callback /** * @brief Sends the customized event with the bundle data. * @details If the event is needed in the client, this function should be called. @a data is a bundle. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -901,7 +901,7 @@ int mc_server_send_custom_event(mc_server_h server, const char *client_name, con * @brief Sets the callback for receiving the result of the event from the media controller client. * @details The media controller server which calls this function will receive the result of the event from all media controller clients. * The media controller server can send event by using mc_server_send_custom_event(). - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -925,7 +925,7 @@ int mc_server_set_event_reply_received_cb(mc_server_h server, mc_server_event_re /** * @brief Unsets the callback for receiving event reply of the media controller client. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -959,7 +959,7 @@ int mc_server_destroy(mc_server_h server); /** * @brief Creates a new playlist with the given name. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -992,7 +992,7 @@ int mc_server_create_playlist(mc_server_h server, const char *playlist_name, mc_ /** * @brief Adds a new item to the playlist. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -1027,7 +1027,7 @@ int mc_server_add_item_to_playlist(mc_server_h server, mc_playlist_h playlist, c /** * @brief Registers items to the playlist. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -1054,7 +1054,7 @@ int mc_server_update_playlist_done(mc_server_h server, mc_playlist_h playlist); /** * @brief Deletes the playlist of the media controller server. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server @@ -1084,7 +1084,7 @@ int mc_server_delete_playlist(mc_server_h server, mc_playlist_h playlist); * @details 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, callback will not be invoked. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/mediacontroller.server diff --git a/include/media_controller_type.h b/include/media_controller_type.h index 948f41a..daea6c2 100755 --- a/include/media_controller_type.h +++ b/include/media_controller_type.h @@ -61,7 +61,7 @@ typedef void *mc_metadata_h; /** * @brief The structure type for the media controller playlist handle. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif */ typedef void *mc_playlist_h; @@ -119,15 +119,15 @@ typedef enum { MC_PLAYBACK_STATE_PREV_FILE, /**< Previous file (Deprecated since 4.0)*/ MC_PLAYBACK_STATE_FAST_FORWARD, /**< Fast forward (Deprecated since 4.0)*/ MC_PLAYBACK_STATE_REWIND, /**< Rewind (Deprecated since 4.0)*/ - MC_PLAYBACK_STATE_MOVING_TO_NEXT, /**< Moving to the next item (Since 4.0)*/ - MC_PLAYBACK_STATE_MOVING_TO_PREVIOUS, /**< Moving to the previous item (Since 4.0)*/ - MC_PLAYBACK_STATE_FAST_FORWARDING, /**< Fast forwarding (Since 4.0)*/ - MC_PLAYBACK_STATE_REWINDING, /**< Rewinding (Since 4.0)*/ + MC_PLAYBACK_STATE_MOVING_TO_NEXT, /**< Moving to the next item (Since @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif) */ + MC_PLAYBACK_STATE_MOVING_TO_PREVIOUS, /**< Moving to the previous item (Since @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif) */ + MC_PLAYBACK_STATE_FAST_FORWARDING, /**< Fast forwarding (Since @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif) */ + MC_PLAYBACK_STATE_REWINDING, /**< Rewinding (Since @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif) */ } mc_playback_states_e; /** * @brief Enumeration for the media playback action. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif */ typedef enum { MC_PLAYBACK_ACTION_PLAY, /**< Play */ @@ -156,7 +156,7 @@ typedef enum { typedef enum { MC_REPEAT_MODE_ON = 0, /**< Repeat mode on for all media*/ MC_REPEAT_MODE_OFF, /**< Repeat mode off */ - MC_REPEAT_MODE_ONE_MEDIA, /**< Repeat mode on for one media (Since 4.0)*/ + MC_REPEAT_MODE_ONE_MEDIA, /**< Repeat mode on for one media (Since @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif) */ } mc_repeat_mode_e; /** @@ -169,12 +169,12 @@ typedef enum { MC_SUBSCRIPTION_TYPE_METADATA, /**< Metadata */ MC_SUBSCRIPTION_TYPE_SHUFFLE_MODE, /**< Shuffle mode */ MC_SUBSCRIPTION_TYPE_REPEAT_MODE, /**< Repeat mode */ - MC_SUBSCRIPTION_TYPE_PLAYLIST, /**< Playlist (Since 4.0) */ + MC_SUBSCRIPTION_TYPE_PLAYLIST, /**< Playlist (Since @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif) */ } mc_subscription_type_e; /** * @brief Enumeration for the playlist update mode. - * @since_tizen 4.0 + * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif */ typedef enum { MC_PLAYLIST_UPDATED, /**< Create or Update playlist */