Remove profile tag
[platform/core/api/media-content.git] / include_product / media_content_type.h
index 4c9ee02..d6235ff 100755 (executable)
@@ -15,8 +15,8 @@
 */
 
 
-#ifndef __TIZEN_MEDIA_CONTENT_TYPE_H__
-#define __TIZEN_MEDIA_CONTENT_TYPE_H__
+#ifndef __TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__
+#define __TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__
 
 #include <time.h>
 #include <tizen.h>
 extern "C" {
 #endif /* __cplusplus */
 
-#if 0
-#ifndef _USE_SENIOR_MODE
-#define _USE_SENIOR_MODE
-#endif
-#endif
-
 /**
  * @file media_content_type.h
  * @brief This file contains API related to media-content enumerations for media data types, groups, orientations, \n
  *        classes of errors and definitions of media-data. \n
  *        Listed APIs are called when iterating over lists of album, group, bookmark and other media,  \n
- *        when media items and burst shot are inserted completely and when notification of media DB change is subscribed.
+ *        when media items are inserted completely and when notification of media DB change is subscribed.
  */
 
 /**
@@ -47,46 +41,40 @@ 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.
  */
 typedef enum {
-       MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
-       MEDIA_CONTENT_TYPE_VIDEO                = 1,    /**<The type of a video */
+       MEDIA_CONTENT_TYPE_IMAGE        = 0,    /**<The type of an image */
+       MEDIA_CONTENT_TYPE_VIDEO        = 1,    /**<The type of a video */
        MEDIA_CONTENT_TYPE_SOUND        = 2,    /**<The type of sound */
-       MEDIA_CONTENT_TYPE_MUSIC                = 3,    /**<The type of music */
+       MEDIA_CONTENT_TYPE_MUSIC        = 3,    /**<The type of music */
        MEDIA_CONTENT_TYPE_OTHERS       = 4,    /**<The type of other */
-       MEDIA_CONTENT_TYPE_PVR                  = 5,            /**<The type of PVR */
-       MEDIA_CONTENT_TYPE_UHD                  = 6,            /**<The type of UHD */
-       MEDIA_CONTENT_TYPE_SCSA                 = 7,            /**<The type of SCSA */
+       MEDIA_CONTENT_TYPE_BOOK         = 5,    /**<The type of book (Since 6.5)*/
+       MEDIA_CONTENT_TYPE_PVR          = 1001, /**<The type of PVR */
+       MEDIA_CONTENT_TYPE_UHD          = 1002, /**<The type of UHD */
+       MEDIA_CONTENT_TYPE_SCSA         = 1003, /**<The type of SCSA */
+       MEDIA_CONTENT_TYPE_APK      = 1004,     /**<The type of ARK*/
+       MEDIA_CONTENT_TYPE_DOC      = 1005,     /**<The type of DOC*/
 } media_content_type_e;
 
 /**
- * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
- * @brief Enumeration for the storage type.
- * @details This information is used to establish where the folder is.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- */
-typedef enum {
-       MEDIA_CONTENT_STORAGE_INTERNAL  = 0,    /**< The device's internal storage */
-       MEDIA_CONTENT_STORAGE_EXTERNAL  = 1,    /**< The device's external storage like sd card*/
-       MEDIA_CONTENT_STORAGE_EXTERNAL_USB = 2, /**< The external USB storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_CONTENT_STORAGE_CLOUD     = 100,  /**< The Cloud storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif, Deprecated since 4.0) */
-} media_content_storage_e;
-
-/**
  * @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 */
        MEDIA_ITEM_DIRECTORY    = 1,            /**< Directory type, an item updated to DB */
+       MEDIA_ITEM_STORAGE      = 2,            /**< Storage type, an item updated to DB */
 } media_content_db_update_item_type_e;
 
 /**
  * @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 */
@@ -97,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*/
@@ -114,18 +102,18 @@ 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*/
        MEDIA_CONTENT_ORDER_DESC  = 1,      /**< Descending order*/
-       MEDIA_CONTENT_ORDER_OTHER = 2,          /** order by order key**/
+       MEDIA_CONTENT_ORDER_OTHER = 2,          /**< order by order key**/
 } media_content_order_e;
 
 /**
  * @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 */
