Remove profile tag
[platform/core/api/media-content.git] / include_product / media_content_type.h
index 8b1ad04..d6235ff 100755 (executable)
@@ -41,7 +41,7 @@ extern "C" {
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for the media file format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, #MEDIA_CONTENT_TYPE_OTHERS is related to the following feature:\n
  *          %http://tizen.org/feature/content.scanning.others\n
  *          If this feature is not supported on the device, #MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
@@ -63,7 +63,7 @@ typedef enum {
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for media content DB update items.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        MEDIA_ITEM_FILE         = 0,            /**< File type, an item updated to DB */
@@ -74,7 +74,7 @@ typedef enum {
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for media content DB update types.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        MEDIA_CONTENT_INSERT            = 0,            /**< Insert, the type of DB update */
@@ -85,7 +85,7 @@ typedef enum {
 /**
  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  * @brief Enumeration for orientation types.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        MEDIA_CONTENT_ORIENTATION_NOT_AVAILABLE  = 0,       /**< Not available*/
@@ -102,7 +102,7 @@ typedef enum {
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for ordering.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        MEDIA_CONTENT_ORDER_ASC   = 0,      /**< Ascending order*/
@@ -113,7 +113,7 @@ typedef enum {
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for collations.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        MEDIA_CONTENT_COLLATE_DEFAULT   = 0,        /**< Default collation BINARY */
@@ -125,7 +125,7 @@ typedef enum {
 /**
 * @brief Error class.
 * @details Class for Media Content error
-* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+* @since_tizen 2.3
 *
 */
 #define MEDIA_CONTENT_ERROR_CLASS                              TIZEN_ERROR_MEDIA_CONTENT
@@ -133,7 +133,7 @@ typedef enum {
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for a media content error.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        MEDIA_CONTENT_ERROR_NONE                    = TIZEN_ERROR_NONE,                    /**< Successful */
@@ -152,7 +152,7 @@ typedef enum {
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for a media group.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        MEDIA_CONTENT_GROUP_DISPLAY_NAME = 0,    /**< Media group ID for display name */
@@ -232,66 +232,80 @@ typedef enum {
        MEDIA_GROUP_MAX,
 } media_group_e;
 
+typedef struct {
+       char *storage_id;
+       char *storage_path;
+       int storage_type;
+} media_storage_s;
+
+/**
+ * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
+ * @deprecated Deprecated since 5.0.
+ * @brief The structure type for the Media storage handle.
+ * @since_tizen 2.4
+ */
+typedef void *media_storage_h;
+
 /**
  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  * @brief The structure type for the Media info handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct media_info_s *media_info_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
  * @brief The structure type for the Media folder handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct media_folder_s *media_folder_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
  * @brief The structure type for the Media playlist handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct media_playlist_s *media_playlist_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
  * @brief The structure type for the Media tag handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct media_tag_s *media_tag_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
  * @brief The structure type for the Media bookmark handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct media_bookmark_s *media_bookmark_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
  * @brief The structure type for the Media album handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct media_album_s *media_album_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_IMAGE_META_MODULE
  * @brief The structure type for the Image metadata handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct image_meta_s *image_meta_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE
  * @brief The structure type for the Video metadata handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct video_meta_s *video_meta_h;
 
 /**
  * @ingroup CAPI_CONTENT_MEDIA_AUDIO_META_MODULE
  * @brief The structure type for the Audio metadata handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct audio_meta_s *audio_meta_h;
 
@@ -305,11 +319,12 @@ typedef struct book_meta_s *book_meta_h;
 /**
  * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
  * @brief The structure type for the Media filter handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct filter_s *filter_h;
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
  * @brief The structure type for the Media face handle.
  * @since_tizen 3.0
@@ -335,7 +350,7 @@ typedef void *media_content_noti_h;
  *             #MEDIA_CONTENT_ERROR_DB_FAILED : DB Operation failed \n
  *             #MEDIA_CONTENT_ERROR_DB_BUSY : DB Operation busy \n
  *             #MEDIA_CONTENT_ERROR_NETWORK : Network fail \n
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks The callback is called in a separate thread(not in the main loop).
  *
  * @param[in] error The error code
@@ -351,7 +366,7 @@ typedef void (*media_scan_completed_cb)(media_content_error_e error, void * user
  * @brief Called when the notification of the media DB change is subscribed.
  * @details The following error codes can be received: \n
  *             #MEDIA_CONTENT_ERROR_NONE : Success \n
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The callback is called in a separate thread(not in the main loop).
  *
@@ -360,7 +375,7 @@ typedef void (*media_scan_completed_cb)(media_content_error_e error, void * user
  * @param[in] update_item The update item of notification
  * @param[in] update_type The update type of notification
  * @param[in] media_type The type of the media content (#media_content_type_e)
- * @param[in] uuid The ID of media or directory, which is updated
+ * @param[in] id The ID of media or directory, which is updated
  * @param[in] path The path of the media or directory
  * @param[in] mime_type The MIME of the media info
  * @param[in] user_data The user data passed from the foreach function
@@ -384,7 +399,7 @@ typedef void (*media_content_db_update_cb)(
  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  * @brief Called for every available media info.
  * @details Iterates over a list of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks To use the @a media outside this function, copy the handle with media_info_clone() function. \n
  *                  The callback is called in the main loop.
@@ -421,7 +436,7 @@ typedef bool (*media_info_cb)(media_info_h media, void *user_data);
  *             #MEDIA_CONTENT_ERROR_DB_BUSY : DB Operation busy \n
  *             #MEDIA_CONTENT_ERROR_NETWORK : Network fail \n
  *             #MEDIA_CONTENT_ERROR_NOT_SUPPORTED : Not supported \n
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The callback is called in a separate thread(not in the main loop).
  *
@@ -434,6 +449,7 @@ typedef bool (*media_info_cb)(media_info_h media, void *user_data);
 typedef void (*media_insert_completed_cb)(media_content_error_e error, void * user_data);
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @ingroup CAPI_CONTENT_MEDIA_FACE_DETECTION_MODULE
  * @brief Called when face detection on the image is completed.
  *
@@ -464,7 +480,7 @@ typedef void (*media_face_detection_completed_cb)(media_content_error_e error, c
  * @brief Called for every available media folder.
  * @details Iterates over a list of folders.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function. \n
  *                  The callback is called in the main loop.
@@ -486,7 +502,7 @@ typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
  * @brief Called for every playlist in the obtained list of playlists.
  * @details Iterates over a playlist list.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function. \n
  *                  The callback is called in the main loop.
@@ -509,7 +525,7 @@ typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
  * @brief Called for every media info with playlist member ID in the obtained list of media info.
  * @details Iterates over playlist members.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function. \n
  *                  The callback is called in the main loop.
@@ -533,7 +549,7 @@ typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, v
  * @brief Called for every tag in the obtained list of tags.
  * @details Iterates over a list of tags.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function. \n
  *                  The callback is called in the main loop.
@@ -557,7 +573,7 @@ typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
  * @brief Called for every bookmark in the obtained list of bookmarks.
  * @details Iterates over a bookmark list.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function. \n
  *                  The callback is called in the main loop.
@@ -578,7 +594,7 @@ typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
  * @brief Called for every album in the obtained list of groups.
  * @details Iterates over an album list.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks To use the @a album outside this function, copy the handle with the media_album_clone() function. \n
  *                  The callback is called in the main loop.
@@ -601,7 +617,7 @@ typedef bool (*media_album_cb)(media_album_h album, void *user_data);
  * @brief Called for every group in the obtained list of groups.
  * @details Iterates over a media group list.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks You should not free @a group_name returned by this function. \n
  *                  The callback is called in the main loop.
@@ -618,6 +634,28 @@ typedef bool (*media_album_cb)(media_album_h album, void *user_data);
 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 
 /**
+ * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
+ * @brief Called for every storage in the obtained list of storages.
+ * @details Iterates over a media storage list.
+ *
+ * @since_tizen 2.4
+ *
+ * @remarks You should not destroy @a storage returned by this function. \n
+ *                  The callback is called in the main loop.
+ *
+ * @param[in] storage The handle of the media storage
+ * @param[in] user_data The user data passed from the foreach function
+ *
+ * @return @c true to continue with the next iteration of the loop,
+ *         otherwise @c false to break out of the loop
+ *
+ * @pre media_storage_foreach_storage_from_db() will invoke this function.
+ * @see media_storage_foreach_storage_from_db()
+ */
+typedef bool (*media_storage_cb)(media_storage_h storage, void *user_data);
+
+/**
+ * @deprecated Deprecated since 8.0.
  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
  * @brief Called for every face in the obtained list of face.
  * @details Iterates over a media face list.
@@ -650,7 +688,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  /**
  * @brief Media ID.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_ID "MEDIA_ID"
@@ -658,7 +696,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media full path.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_PATH "MEDIA_PATH"
@@ -666,7 +704,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief The file name including the extension.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
@@ -676,7 +714,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @details There are 5 media types:\n
  *               0-image, 1-video, 2-sound, 3-music, 4-other\n
  *               You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_TYPE "MEDIA_TYPE"
@@ -684,7 +722,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media MIME type.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"
@@ -693,7 +731,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media file size.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_SIZE "MEDIA_SIZE"
@@ -701,7 +739,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief The time that content file was first added to media database.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"
@@ -709,7 +747,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief The last modification time provided by the file system.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
@@ -717,7 +755,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief  Media created time.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_TIMELINE "MEDIA_TIMELINE"
@@ -725,7 +763,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media thumbnail path.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
@@ -733,7 +771,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media title get from tag or file name.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_TITLE "MEDIA_TITLE"
@@ -741,7 +779,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media album name.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_ALBUM "MEDIA_ALBUM"
@@ -749,7 +787,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media artist.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_ARTIST "MEDIA_ARTIST"
@@ -757,7 +795,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media album artist.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
@@ -765,7 +803,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media genre.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_GENRE "MEDIA_GENRE"
@@ -773,7 +811,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media composer.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_COMPOSER "MEDIA_COMPOSER"
@@ -781,7 +819,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media year.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_YEAR "MEDIA_YEAR"
@@ -789,7 +827,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media recorded date.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
@@ -797,7 +835,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media track number.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"
@@ -805,7 +843,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media duration.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_DURATION "MEDIA_DURATION"
@@ -813,7 +851,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media longitude.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
@@ -821,7 +859,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media latitude.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_LATITUDE "MEDIA_LATITUDE"
@@ -829,7 +867,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media altitude.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_ALTITUDE "MEDIA_ALTITUDE"
@@ -837,7 +875,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media width.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_WIDTH "MEDIA_WIDTH"
@@ -845,7 +883,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media height.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_HEIGHT "MEDIA_HEIGHT"
@@ -853,7 +891,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media datetaken.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
@@ -861,7 +899,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief The time to register favourite.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
@@ -871,7 +909,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @details There are 2 types:\n
  *               0-not drm, 1-drm\n
  *               You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  */
 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
@@ -880,7 +918,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @deprecated Deprecated since 7.0.
  * @brief Media file name pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, this keyword is related to the following feature:\n
  *          - %http://tizen.org/feature/content.filter.pinyin\n
  *             If this feature is not supported on the device, PINYIN search does not work.
@@ -892,7 +930,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @deprecated Deprecated since 7.0.
  * @brief Media title pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, this keyword is related to the following feature:\n
  *          - %http://tizen.org/feature/content.filter.pinyin\n
  *             If this feature is not supported on the device, PINYIN search does not work.
@@ -904,7 +942,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @deprecated Deprecated since 7.0.
  * @brief Media album pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, this keyword is related to the following feature:\n
  *          - %http://tizen.org/feature/content.filter.pinyin\n
  *            If this feature is not supported on the device, PINYIN search does not work.
@@ -916,7 +954,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @deprecated Deprecated since 7.0.
  * @brief Media artist pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, this keyword is related to the following feature:\n
  *          - %http://tizen.org/feature/content.filter.pinyin\n
  *             If this feature is not supported on the device, PINYIN search does not work.
@@ -928,7 +966,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @deprecated Deprecated since 7.0.
  * @brief Media album artist pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, this keyword is related to the following feature:\n
  *          - %http://tizen.org/feature/content.filter.pinyin\n
  *            If this feature is not supported on the device, PINYIN search does not work.
@@ -940,7 +978,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @deprecated Deprecated since 7.0.
  * @brief Media genre pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, this keyword is related to the following feature:\n
  *          - %http://tizen.org/feature/content.filter.pinyin\n
  *            If this feature is not supported on the device, PINYIN search does not work.
@@ -952,7 +990,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @deprecated Deprecated since 7.0.
  * @brief Media composer pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, this keyword is related to the following feature:\n
  *          - %http://tizen.org/feature/content.filter.pinyin\n
  *            If this feature is not supported on the device, PINYIN search does not work.
@@ -971,21 +1009,21 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  /**
  * @brief Folder ID.
  * @details You can use above define to set the condition of folder filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define FOLDER_ID "FOLDER_ID"
 
 /**
  * @brief Folder full path.
  * @details You can use above define to set the condition of folder filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define FOLDER_PATH "FOLDER_PATH"
 
 /**
  * @brief Folder base name.
  * @details You can use above define to set the condition of folder filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define FOLDER_NAME "FOLDER_NAME"
 
@@ -993,7 +1031,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @deprecated Deprecated since 7.0.
  * @brief Folder base name pinyin.
  * @details You can use above define to set the condition of folder filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 4.0, this keyword is related to the following feature:\n
  *          - %http://tizen.org/feature/content.filter.pinyin\n
  *            If this feature is not supported on the device, PINYIN search does not work.
@@ -1003,7 +1041,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Playlist name.
  * @details You can use above define to set the condition of playlist filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define PLAYLIST_NAME "PLAYLIST_NAME"
 
@@ -1017,21 +1055,21 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Playlist member order.
  * @details You can use above define to set the condition of playlist filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
 
 /**
  * @brief Media count in playlist.
  * @details You can use above define to set the condition of playlist filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
 
 /**
  * @brief Tag name.
  * @details You can use above define to set the condition of tag filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define TAG_NAME "TAG_NAME"
 
@@ -1045,14 +1083,14 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @brief Media count in tag.
  * @details You can use above define to set the condition of tag filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
 
 /**
  * @brief Bookmark marked time.
  * @details You can use above define to set the condition of bookmark filter and order keyword.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
 
@@ -1071,6 +1109,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define BOOKMARK_NAME "BOOKMARK_NAME"
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Face tag.
  * @details You can use above define to set the condition of face filter and order keyword.
  * @since_tizen 3.0
@@ -1078,6 +1117,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_FACE_TAG "MEDIA_FACE_TAG"
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Face id.
  * @details You can use above define to set the condition of face filter and order keyword.
  * @since_tizen 4.0