[ACR-1268]Change APIs profile for the newly added ones. From Common to Mobile only 15/184415/11 accepted/tizen/4.0/unified/20180719.160958 submit/tizen_4.0/20180719.092500
authorhj kim <backto.kim@samsung.com>
Wed, 18 Jul 2018 02:27:25 +0000 (11:27 +0900)
committerhj kim <backto.kim@samsung.com>
Thu, 19 Jul 2018 09:24:14 +0000 (09:24 +0000)
Change-Id: If84e173763253ebbd16172d5c832c4aa37d2570e

doc/media_controller_doc.h
include/media_controller_client.h
include/media_controller_metadata.h
include/media_controller_playlist.h
include/media_controller_server.h
include/media_controller_type.h

index 4642c1f022ba5e71eb6caf050b26781d09b17936..6992a26e682f418cb84061aef208ed618c4f0ad0 100755 (executable)
@@ -39,7 +39,7 @@
  *
  * @section CAPI_MEDIA_CONTROLLER_OVERVIEW Overview
  * The @ref CAPI_MEDIA_CONTROLLER_MODULE API provides a set of functions to an effective communication between the server and the client for delivering the latest server information. It helps to transfer the information like playback info, shuffle mode, or the metadata of the latest server.  \n
- * To programming the interface, first, create a handler via #mc_client_create() or #mc_server_create(). And then, the client request the necessary information to the server by using #mc_client_set_server_updated_cb(), or #mc_client_set_playback_updated_cb(). The server provides the requested information to the client by the callback.
+ * To programming the interface, first, create a handler via #mc_client_create() or #mc_server_create(). And then, the client request the necessary information to the server by using @if MOBILE #mc_client_set_server_updated_cb(), or #mc_client_set_playback_updated_cb() @elseif WEARABLE #mc_client_set_server_update_cb(), or #mc_client_set_playback_update_cb() @endif. The server provides the requested information to the client by the callback.
  *
  */
 
@@ -51,7 +51,7 @@
 *      \#include <media_controller_server.h>
 *
 * @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() @if MOBILE, #mc_server_set_playlist_item_index() @endif), the metadata (#mc_server_set_metadata() @if MOBILE and playlist (#mc_server_set_playlist_item_index(), #mc_server_create_playlist()) @endif. and to receive the custom command (@if MOBILE #mc_server_set_custom_cmd_received_cb() @elseif WEARABLE #mc_server_set_custom_command_received_cb() @endif), 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()).
 *
 */
@@ -64,7 +64,8 @@
 *      \#include <media_controller_client.h>
 *
 * @section CAPI_MEDIA_CONTROLLER_CLIENT_MODULE_OVERVIEW Overview