@@ -134,12 +122,18 @@ typedef enum {
        MEDIA_CONTENT_COLLATE_LOCALIZED = 3,        /**< Collation LOCALIZATION, NOCASE also applied */
 } media_content_collation_e;
 
+/**
+* @brief Error class.
+* @details Class for Media Content error
+* @since_tizen 2.3
+*
+*/
 #define MEDIA_CONTENT_ERROR_CLASS                              TIZEN_ERROR_MEDIA_CONTENT
 
 /**
  * @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 */
@@ -158,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 */
@@ -180,21 +174,9 @@ typedef enum {
        MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
        MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
        MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
-       MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot*/
-       MEDIA_CONTENT_GROUP_RATING,              /**< Media group ID for a rating*/
-       MEDIA_CONTENT_GROUP_AUTHOR,              /**< Media group ID for an author*/
-       MEDIA_CONTENT_GROUP_PROVIDER,            /**< Media group ID for a provider*/
-       MEDIA_CONTENT_GROUP_CONTENT_NAME,        /**< Media group ID for the content name*/
-       MEDIA_CONTENT_GROUP_CATEGORY,            /**< Media group ID for a category*/
-       MEDIA_CONTENT_GROUP_LOCATION_TAG,        /**< Media group ID for a location tag*/
-       MEDIA_CONTENT_GROUP_AGE_RATING,          /**< Media group ID for an age rating*/
-       MEDIA_CONTENT_GROUP_KEYWORD,             /**< Media group ID for a keyword*/
-       MEDIA_CONTENT_GROUP_WEATHER,             /**< Media group ID for the weather*/
-       MEDIA_CONTENT_GROUP_MODIFIED_MONTH,              /**< Media group ID for the modified time*/
+       MEDIA_CONTENT_GROUP_RATING = 20,              /**< Media group ID for a rating*/
+       MEDIA_CONTENT_GROUP_MODIFIED_MONTH = 29,                 /**< Media group ID for the modified time*/
        MEDIA_CONTENT_GROUP_MODIFIED_DATE,               /**< Media group ID for the modified date*/
-#ifdef _USE_SENIOR_MODE
-       MEDIA_CONTENT_GROUP_CONTACT,
-#endif
        MEDIA_CONTENT_GROUP_ALBUM,
        MEDIA_CONTENT_GROUP_MAX,                /**< Invalid media group ID*/
        MEDIA_PVR_GROUP_DURATION,
@@ -250,84 +232,99 @@ 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_MODULE
+ * @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;
 
 /**
- * @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
+ * @ingroup CAPI_CONTENT_MEDIA_BOOK_META_MODULE
+ * @brief The structure type for the Book metadata handle.
+ * @since_tizen 6.5
  */
-typedef struct filter_s *filter_h;
+typedef struct book_meta_s *book_meta_h;
 
 /**
- * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
- * @brief The structure type for the Media storage handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
+ * @brief The structure type for the Media filter handle.
+ * @since_tizen 2.3
  */
-typedef void *media_storage_h;
+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 +332,7 @@ typedef void *media_storage_h;
 typedef void *media_face_h;
 
 /**
- * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
+ * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief The structure type for the Media content noti handle.
  * @since_tizen 3.0
  */
@@ -344,38 +341,47 @@ typedef void *media_content_noti_h;
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Called when the media scanning is finished.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @details The following error codes can be received: \n
+ *             #MEDIA_CONTENT_ERROR_NONE : Success \n
+ *             #MEDIA_CONTENT_ERROR_INVALID_PARAMETER : Invalid parameter \n
+ *             #MEDIA_CONTENT_ERROR_INVALID_OPERATION : Invalid operation \n
+ *             #MEDIA_CONTENT_ERROR_PERMISSION_DENIED : Permission denied \n
+ *             #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY : Out of memory \n
+ *             #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 2.3
  * @remarks The callback is called in a separate thread(not in the main loop).
  *
- * @param[in] error     The error code
+ * @param[in] error The error code
  * @param[in] user_data The user data passed from the foreach function
  *
- * @pre media_content_scan().
- *
- * @see media_content_scan()
- *
+ * @pre media_content_scan_folder().
+ * @see media_content_scan_folder()
  */
 typedef void (*media_scan_completed_cb)(media_content_error_e error, void * user_data);
 
 /**
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Called when the notification of the media DB change is subscribed.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @details The following error codes can be received: \n
+ *             #MEDIA_CONTENT_ERROR_NONE : Success \n
+ * @since_tizen 2.3
  *
  * @remarks The callback is called in a separate thread(not in the main loop).
  *
- * @param[in] error       The error code
- * @param[in] pid         The PID which publishes notification
+ * @param[in] error The error code
+ * @param[in] pid The PID which publishes notification
  * @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 UUID of media or directory, which is updated
- * @param[in] path        The path of the media or directory
- * @param[in] mime_type   The mime type of the media info
- * @param[in] user_data   The user data passed from the foreach function
+ * @param[in] media_type The type of the media content (#media_content_type_e)
+ * @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
  *
- * @pre media_content_db_update_subscribe().
- * @see media_content_db_update_subscribe()
+ * @pre media_content_add_db_updated_cb().
+ * @see media_content_add_db_updated_cb()
  */
 typedef void (*media_content_db_update_cb)(
                                media_content_error_e error,
@@ -383,7 +389,7 @@ typedef void (*media_content_db_update_cb)(
                                media_content_db_update_item_type_e update_item,
                                media_content_db_update_type_e update_type,
                                media_content_type_e media_type,
-                               char *uuid,
+                               char *id,
                                char *path,
                                char *mime_type,
                                void *user_data);
@@ -392,14 +398,13 @@ typedef void (*media_content_db_update_cb)(
 /**
  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  * @brief Called for every available media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
  * @details Iterates over a list of media info.
+ * @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.
  *
- * @param[in] media     The handle to the media info
+ * @param[in] media The handle to the media info
  * @param[in] user_data The user data passed from the foreach function
  *
  * @return @c true to continue with the next iteration of the loop,
@@ -421,65 +426,30 @@ typedef bool (*media_info_cb)(media_info_h media, void *user_data);
 /**
  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  * @brief Called when media items are inserted completely.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @details The following error codes can be received: \n
+ *             #MEDIA_CONTENT_ERROR_NONE : Success \n
+ *             #MEDIA_CONTENT_ERROR_INVALID_PARAMETER : Invalid parameter \n
+ *             #MEDIA_CONTENT_ERROR_INVALID_OPERATION : Invalid operation \n
+ *             #MEDIA_CONTENT_ERROR_PERMISSION_DENIED : Permission denied \n
+ *             #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY : Out of memory \n
+ *             #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
+ *             #MEDIA_CONTENT_ERROR_NOT_SUPPORTED : Not supported \n
+ * @since_tizen 2.3
  *
  * @remarks The callback is called in a separate thread(not in the main loop).
  *
- * @param[in] media     The handle to the media info
+ * @param[in] error The error code
  * @param[in] user_data The user data passed from the foreach function
  *
  * @pre media_info_insert_batch_to_db()
- *
  * @see media_info_insert_batch_to_db()
  */
 typedef void (*media_insert_completed_cb)(media_content_error_e error, void * user_data);
 
-
-/**
- * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
- * @brief Called when the burst shot is inserted completely.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @remarks The callback is called in a separate thread(not in the main loop).
- *
- * @param[in] media     The handle to the media info
- * @param[in] user_data The user data passed from the foreach function
- *
- * @pre media_info_insert_burst_shot_to_db()
- *
- * @see media_info_insert_burst_shot_to_db()
- *
- */
-typedef void (*media_insert_burst_shot_completed_cb)(media_content_error_e error, void * user_data);
-
-
-/**
- * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
- * @brief Called when creating a thumbnail image.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @details This callback is called for completion of generating the thumbnail image.
- *         The following error codes can be delivered. \n
- *         #MEDIA_CONTENT_ERROR_NONE, \n
- *         #MEDIA_CONTENT_ERROR_INVALID_PARAMETER, \n
- *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
- *         #MEDIA_CONTENT_ERROR_PERMISSION_DENIED, \n
- *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
- *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
- *
- * @remarks The callback is called in a separate thread(not in the main loop).
- *
- * @param[in] error     The error code
- * @param[in] path      The path of the thumbnail which is generated
- * @param[in] user_data The user data passed from the foreach function
- *
- * @pre media_info_create_thumbnail()
- *
- * @see media_info_create_thumbnail()
- */
-typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, 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.
  *
@@ -495,12 +465,11 @@ typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const
  *
  * @remarks The callback is called in a separate thread(not in the main loop).
  *
- * @param[in] error     The error code
- * @param[in] face_count      The number of all detected faces
+ * @param[in] error The error code
+ * @param[in] face_count The number of all detected faces
  * @param[in] user_data The user data passed from the foreach function
  *
  * @pre media_info_start_face_detection()
- *
  * @see media_info_start_face_detection()
  */
 typedef void (*media_face_detection_completed_cb)(media_content_error_e error, const int face_count, void *user_data);
@@ -509,14 +478,14 @@ typedef void (*media_face_detection_completed_cb)(media_content_error_e error, c
 /**
  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
  * @brief Called for every available media folder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
  * @details Iterates over a list of folders.
  *
+ * @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.
  *
- * @param[in] folder    The handle to the media folder
+ * @param[in] folder The handle to the media folder
  * @param[in] user_data The user data passed from the foreach function
  *
  * @return @c true to continue with the next iteration of the loop,
@@ -531,14 +500,14 @@ typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 /**
  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
  * @brief Called for every playlist in the obtained list of playlists.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
  * @details Iterates over a playlist list.
  *
+ * @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.
  *
- * @param[in] playlist  The handle to the media playlist
+ * @param[in] playlist The handle to the media playlist
  * @param[in] user_data The user data passed from the foreach function
  *
  * @return @c true to continue with the next iteration of the loop,
@@ -554,16 +523,16 @@ typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 /**
  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
  * @brief Called for every media info with playlist member ID in the obtained list of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
  * @details Iterates over playlist members.
  *
+ * @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.
  *
- * @param[in] playlist_member_id The ID to member of the playlist
- * @param[in] media              The handle to the media info
- * @param[in] user_data          The user data passed from the foreach function
+ * @param[in] playlist_member_id The ID of the playlist member
+ * @param[in] media The handle to the media info
+ * @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
@@ -578,14 +547,14 @@ typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, v
 /**
  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
  * @brief Called for every tag in the obtained list of tags.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
  * @details Iterates over a list of tags.
  *
+ * @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.
  *
- * @param[in] tag       The handle to the media tag
+ * @param[in] tag The handle to the media tag
  * @param[in] user_data The user data passed from the foreach function
  *
  * @return @c true to continue with the next iteration of the loop,
@@ -602,21 +571,20 @@ typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 /**
  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
  * @brief Called for every bookmark in the obtained list of bookmarks.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
  * @details Iterates over a bookmark list.
  *
+ * @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.
  *
- * @param[in] bookmark  The handle to the video bookmark
+ * @param[in] bookmark The handle to the media bookmark
  * @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_info_foreach_bookmark_from_db() will invoke this function.
- *
  * @see media_info_foreach_bookmark_from_db()
  */
 typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
@@ -624,14 +592,14 @@ typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
 /**
  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
  * @brief Called for every album in the obtained list of groups.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
  * @details Iterates over an album list.
  *
+ * @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.
  *
- * @param[in] album     The handle to the media album
+ * @param[in] album The handle to the media album
  * @param[in] user_data The user data passed from the foreach function
  *
  * @return @c true to continue with the next iteration of the loop,
@@ -647,21 +615,20 @@ typedef bool (*media_album_cb)(media_album_h album, void *user_data);
 /**
  * @ingroup CAPI_CONTENT_MEDIA_GROUP_MODULE
  * @brief Called for every group in the obtained list of groups.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
  * @details Iterates over a media group list.
  *
+ * @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.
  *
  * @param[in] group_name The name of the media group
- * @param[in] user_data  The user data passed from the foreach function
+ * @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_group_foreach_group_from_db() will invoke this function.
- *
  * @see media_group_foreach_group_from_db()
  */
 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
@@ -669,43 +636,42 @@ 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.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
  * @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
+ * @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.
- * @since_tizen 3.0
- *
  * @details Iterates over a media face list.
  *
+ * @since_tizen 3.0
+ *
  * @remarks You should not destroy @a face returned by this function. \n
  *                  The callback is called in the main loop.
  *
- * @param[in] face     The handle of the media face
- * @param[in] user_data  The user data passed from the foreach function
+ * @param[in] face The handle of the media face
+ * @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_info_foreach_face_from_db() will invoke this function.
- *
  * @see media_info_foreach_face_from_db()
  */
 typedef bool (*media_face_cb)(media_face_h face, void *user_data);
@@ -720,668 +686,443 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  */
 
  /**
- * @brief 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
- *
- */
-#define MEDIA_ID "MEDIA_ID" /**< Media ID */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_PATH "MEDIA_PATH"  /**< Media full path */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"  /**< Media base name */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_TYPE "MEDIA_TYPE"  /**< Media type: 0-image, 1-video, 2-sound, 3-music, 4-other*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"  /**< Media MIME type */
-
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_SIZE "MEDIA_SIZE"  /**< Media file size */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"  /**< Media added time */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"  /**< Media modified time */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_TIMELINE "MEDIA_TIMELINE"  /**< Media modified time */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"  /**< Media thumbnail path */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_TITLE "MEDIA_TITLE"  /**< Media title get from tag or file name */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_ALBUM "MEDIA_ALBUM"  /**< Media album name*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_ARTIST "MEDIA_ARTIST"  /**< Media artist*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"  /**< Media album_artist*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_GENRE "MEDIA_GENRE"  /**< Media genre*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_COMPOSER "MEDIA_COMPOSER"  /**< Media composer*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_YEAR "MEDIA_YEAR"  /**< Media year*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"  /**< Media recorded date*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_COPYRIGHT "MEDIA_COPYRIGHT"  /**< Media copyright*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"  /**< Media track number*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_DESCRIPTION "MEDIA_DESCRIPTION"  /**< Media description*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_BITRATE "MEDIA_BITRATE"  /**< Media bitrate*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"  /**< Media bit per sample*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"  /**< Media sample rate*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_CHANNEL "MEDIA_CHANNEL"  /**< Media channel*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_DURATION "MEDIA_DURATION"  /**< Media duration */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_LONGITUDE "MEDIA_LONGITUDE"  /**< Media longitude */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_LATITUDE "MEDIA_LATITUDE"  /**< Media latitude */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_ALTITUDE "MEDIA_ALTITUDE"  /**< Media altitude */
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_WIDTH "MEDIA_WIDTH"  /**< Media width*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_HEIGHT "MEDIA_HEIGHT"  /**< Media height*/
-
-/**
- * @brief 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
- *
- */
-#define MEDIA_DATETAKEN "MEDIA_DATETAKEN"  /**< Media datetaken*/
-
-/**
- * @brief 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
+ * @brief Media ID.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_ORIENTATION "MEDIA_ORIENTATION"  /**< Media orientation*/
+#define MEDIA_ID "MEDIA_ID"
 
 /**
- * @brief 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
+ * @brief Media full path.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_BURST_ID "BURST_ID"  /**< Media burst ID*/
+#define MEDIA_PATH "MEDIA_PATH"
 
 /**
- * @brief 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
+ * @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 2.3
  *
  */
-#define MEDIA_PLAYED_COUNT "MEDIA_PLAYED_COUNT"  /**< Media playedcount*/
+#define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
 
 /**
- * @brief 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
+ * @brief Media type.
+ * @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 2.3
  *
  */
-#define MEDIA_LAST_PLAYED_TIME "MEDIA_LAST_PLAYED_TIME"  /**< Media last played time*/
+#define MEDIA_TYPE "MEDIA_TYPE"
 
 /**
- * @brief 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
+ * @brief Media MIME type.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_LAST_PLAYED_POSITION "MEDIA_LAST_PLAYED_POSITION"  /**< Media last played position of file*/
+#define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"
 
-/**
- * @brief 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
- *
- */
-#define MEDIA_RATING "MEDIA_RATING"  /**< Media rating*/
 
 /**
- * @brief 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
+ * @brief Media file size.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_FAVOURITE "MEDIA_FAVOURITE"  /**< The time to register favourite*/
+#define MEDIA_SIZE "MEDIA_SIZE"
 
 /**
- * @brief 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
+ * @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 2.3
  *
  */
-#define MEDIA_AUTHOR "MEDIA_AUTHOR"  /**< Media author*/
+#define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"
 
 /**
- * @brief 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
+ * @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 2.3
  *
  */
-#define MEDIA_PROVIDER "MEDIA_PROVIDER"  /**< Media provider*/
+#define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
 
 /**
- * @brief 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
+ * @brief  Media created time.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_CONTENT_NAME "MEDIA_CONTENT_NAME"  /**< Media content name*/
+#define MEDIA_TIMELINE "MEDIA_TIMELINE"
 
 /**
- * @brief 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
+ * @brief Media thumbnail path.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_CATEGORY "MEDIA_CATEGORY"  /**< Media category*/
+#define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
 
 /**
- * @brief 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
+ * @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 2.3
  *
  */
-#define MEDIA_LOCATION_TAG "MEDIA_LOCATION_TAG"  /**< Media location tag*/
+#define MEDIA_TITLE "MEDIA_TITLE"
 
 /**
- * @brief 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
+ * @brief Media album name.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_AGE_RATING "MEDIA_AGE_RATING"  /**< Media age rating*/
+#define MEDIA_ALBUM "MEDIA_ALBUM"
 
 /**
- * @brief 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
+ * @brief Media artist.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_KEYWORD "MEDIA_KEYWORD"  /**< Media keyword*/
+#define MEDIA_ARTIST "MEDIA_ARTIST"
 
 /**
- * @brief 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
+ * @brief Media album artist.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_WEATHER "MEDIA_WEATHER"  /**< Media weather*/
+#define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
 
 /**
- * @brief 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
+ * @brief Media genre.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_IS_DRM "MEDIA_IS_DRM"  /**< Is DRM. 0-not drm, 1-drm*/
+#define MEDIA_GENRE "MEDIA_GENRE"
 
 /**
- * @brief 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
+ * @brief Media composer.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"  /**< Media storage. 0-internal storage, 1-external storage*/
+#define MEDIA_COMPOSER "MEDIA_COMPOSER"
 
 /**
- * @brief You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @brief Media year.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"      /**< media exposure_time*/
+#define MEDIA_YEAR "MEDIA_YEAR"
 
 /**
- * @brief You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @brief Media recorded date.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_FNUMBER "MEDIA_FNUMBER"  /**< media fnumber*/
+#define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
 
 /**
- * @brief You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @brief Media track number.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_ISO "MEDIA_ISO"  /**< media iso*/
+#define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"
 
 /**
- * @brief You can use above define to set the condition of media filter and order keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @brief Media duration.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_MODEL "MEDIA_MODEL"      /**< media model*/
+#define MEDIA_DURATION "MEDIA_DURATION"
 
 /**
- * @brief 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
+ * @brief Media longitude.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"  /**< Media file name pinyin */
+#define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
 
 /**
- * @brief 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
+ * @brief Media latitude.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"  /**< Media title pinyin */
+#define MEDIA_LATITUDE "MEDIA_LATITUDE"
 
 /**
- * @brief 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
+ * @brief Media altitude.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"  /**< Media album pinyin*/
+#define MEDIA_ALTITUDE "MEDIA_ALTITUDE"
 
 /**
- * @brief 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
+ * @brief Media width.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"  /**< Media artist pinyin*/
+#define MEDIA_WIDTH "MEDIA_WIDTH"
 
 /**
- * @brief 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
+ * @brief Media height.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"  /**< Media album_artist pinyin*/
+#define MEDIA_HEIGHT "MEDIA_HEIGHT"
 
 /**
- * @brief 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
+ * @brief Media datetaken.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"  /**< Media genre pinyin*/
+#define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
 
 /**
- * @brief 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
+ * @brief The time to register favourite.
+ * @details You can use above define to set the condition of media filter and order keyword.
+ * @since_tizen 2.3
  *
  */
-#define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"  /**< Media composer pinyin*/
+#define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
 
 /**
- * @brief 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
+ * @brief Is DRM.
+ * @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 2.3
  *
  */
-#define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"  /**< Media copyright pinyin*/
+#define MEDIA_IS_DRM "MEDIA_IS_DRM"
 
 /**
- * @brief 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
+ * @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 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.
  *
  */
-#define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"  /**< Media description pinyin*/
+#define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
 
 /**
- * @brief 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
+ * @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 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.
  *
  */
-#define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"  /**< Media author pinyin*/
+#define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
 
 /**
- * @brief 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
+ * @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 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.
  *
  */
-#define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"  /**< Media provider pinyin*/
+#define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
 
 /**
- * @brief 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
+ * @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 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.
  *
  */
-#define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"  /**< Media content name pinyin*/
+#define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
 
 /**
- * @brief 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
+ * @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 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.
  *
  */
-#define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"  /**< Media category pinyin*/
+#define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
 
 /**
- * @brief 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
+ * @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 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.
  *
  */
-#define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"  /**< Media location tag pinyin*/
+#define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
 
 /**
- * @brief 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
+ * @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 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.
  *
  */
-#define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"  /**< Media age rating pinyin*/
+#define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
 
 /**
- * @brief 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
- *
- */
-#define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"  /**< Media keyword pinyin*/
-
-/**
- * @brief You can use above define to set the condition of media filter and order keyword.
+ * @brief Virtual Reality content.
+ * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 3.0
  *
  */
-#define MEDIA_360 "MEDIA_360"  /**< Virtual Reality content*/
-
-/**
- * @}
- */
-
-
-/**
- * @addtogroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
- * @{
- */
+#define MEDIA_360 "MEDIA_360"
 
  /**
- * @brief 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
+ * @brief Folder ID.
+ * @details You can use above define to set the condition of folder filter and order keyword.
+ * @since_tizen 2.3
  */
-#define FOLDER_ID "FOLDER_ID"  /**< Folder ID */
+#define FOLDER_ID "FOLDER_ID"
 
 /**
-* @brief 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
-*/
-#define FOLDER_PATH "FOLDER_PATH"  /**< Folder full path */
-
-/**
-* @brief 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
-*/
-#define FOLDER_NAME "FOLDER_NAME"  /**< Folder base name */
-
-/**
-* @brief 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
-*/
-#define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"  /**< Folder modified time */
-
-/**
-* @brief 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
-*/
-#define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"  /**< Folder storage. 0-internal storage, 1-external storage*/
-
-/**
-* @brief 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
-*/
-#define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"  /**< Folder base name pinyin*/
-
-/**
- * @brief You can use above define to set the condition of folder filter and order keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @brief Folder full path.
+ * @details You can use above define to set the condition of folder filter and order keyword.
+ * @since_tizen 2.3
  */
-#define FOLDER_ORDER "FOLDER_ORDER"  /**< Folder order info */
+#define FOLDER_PATH "FOLDER_PATH"
 
 /**
- * @brief You can use above define to set the condition of folder filter and order keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @brief Folder base name.
+ * @details You can use above define to set the condition of folder filter and order keyword.
+ * @since_tizen 2.3
  */
-#define FOLDER_PARENT_FOLDER_ID "FOLDER_PARENT_FOLDER_ID"      /**< parent folder id */
+#define FOLDER_NAME "FOLDER_NAME"
 
 /**
- * @}
+ * @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 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.
  */
+#define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
 
 /**
- * @addtogroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
- * @{
- * @brief 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
+ * @brief Playlist name.
+ * @details You can use above define to set the condition of playlist filter and order keyword.
+ * @since_tizen 2.3
  */
-#define PLAYLIST_NAME "PLAYLIST_NAME"  /**< Playlist name */
+#define PLAYLIST_NAME "PLAYLIST_NAME"
 
 /**
- * @brief You can use above define to set the condition of playlist filter and order keyword.
+ * @brief Playlist id.
+ * @details You can use above define to set the condition of playlist filter and order keyword.
  * @since_tizen 4.0
  */
-#define PLAYLIST_ID "PLAYLIST_ID"  /**< Playlist id */
+#define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
 
 /**
- * @brief 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
+ * @brief Playlist member order.
+ * @details You can use above define to set the condition of playlist filter and order keyword.
+ * @since_tizen 2.3
  */
-#define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"  /**< Playlist name */
+#define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
 
 /**
- * @brief 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
+ * @brief Media count in playlist.
+ * @details You can use above define to set the condition of playlist filter and order keyword.
+ * @since_tizen 2.3
  */
-#define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"  /**< Media count in playlist view */
+#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 2.3
  */
+#define TAG_NAME "TAG_NAME"
 
 /**
- * @addtogroup CAPI_CONTENT_MEDIA_TAG_MODULE
- * @{
- * @brief 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
- */
-#define TAG_NAME "TAG_NAME"  /**< Tag name */
-
-/**
- * @brief You can use above define to set the condition of tag filter and order keyword.
+ * @brief Tag id.
+ * @details You can use above define to set the condition of tag filter and order keyword.
  * @since_tizen 4.0
  */
-#define TAG_ID "TAG_ID"  /**< Tag id */
-
-
-/**
- * @brief 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
- */
-#define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"  /**< Media count in tag view */
+#define MEDIA_TAG_ID "TAG_ID"
 
 /**
- * @}
+ * @brief Media count in tag.
+ * @details You can use above define to set the condition of tag filter and order keyword.
+ * @since_tizen 2.3
  */
+#define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
 
 /**
- * @addtogroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
- * @{
- * @brief 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
+ * @brief Bookmark marked time.
+ * @details You can use above define to set the condition of bookmark filter and order keyword.
+ * @since_tizen 2.3
  */
-#define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"  /**< Bookmark marked time */
+#define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
 
 /**
- * @brief You can use above define to set the condition of bookmark filter and order keyword.
+ * @brief Bookmark id.
+ * @details You can use above define to set the condition of bookmark filter and order keyword.
  * @since_tizen 4.0
  */
-#define BOOKMARK_ID "BOOKMARK_ID"  /**< Bookmark id */
+#define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
 
 /**
- * @brief You can use above define to set the condition of bookmark filter and order keyword.
+ * @brief Bookmark name.
+ * @details You can use above define to set the condition of bookmark filter and order keyword.
  * @since_tizen 4.0
  */
-#define BOOKMARK_NAME "BOOKMARK_NAME"  /**< Bookmark name */
-
-/**
- * @}
- */
-
-/**
- * @addtogroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
- * @{
- * @brief You can use above define to set the condition of storage filter and order keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- */
-#define MEDIA_STORAGE_ID                                       "STORAGE_ID"  /**< Storage ID */
+#define BOOKMARK_NAME "BOOKMARK_NAME"
 
 /**
- * @brief You can use above define to set the condition of storage filter and order keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- */
-#define MEDIA_STORAGE_PATH                             "STORAGE_PATH"  /**< Storage path */
-
-/**
- * @}
- */
-
-/**
- * @addtogroup CAPI_CONTENT_MEDIA_FACE_MODULE
- * @{
- * @brief You can use above define to set the condition of face filter and order keyword.
+ * @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
  */
-#define MEDIA_FACE_TAG "MEDIA_FACE_TAG"        /**< Face tag */
+#define MEDIA_FACE_TAG "MEDIA_FACE_TAG"
 
 /**
- * @brief You can use above define to set the condition of face filter and order keyword.
+ * @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
  */
-#define MEDIA_FACE_ID  "MEDIA_FACE_ID"  /**< Face id */
+#define MEDIA_FACE_ID  "MEDIA_FACE_ID"
 
 /**
  * @}
@@ -1393,4 +1134,4 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #endif /* __cplusplus */
 
 
-#endif /*__TIZEN_MEDIA_CONTENT_TYPE_H__*/
+#endif /*__TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__*/