-* The @ref CAPI_MEDIA_CONTROLLER_CLIENT_MODULE 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()). \n
+* The @ref CAPI_MEDIA_CONTROLLER_CLIENT_MODULE API allows you to check the activated server status @if MOBILE (#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()). \n
+* @elseif WEARABLE (#mc_client_set_server_update_cb()), the playback info (#mc_client_set_playback_update_cb()), the metadata (#mc_client_set_metadata_update_cb())). \n @endif
 * And client can send the custom command to server(#mc_client_send_custom_command()). \n
 * 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().
@@ -72,6 +73,7 @@
 */
 
 /**
+* @MOBILE_ONLY
 * @ingroup CAPI_MEDIA_CONTROLLER_MODULE
 * @defgroup CAPI_MEDIA_CONTROLLER_PLAYLIST_MODULE Media Controller Playlist
 * @brief The @ref CAPI_MEDIA_CONTROLLER_PLAYLIST_MODULE API provides functions for playlist of the media.
@@ -85,6 +87,7 @@
 */
 
 /**
+* @MOBILE_ONLY
 * @ingroup CAPI_MEDIA_CONTROLLER_MODULE
 * @defgroup CAPI_MEDIA_CONTROLLER_METADATA_MODULE Media Controller Metadata
 * @brief The @ref CAPI_MEDIA_CONTROLLER_METADATA_MODULE API provides functions for media metadata.
index 9a9e22fe5a0ad60f756ac3e6dda0e29e400849b6..d61841f0ab30c1b360799ea5f87d12d663fcfd3f 100755 (executable)
@@ -47,11 +47,11 @@ extern "C" {
  *
  * @param[in] server_name The app_id of the media controller server which sent the notification.
  * @param[in] state The state of the updated media controller server
- * @param[in] user_data        The user data passed from the mc_client_set_server_updated_cb() function
+ * @param[in] user_data        The user data passed from the @if MOBILE mc_client_set_server_updated_cb() @elseif WEARABLE mc_client_set_server_update_cb()@endif function
  *
- * @pre mc_client_set_server_updated_cb()
+ * @pre @if MOBILE mc_client_set_server_updated_cb() @elseif WEARABLE mc_client_set_server_update_cb() @endif
  *
- * @see mc_client_set_server_updated_cb()
+ * @see @if MOBILE mc_client_set_server_updated_cb() @elseif WEARABLE mc_client_set_server_update_cb() @endif
  */
 typedef void (*mc_server_state_updated_cb)(const char *server_name, mc_server_state_e state, void *user_data);
 
@@ -66,14 +66,14 @@ typedef void (*mc_server_state_updated_cb)(const char *server_name, mc_server_st
  *
  * @param[in] server_name The app_id of the media controller server which sent the notification.
  * @param[in] playback The playback information of the updated media controller server.
- * @param[in] user_data        The user data passed from the mc_client_set_playback_updated_cb() function
+ * @param[in] user_data        The user data passed from the @if MOBILE mc_client_set_playback_updated_cb() @elseif WEARABLE mc_client_set_playback_update_cb() @endif function
  *
- * @pre mc_client_set_playback_updated_cb()
+ * @pre @if MOBILE mc_client_set_playback_updated_cb() @elseif WEARABLE mc_client_set_playback_update_cb() @endif
  *
- * @see mc_client_set_playback_updated_cb()
+ * @see @if MOBILE mc_client_set_playback_updated_cb() @elseif WEARABLE mc_client_set_playback_update_cb() @endif
  * @see mc_client_get_playback_state()
  * @see mc_client_get_playback_position()
- * @see mc_client_get_playlist_item_index()
+ * @if MOBILE @see mc_client_get_playlist_item_index() @endif
  */
 typedef void (*mc_playback_updated_cb)(const char *server_name, mc_playback_h playback, void *user_data);
 
@@ -84,21 +84,21 @@ typedef void (*mc_playback_updated_cb)(const char *server_name, mc_playback_h pl
  * @remarks The callback is called in the dbus event loop.
  *               The @a server_name and @a metadata should not be released by the application. \n
  *               The @a server_name can be used only in the callback. To use outside, make a copy.
- *               And @a metadata also can be used only in the callback. To use outside, make a copy using mc_metadata_clone() \n
+ *               And @a metadata also can be used only in the callback. @if MOBILE To use outside, make a copy using mc_metadata_clone() @endif\n
  *
  * @param[in] server_name The app_id of the media controller server which sent the notification.
  * @param[in] metadata the metadata of the updated media controller server.
- * @param[in] user_data        The user data passed from the mc_client_set_metadata_updated_cb() function
+ * @param[in] user_data        The user data passed from the @if MOBILE mc_client_set_metadata_updated_cb() @elseif WEARABLE mc_client_set_metadata_update_cb @endif function
  *
- * @pre mc_client_set_metadata_updated_cb()
+ * @pre @if MOBILE mc_client_set_metadata_updated_cb() @elseif WEARABLE mc_client_set_metadata_update_cb() @endif
  *
- * @see mc_client_set_metadata_updated_cb()
- * @see mc_metadata_get()
+ * @see @if MOBILE mc_client_set_metadata_updated_cb() @elseif WEARABLE mc_client_set_metadata_update_cb() @endif
+ * @see @if MOBILE mc_metadata_get() @elseif WEARABLE mc_client_get_metadata() @endif
  */
 typedef void (*mc_metadata_updated_cb)(const char *server_name, mc_metadata_h metadata, void *user_data);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_shuffle_mode_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_shuffle_mode_updated_cb() instead. @endif
  * @brief Called when updating the shuffle mode of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -115,7 +115,7 @@ typedef void (*mc_metadata_updated_cb)(const char *server_name, mc_metadata_h me
 typedef void (*mc_shuffle_mode_changed_cb)(const char *server_name, mc_shuffle_mode_e mode, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_repeat_mode_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_repeat_mode_updated_cb() instead. @endif
  * @brief Called when updating the repeat mode of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -132,6 +132,7 @@ typedef void (*mc_shuffle_mode_changed_cb)(const char *server_name, mc_shuffle_m
 typedef void (*mc_repeat_mode_changed_cb)(const char *server_name, mc_repeat_mode_e mode, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when updating the shuffle mode of the media controller server.
  * @since_tizen 4.0
  *
@@ -150,6 +151,7 @@ typedef void (*mc_repeat_mode_changed_cb)(const char *server_name, mc_repeat_mod
 typedef void (*mc_shuffle_mode_updated_cb)(const char *server_name, mc_shuffle_mode_e mode, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when updating the repeat mode of the media controller server.
  * @since_tizen 4.0
  *
@@ -188,7 +190,7 @@ typedef void (*mc_repeat_mode_updated_cb)(const char *server_name, mc_repeat_mod
 typedef bool (*mc_activated_server_cb)(const char *server_name, void *user_data);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_cmd_reply_received_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_cmd_reply_received_cb() instead. @endif
  * @brief Called when receiving the command processing result from the server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -206,6 +208,7 @@ typedef bool (*mc_activated_server_cb)(const char *server_name, void *user_data)
 typedef void (*mc_command_reply_received_cb)(const char *server_name, int result_code, bundle *data, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when the result of the command from the server is received.
  * @since_tizen 4.0
  *
@@ -247,6 +250,7 @@ typedef void (*mc_cmd_reply_received_cb)(const char *server_name, const char *re
 typedef bool (*mc_subscribed_server_cb)(const char *server_name, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when updating the playlist of the media controller server.
  * @since_tizen 4.0
  *
@@ -269,6 +273,7 @@ typedef bool (*mc_subscribed_server_cb)(const char *server_name, void *user_data
 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);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when receiving custom event of media controller servers.
  * @since_tizen 4.0
  *
@@ -314,7 +319,7 @@ typedef void (*mc_client_custom_event_received_cb)(const char *server_name, cons
 int mc_client_create(mc_client_h *client);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_set_server_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_set_server_updated_cb() instead. @endif
  * @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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -337,7 +342,7 @@ int mc_client_create(mc_client_h *client);
 int mc_client_set_server_update_cb(mc_client_h client, mc_server_state_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_unset_server_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_unset_server_updated_cb() instead. @endif
  * @brief Unsets the callback for monitoring status of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -357,7 +362,7 @@ int mc_client_set_server_update_cb(mc_client_h client, mc_server_state_updated_c
 int mc_client_unset_server_update_cb(mc_client_h client) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_set_playback_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_set_playback_updated_cb() instead. @endif
  * @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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -380,7 +385,7 @@ int mc_client_unset_server_update_cb(mc_client_h client) TIZEN_DEPRECATED_API;
 int mc_client_set_playback_update_cb(mc_client_h client, mc_playback_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_unset_playback_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_unset_playback_updated_cb() instead. @endif
  * @brief Unsets the callback for monitoring playback status of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -400,7 +405,7 @@ int mc_client_set_playback_update_cb(mc_client_h client, mc_playback_updated_cb
 int mc_client_unset_playback_update_cb(mc_client_h client) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_set_metadata_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_set_metadata_updated_cb() instead. @endif
  * @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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -423,7 +428,7 @@ int mc_client_unset_playback_update_cb(mc_client_h client) TIZEN_DEPRECATED_API;
 int mc_client_set_metadata_update_cb(mc_client_h client, mc_metadata_updated_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_unset_metadata_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_unset_metadata_updated_cb() instead. @endif
  * @brief Unsets the callback for monitoring metadata status of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -443,7 +448,7 @@ int mc_client_set_metadata_update_cb(mc_client_h client, mc_metadata_updated_cb
 int mc_client_unset_metadata_update_cb(mc_client_h client) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_set_shuffle_mode_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_set_shuffle_mode_updated_cb() instead. @endif
  * @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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -466,7 +471,7 @@ int mc_client_unset_metadata_update_cb(mc_client_h client) TIZEN_DEPRECATED_API;
 int mc_client_set_shuffle_mode_update_cb(mc_client_h client, mc_shuffle_mode_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_unset_shuffle_mode_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_unset_shuffle_mode_updated_cb() instead. @endif
  * @brief Unsets the callback for monitoring shuffle mode of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -486,7 +491,7 @@ int mc_client_set_shuffle_mode_update_cb(mc_client_h client, mc_shuffle_mode_cha
 int mc_client_unset_shuffle_mode_update_cb(mc_client_h client) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_set_repeat_mode_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_set_repeat_mode_updated_cb() instead. @endif
  * @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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -509,7 +514,7 @@ int mc_client_unset_shuffle_mode_update_cb(mc_client_h client) TIZEN_DEPRECATED_
 int mc_client_set_repeat_mode_update_cb(mc_client_h client, mc_repeat_mode_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_unset_repeat_mode_updated_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_unset_repeat_mode_updated_cb() instead. @endif
  * @brief Unsets the callback for monitoring repeat mode of the media controller server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -529,6 +534,7 @@ int mc_client_set_repeat_mode_update_cb(mc_client_h client, mc_repeat_mode_chang
 int mc_client_unset_repeat_mode_update_cb(mc_client_h client) TIZEN_DEPRECATED_API;
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -551,6 +557,7 @@ int mc_client_unset_repeat_mode_update_cb(mc_client_h client) TIZEN_DEPRECATED_A
 int mc_client_set_server_updated_cb(mc_client_h client, mc_server_state_updated_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for monitoring status of the media controller server.
  * @since_tizen 4.0
  *
@@ -570,6 +577,7 @@ int mc_client_set_server_updated_cb(mc_client_h client, mc_server_state_updated_
 int mc_client_unset_server_updated_cb(mc_client_h client);
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -592,6 +600,7 @@ int mc_client_unset_server_updated_cb(mc_client_h client);
 int mc_client_set_playback_updated_cb(mc_client_h client, mc_playback_updated_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for monitoring playback status of the media controller server.
  * @since_tizen 4.0
  *
@@ -611,6 +620,7 @@ int mc_client_set_playback_updated_cb(mc_client_h client, mc_playback_updated_cb
 int mc_client_unset_playback_updated_cb(mc_client_h client);
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -633,6 +643,7 @@ int mc_client_unset_playback_updated_cb(mc_client_h client);
 int mc_client_set_metadata_updated_cb(mc_client_h client, mc_metadata_updated_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for monitoring metadata status of the media controller server.
  * @since_tizen 4.0
  *
@@ -652,6 +663,7 @@ int mc_client_set_metadata_updated_cb(mc_client_h client, mc_metadata_updated_cb
 int mc_client_unset_metadata_updated_cb(mc_client_h client);
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -674,6 +686,7 @@ int mc_client_unset_metadata_updated_cb(mc_client_h client);
 int mc_client_set_shuffle_mode_updated_cb(mc_client_h client, mc_shuffle_mode_updated_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for monitoring shuffle mode of the media controller server.
  * @since_tizen 4.0
  *
@@ -693,6 +706,7 @@ int mc_client_set_shuffle_mode_updated_cb(mc_client_h client, mc_shuffle_mode_up
 int mc_client_unset_shuffle_mode_updated_cb(mc_client_h client);
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -715,6 +729,7 @@ int mc_client_unset_shuffle_mode_updated_cb(mc_client_h client);
 int mc_client_set_repeat_mode_updated_cb(mc_client_h client, mc_repeat_mode_updated_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for monitoring repeat mode of the media controller server.
  * @since_tizen 4.0
  *
@@ -734,6 +749,7 @@ int mc_client_set_repeat_mode_updated_cb(mc_client_h client, mc_repeat_mode_upda
 int mc_client_unset_repeat_mode_updated_cb(mc_client_h client);
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -757,6 +773,7 @@ int mc_client_unset_repeat_mode_updated_cb(mc_client_h client);
 int mc_client_set_cmd_reply_received_cb(mc_client_h client, mc_cmd_reply_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving common reply of the media controller server.
  * @since_tizen 4.0
  *
@@ -777,6 +794,7 @@ int mc_client_set_cmd_reply_received_cb(mc_client_h client, mc_cmd_reply_receive
 int mc_client_unset_cmd_reply_received_cb(mc_client_h client);
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -803,6 +821,7 @@ int mc_client_unset_cmd_reply_received_cb(mc_client_h client);
 int mc_client_set_playlist_updated_cb(mc_client_h client, mc_playlist_updated_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for monitoring playlist status of the media controller server.
  * @since_tizen 4.0
  *
@@ -823,6 +842,7 @@ int mc_client_set_playlist_updated_cb(mc_client_h client, mc_playlist_updated_cb
 int mc_client_unset_playlist_updated_cb(mc_client_h client);
 
 /**
+ * @MOBILE_ONLY
  * @brief Sets the callback for receiving the custom event from a media controller server.
  * @since_tizen 4.0
  *
@@ -848,6 +868,7 @@ int mc_client_unset_playlist_updated_cb(mc_client_h client);
 int mc_client_set_custom_event_received_cb(mc_client_h client, mc_client_custom_event_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving the custom event from a media controller server.
  * @since_tizen 4.0
  *
@@ -869,6 +890,7 @@ int mc_client_set_custom_event_received_cb(mc_client_h client, mc_client_custom_
 int mc_client_unset_custom_event_received_cb(mc_client_h client);
 
 /**
+ * @MOBILE_ONLY
  * @brief Replies with the result of the requested event to the media controller server.
  * @since_tizen 4.0
  *
@@ -991,8 +1013,8 @@ int mc_client_foreach_server_subscribed(mc_client_h client, mc_subscription_type
  * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful
  * @retval #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- * @pre The playback update callback should be set with mc_client_set_playback_updated_cb().
- * @see mc_client_set_playback_updated_cb()
+ * @pre The playback update callback should be set with @if MOBILE mc_client_set_playback_updated_cb() @elseif WEARABLE mc_client_set_playback_update_cb() @endif.
+ * @see @if MOBILE mc_client_set_playback_updated_cb() @elseif WEARABLE mc_client_set_playback_update_cb() @endif
  */
 int mc_client_get_playback_state(mc_playback_h playback, mc_playback_states_e *state);
 
@@ -1010,12 +1032,13 @@ int mc_client_get_playback_state(mc_playback_h playback, mc_playback_states_e *s
  * @retval #MEDIA_CONTROLLER_ERROR_NONE Successful
  * @retval #MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTROLLER_ERROR_PERMISSION_DENIED Permission denied
- * @pre The playback update callback should be set with mc_client_set_playback_updated_cb().
- * @see mc_client_set_playback_updated_cb()
+ * @pre The playback update callback should be set with @if MOBILE mc_client_set_playback_updated_cb() @elseif WEARABLE mc_client_set_playback_update_cb() @endif.
+ * @see @if MOBILE mc_client_set_playback_updated_cb() @elseif WEARABLE mc_client_set_playback_update_cb() @endif
  */
 int mc_client_get_playback_position(mc_playback_h playback, unsigned long long *position);
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -1049,13 +1072,13 @@ 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 @if MOBILE mc_client_set_playback_updated_cb() @elseif WEARABLE mc_client_set_playback_update_cb() @endif
+ * @see mc_client_get_server_playback_info()
  */
 int mc_client_destroy_playback(mc_playback_h playback);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_metadata_get() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_metadata_get() instead. @endif
  * @brief Gets the metadata.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -1076,7 +1099,7 @@ int mc_client_destroy_playback(mc_playback_h playback);
 int mc_client_get_metadata(mc_metadata_h metadata, mc_meta_e attribute, char **value) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_metadata_destroy() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_metadata_destroy() instead. @endif
  * @brief Destroys metadata.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -1146,7 +1169,7 @@ int mc_client_get_server_playback_info(mc_client_h client, const char *server_na
  * @privlevel public
  * @privilege %http://tizen.org/privilege/mediacontroller.client
  *
- * @remarks The @a metadata should be released using @c mc_metadata_destroy(). \n
+ * @remarks The @a metadata should be released using @if MOBILE @c mc_metadata_destroy() @elseif @c mc_client_destroy_metadata(). @endif\n
  *                   If there is no metadata, return value of the metadata is NULL.
  *
  * @param[in] client    The handle to the media controller client
@@ -1226,6 +1249,7 @@ int mc_client_get_server_repeat_mode(mc_client_h client, const char *server_name
 int mc_client_foreach_server(mc_client_h client, mc_activated_server_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Retrieves all playlists of the media controller server.
  * @details This function gets all playlists of the media controller server.
  *            The callback function will be invoked for every retrieved playlist.
@@ -1255,7 +1279,7 @@ int mc_client_foreach_server(mc_client_h client, mc_activated_server_cb callback
 int mc_client_foreach_server_playlist(mc_client_h client, const char *server_name, mc_playlist_cb callback, void *user_data);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_send_playback_action_cmd() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_send_playback_action_cmd() instead. @endif
  * @brief Sends the playback state command to server.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -1277,6 +1301,7 @@ int mc_client_foreach_server_playlist(mc_client_h client, const char *server_nam
 int mc_client_send_playback_state_command(mc_client_h client, const char *server_name, mc_playback_states_e state) TIZEN_DEPRECATED_API;
 
 /**
+ * @MOBILE_ONLY
  * @brief Sends the playback action command to server.
  * @since_tizen 4.0
  *
@@ -1303,6 +1328,7 @@ int mc_client_send_playback_state_command(mc_client_h client, const char *server
 int mc_client_send_playback_action_cmd(mc_client_h client, const char *server_name, mc_playback_action_e action, char **request_id);
 
 /**
+ * @MOBILE_ONLY
  * @brief Sends the playback position command to server.
  * @since_tizen 4.0
  *
@@ -1329,6 +1355,7 @@ int mc_client_send_playback_action_cmd(mc_client_h client, const char *server_na
 int mc_client_send_playback_position_cmd(mc_client_h client, const char *server_name, unsigned long long position, char **request_id);
 
 /**
+ * @MOBILE_ONLY
  * @brief Sends the shuffle mode command to server.
  * @since_tizen 4.0
  *
@@ -1355,6 +1382,7 @@ int mc_client_send_playback_position_cmd(mc_client_h client, const char *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);
 
 /**
+ * @MOBILE_ONLY
  * @brief Sends the repeat mode command to server.
  * @since_tizen 4.0
  *
@@ -1381,7 +1409,7 @@ int mc_client_send_shuffle_mode_cmd(mc_client_h client, const char *server_name,
 int mc_client_send_repeat_mode_cmd(mc_client_h client, const char *server_name, mc_repeat_mode_e repeat_mode, char **request_id);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_client_send_custom_cmd() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_client_send_custom_cmd() instead. @endif
  * @brief Sends the custom command to server.
  * @details 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_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -1406,6 +1434,7 @@ int mc_client_send_repeat_mode_cmd(mc_client_h client, const char *server_name,
 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;
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -1435,6 +1464,7 @@ int mc_client_send_custom_command(mc_client_h client, const char *server_name, c
 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);
 
 /**
+ * @MOBILE_ONLY
  * @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
index 5c63c8195b67b1d98e3dfbed2e3a2683045d13f7..3e3eaebdb82a320125b2dced552be0a9dd41ad86 100755 (executable)
@@ -35,6 +35,7 @@ extern "C" {
  */
 
 /**
+ * @MOBILE_ONLY
  * @brief Clones a media controller metadata handle.
  * @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.
@@ -58,6 +59,7 @@ extern "C" {
 int mc_metadata_clone(mc_metadata_h src, mc_metadata_h *dst);
 
 /**
+ * @MOBILE_ONLY
  * @brief Destroys a media controller metadata handle.
  * @details This function frees all resources related to the media controller metadata handle. This
  *          handle no longer can be used to perform any operations. A new handle has to
@@ -78,6 +80,7 @@ int mc_metadata_clone(mc_metadata_h src, mc_metadata_h *dst);
 int mc_metadata_destroy(mc_metadata_h metadata);
 
 /**
+ * @MOBILE_ONLY
  * @brief Gets the metadata.
  * @since_tizen 4.0
  *
index 2f5bdd6764971b29dbf082532a493ceaf2727667..79e2778aa4ca9e52b6dd762375960744129f9e75 100755 (executable)
@@ -35,6 +35,7 @@ extern "C" {
  */
 
 /**
+ * @MOBILE_ONLY
  * @brief Called for every playlist.
  *
  * @since_tizen 4.0
@@ -60,6 +61,7 @@ extern "C" {
 typedef bool (*mc_playlist_cb)(mc_playlist_h playlist, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called for every playlist item in the playlist.
  *
  * @since_tizen 4.0
@@ -85,6 +87,7 @@ typedef bool (*mc_playlist_cb)(mc_playlist_h playlist, void *user_data);
 typedef bool (*mc_playlist_item_cb)(const char *index, mc_metadata_h metadata, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Gets the name of the playlist.
  * @since_tizen 4.0
  *
@@ -109,6 +112,7 @@ typedef bool (*mc_playlist_item_cb)(const char *index, mc_metadata_h metadata, v
 int mc_playlist_get_name(mc_playlist_h playlist, char **playlist_name);
 
 /**
+ * @MOBILE_ONLY
  * @brief Iterates through media items in a playlist.
  * @details This function gets all items in a playlist.
  *          The callback function will be invoked for every retrieved playlist item.
@@ -138,6 +142,7 @@ int mc_playlist_get_name(mc_playlist_h playlist, char **playlist_name);
 int mc_playlist_foreach_item(mc_playlist_h playlist, mc_playlist_item_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Clones a media controller playlist handle.
  * @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.
@@ -161,6 +166,7 @@ int mc_playlist_foreach_item(mc_playlist_h playlist, mc_playlist_item_cb callbac
 int mc_playlist_clone(mc_playlist_h src, mc_playlist_h *dst);
 
 /**
+ * @MOBILE_ONLY
  * @brief Destroys a media controller playlist handle.
  * @details This function frees all resources related to the media controller playlist handle. This
  *          handle no longer can be used to perform any operations. A new handle has to
index fd04d6d2ee1b843b78c3262d8b4ed289e4b6a916..3341e3d80ab2bc3b586b810b3fab55dbf67c94dd 100755 (executable)
@@ -38,7 +38,7 @@ extern "C" {
  */
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_server_playback_action_cmd_received_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_server_playback_action_cmd_received_cb() instead. @endif
  * @brief Called when the server receives the playback state from the client.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -57,6 +57,7 @@ extern "C" {
 typedef void (*mc_server_playback_state_command_received_cb)(const char* client_name, mc_playback_states_e state, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when the server receives the playback action command from the client.
  * @since_tizen 4.0
  *
@@ -78,6 +79,7 @@ typedef void (*mc_server_playback_state_command_received_cb)(const char* client_
 typedef void (*mc_server_playback_action_cmd_received_cb)(const char* client_name, const char *request_id, mc_playback_action_e action, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when the server receives the playback position from the client.
  * @since_tizen 4.0
  *
@@ -99,6 +101,7 @@ typedef void (*mc_server_playback_action_cmd_received_cb)(const char* client_nam
 typedef void (*mc_server_playback_position_cmd_received_cb)(const char* client_name, const char *request_id, unsigned long long position, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when the server receives the shuffle mode from the client.
  * @since_tizen 4.0
  *
@@ -120,6 +123,7 @@ typedef void (*mc_server_playback_position_cmd_received_cb)(const char* client_n
 typedef void (*mc_server_shuffle_mode_cmd_received_cb)(const char* client_name, const char *request_id, mc_shuffle_mode_e shuffle_mode, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when the server receives the repeat mode from the client.
  * @since_tizen 4.0
  *
@@ -141,7 +145,7 @@ typedef void (*mc_server_shuffle_mode_cmd_received_cb)(const char* client_name,
 typedef void (*mc_server_repeat_mode_cmd_received_cb)(const char* client_name, const char *request_id, mc_repeat_mode_e repeat_mode, void *user_data);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_server_custom_cmd_received_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_server_custom_cmd_received_cb() instead. @endif
  * @brief Called when the Server receives custom command from the client.
  * @details This callback is called when server receives custom command from client.
  *                If there is reply for command, call mc_server_send_command_reply() function.
@@ -163,6 +167,7 @@ typedef void (*mc_server_repeat_mode_cmd_received_cb)(const char* client_name, c
 typedef void (*mc_server_custom_command_received_cb)(const char* client_name, const char *command, bundle *data, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when the Server receives playlist command from the client.
  * @since_tizen 4.0
  *
@@ -187,6 +192,7 @@ typedef void (*mc_server_custom_command_received_cb)(const char* client_name, co
 typedef void (*mc_server_playlist_cmd_received_cb)(const char* client_name, const char *request_id, const char *playlist_name, const char *index, mc_playback_action_e action, unsigned long long position, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @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.
@@ -212,6 +218,7 @@ typedef void (*mc_server_playlist_cmd_received_cb)(const char* client_name, cons
 typedef void (*mc_server_custom_cmd_received_cb)(const char* client_name, const char *request_id, const char *command, bundle *data, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when requesting the list of created clients.
  * @since_tizen 4.0
  *
@@ -232,6 +239,7 @@ typedef void (*mc_server_custom_cmd_received_cb)(const char* client_name, const
 typedef bool (*mc_activated_client_cb)(const char *client_name, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Called when the result of the event from the client is received.
  * @since_tizen 4.0
  *
@@ -323,8 +331,9 @@ int mc_server_set_playback_state(mc_server_h server, mc_playback_states_e state)
 int mc_server_set_playback_position(mc_server_h server, unsigned long long position);
 
 /**
+ * @MOBILE_ONLY
  * @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
  *
@@ -460,7 +469,7 @@ int mc_server_update_shuffle_mode(mc_server_h server, mc_shuffle_mode_e mode);
 int mc_server_update_repeat_mode(mc_server_h server, mc_repeat_mode_e mode);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_server_set_playback_action_cmd_received_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_server_set_playback_action_cmd_received_cb() instead. @endif
  * @brief Sets the callback for receiving playback state command from client.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -482,7 +491,7 @@ int mc_server_update_repeat_mode(mc_server_h server, mc_repeat_mode_e mode);
 int mc_server_set_playback_state_command_received_cb(mc_server_h server, mc_server_playback_state_command_received_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_server_unset_playback_action_cmd_received_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_server_unset_playback_action_cmd_received_cb() instead. @endif
  * @brief Unsets the callback for receiving playback state command from client.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -502,6 +511,7 @@ int mc_server_set_playback_state_command_received_cb(mc_server_h server, mc_serv
 int mc_server_unset_playback_state_command_received_cb(mc_server_h server) TIZEN_DEPRECATED_API;
 
 /**
+ * @MOBILE_ONLY
  * @brief Sets the callback for receiving playback action command from client.
  * @since_tizen 4.0
  *
@@ -523,6 +533,7 @@ int mc_server_unset_playback_state_command_received_cb(mc_server_h server) TIZEN
 int mc_server_set_playback_action_cmd_received_cb(mc_server_h server, mc_server_playback_action_cmd_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving playback action command from client.
  * @since_tizen 4.0
  *
@@ -542,6 +553,7 @@ int mc_server_set_playback_action_cmd_received_cb(mc_server_h server, mc_server_
 int mc_server_unset_playback_action_cmd_received_cb(mc_server_h server);
 
 /**
+ * @MOBILE_ONLY
  * @brief Sets the callback for receiving playback position command from client.
  * @since_tizen 4.0
  *
@@ -563,6 +575,7 @@ int mc_server_unset_playback_action_cmd_received_cb(mc_server_h server);
 int mc_server_set_playback_position_cmd_received_cb(mc_server_h server, mc_server_playback_position_cmd_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving playback position command from client.
  * @since_tizen 4.0
  *
@@ -582,6 +595,7 @@ int mc_server_set_playback_position_cmd_received_cb(mc_server_h server, mc_serve
 int mc_server_unset_playback_position_cmd_received_cb(mc_server_h server);
 
 /**
+ * @MOBILE_ONLY
  * @brief Sets the callback for receiving shuffle mode command from client.
  * @since_tizen 4.0
  *
@@ -603,6 +617,7 @@ int mc_server_unset_playback_position_cmd_received_cb(mc_server_h server);
 int mc_server_set_shuffle_mode_cmd_received_cb(mc_server_h server, mc_server_shuffle_mode_cmd_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving shuffle mode command from client.
  * @since_tizen 4.0
  *
@@ -622,6 +637,7 @@ int mc_server_set_shuffle_mode_cmd_received_cb(mc_server_h server, mc_server_shu
 int mc_server_unset_shuffle_mode_cmd_received_cb(mc_server_h server);
 
 /**
+ * @MOBILE_ONLY
  * @brief Sets the callback for receiving repeat mode command from client.
  * @since_tizen 4.0
  *
@@ -643,6 +659,7 @@ int mc_server_unset_shuffle_mode_cmd_received_cb(mc_server_h server);
 int mc_server_set_repeat_mode_cmd_received_cb(mc_server_h server, mc_server_repeat_mode_cmd_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving repeat mode command from client.
  * @since_tizen 4.0
  *
@@ -662,7 +679,7 @@ int mc_server_set_repeat_mode_cmd_received_cb(mc_server_h server, mc_server_repe
 int mc_server_unset_repeat_mode_cmd_received_cb(mc_server_h server);
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_server_set_custom_cmd_received_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_server_set_custom_cmd_received_cb() instead. @endif
  * @brief Sets the callback for receiving custom command from client.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -684,7 +701,7 @@ int mc_server_unset_repeat_mode_cmd_received_cb(mc_server_h server);
 int mc_server_set_custom_command_received_cb(mc_server_h server, mc_server_custom_command_received_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_server_unset_custom_cmd_received_cb() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_server_unset_custom_cmd_received_cb() instead. @endif
  * @brief Unsets the callback for receiving custom command from client.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -704,7 +721,7 @@ int mc_server_set_custom_command_received_cb(mc_server_h server, mc_server_custo
 int mc_server_unset_custom_command_received_cb(mc_server_h server) TIZEN_DEPRECATED_API;
 
 /**
- * @deprecated Deprecated since 4.0. Use mc_server_send_cmd_reply() instead.
+ * @deprecated Deprecated since 4.0. @if MOBILE Use mc_server_send_cmd_reply() instead. @endif
  * @brief Sends a reply for the requested command to the client.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
@@ -723,13 +740,14 @@ 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()
  */
 int mc_server_send_command_reply(mc_server_h server, const char *client_name, int result_code, bundle *data) TIZEN_DEPRECATED_API;
 
 /**
+ * @MOBILE_ONLY
  * @brief Sets the callback for receiving playlist command from client.
  * @since_tizen 4.0
  *
@@ -751,6 +769,7 @@ int mc_server_send_command_reply(mc_server_h server, const char *client_name, in
 int mc_server_set_playlist_cmd_received_cb(mc_server_h server, mc_server_playlist_cmd_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving playlist command from client.
  * @since_tizen 4.0
  *
@@ -770,6 +789,7 @@ int mc_server_set_playlist_cmd_received_cb(mc_server_h server, mc_server_playlis
 int mc_server_unset_playlist_cmd_received_cb(mc_server_h server);
 
 /**
+ * @MOBILE_ONLY
  * @brief Sets the callback for receiving custom command from client.
  * @since_tizen 4.0
  *
@@ -791,6 +811,7 @@ int mc_server_unset_playlist_cmd_received_cb(mc_server_h server);
 int mc_server_set_custom_cmd_received_cb(mc_server_h server, mc_server_custom_cmd_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving custom command from client.
  * @since_tizen 4.0
  *
@@ -810,6 +831,7 @@ int mc_server_set_custom_cmd_received_cb(mc_server_h server, mc_server_custom_cm
 int mc_server_unset_custom_cmd_received_cb(mc_server_h server);
 
 /**
+ * @MOBILE_ONLY
  * @brief Replies the result of the requested command to the client.
  * @since_tizen 4.0
  *
@@ -842,6 +864,7 @@ int mc_server_unset_custom_cmd_received_cb(mc_server_h server);
 int mc_server_send_cmd_reply(mc_server_h server, const char *client_name, const char *request_id, int result_code, bundle *data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Retrieves all created clients.
  * @details This function gets all created media controller clients.
  *          The callback function will be invoked for every created media controller client.
@@ -868,6 +891,7 @@ int mc_server_send_cmd_reply(mc_server_h server, const char *client_name, const
 int mc_server_foreach_client(mc_server_h server, mc_activated_client_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @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
@@ -898,6 +922,7 @@ int mc_server_foreach_client(mc_server_h server, mc_activated_client_cb callback
 int mc_server_send_custom_event(mc_server_h server, const char *client_name, const char *event, bundle *data, char **request_id);
 
 /**
+ * @MOBILE_ONLY
  * @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().
@@ -924,6 +949,7 @@ int mc_server_send_custom_event(mc_server_h server, const char *client_name, con
 int mc_server_set_event_reply_received_cb(mc_server_h server, mc_server_event_reply_received_cb callback, void *user_data);
 
 /**
+ * @MOBILE_ONLY
  * @brief Unsets the callback for receiving event reply of the media controller client.
  * @since_tizen 4.0
  *
@@ -958,6 +984,7 @@ int mc_server_unset_event_reply_received_cb(mc_server_h server);
 int mc_server_destroy(mc_server_h server);
 
 /**
+ * @MOBILE_ONLY
  * @brief Creates a new playlist with the given name.
  * @since_tizen 4.0
  *
@@ -991,6 +1018,7 @@ int mc_server_destroy(mc_server_h server);
 int mc_server_create_playlist(mc_server_h server, const char *playlist_name, mc_playlist_h *playlist);
 
 /**
+ * @MOBILE_ONLY
  * @brief Adds a new item to the playlist.
  * @since_tizen 4.0
  *
@@ -1026,6 +1054,7 @@ int mc_server_create_playlist(mc_server_h server, const char *playlist_name, mc_
 int mc_server_add_item_to_playlist(mc_server_h server, mc_playlist_h playlist, const char *index, mc_meta_e attribute, const char *value);
 
 /**
+ * @MOBILE_ONLY
  * @brief Registers items to the playlist.
  * @since_tizen 4.0
  *
@@ -1053,6 +1082,7 @@ int mc_server_add_item_to_playlist(mc_server_h server, mc_playlist_h playlist, c
 int mc_server_update_playlist_done(mc_server_h server, mc_playlist_h playlist);
 
 /**
+ * @MOBILE_ONLY
  * @brief Deletes the playlist of the media controller server.
  * @since_tizen 4.0
  *
@@ -1080,6 +1110,7 @@ int mc_server_update_playlist_done(mc_server_h server, mc_playlist_h playlist);
 int mc_server_delete_playlist(mc_server_h server, mc_playlist_h playlist);
 
 /**
+ * @MOBILE_ONLY
  * @brief Retrieves all playlists of the media controller server.
  * @details This function gets all playlists of the media controller server.
  *            The callback function will be invoked for every retrieved playlist.
index 948f41a9c4b72fd7211a75728f5e5b9192d75da9..1e377574b565132636f31cea024a8ba826baaa2b 100755 (executable)
@@ -60,6 +60,7 @@ typedef void *mc_playback_h;
 typedef void *mc_metadata_h;
 
 /**
+ * @MOBILE_ONLY
  * @brief The structure type for the media controller playlist handle.
  * @since_tizen 4.0
  */
@@ -119,15 +120,16 @@ 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 4.0) @if WEARABLE Supported in Mobile only @endif */
+       MC_PLAYBACK_STATE_MOVING_TO_PREVIOUS,   /**< Moving to the previous item (Since 4.0) @if WEARABLE Supported in Mobile only @endif */
+       MC_PLAYBACK_STATE_FAST_FORWARDING,              /**< Fast forwarding (Since 4.0) @if WEARABLE Supported in Mobile only @endif */
+       MC_PLAYBACK_STATE_REWINDING,                            /**< Rewinding (Since 4.0) @if WEARABLE Supported in Mobile only @endif */
 } mc_playback_states_e;
 
 /**
+ * @MOBILE_ONLY
  * @brief Enumeration for the media playback action.
- * @since_tizen 4.0
+ * @since_tizen 4.0 @if WEARABLE (Supported in Mobile only) @endif
  */
 typedef enum {
        MC_PLAYBACK_ACTION_PLAY,                                /**< Play */
@@ -156,7 +158,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 4.0) @if WEARABLE Supported in Mobile only @endif */
 } mc_repeat_mode_e;
 
 /**
@@ -169,12 +171,13 @@ 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 4.0) @if WEARABLE Supported in Mobile only @endif  */
 } mc_subscription_type_e;
 
 /**
+ * @MOBILE_ONLY
  * @brief Enumeration for the playlist update mode.
- * @since_tizen 4.0
+ * @since_tizen 4.0 @if WEARABLE (Supported in Mobile only) @endif
  */
 typedef enum {
        MC_PLAYLIST_UPDATED,    /**< Create or Update playlist */