include/media_content_type.h

   1 /*
   2 * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
   3 *
   4 * Licensed under the Apache License, Version 2.0 (the "License");
   5 * you may not use this file except in compliance with the License.
   6 * You may obtain a copy of the License at
   7 *
   8 * http://www.apache.org/licenses/LICENSE-2.0
   9 *
  10 * Unless required by applicable law or agreed to in writing, software
  11 * distributed under the License is distributed on an "AS IS" BASIS,
  12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 * See the License for the specific language governing permissions and
  14 * limitations under the License.
  15 */
  16
  17
  18 #ifndef __TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__
  19 #define __TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__
  20
  21 #include <time.h>
  22 #include <tizen.h>
  23
  24 #ifdef __cplusplus
  25 extern "C" {
  26 #endif /* __cplusplus */
  27
  28 /**
  29  * @file media_content_type.h
  30  * @brief This file contains API related to media-content enumerations for media data types, groups, orientations, \n
  31  *        classes of errors and definitions of media-data. \n
  32  *        Listed APIs are called when iterating over lists of album, group, bookmark and other media,  \n
  33  *        when media items and burst shot are inserted completely and when notification of media DB change is subscribed.
  34  */
  35
  36 /**
  37 * @addtogroup CAPI_MEDIA_CONTENT_MODULE
  38  * @{
  39  */
  40
  41 /**
  42  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  43  * @brief Enumeration for the media file format.
  44  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  45  * @remarks Since 4.0, #MEDIA_CONTENT_TYPE_OTHERS is related to the following feature:\n
  46  *              %http://tizen.org/feature/content.scanning.others\n
  47  *              If this feature is not supported on the device, #MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  48  */
  49 typedef enum {
  50         MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
  51         MEDIA_CONTENT_TYPE_VIDEO                = 1,    /**<The type of a video */
  52         MEDIA_CONTENT_TYPE_SOUND        = 2,    /**<The type of sound */
  53         MEDIA_CONTENT_TYPE_MUSIC                = 3,    /**<The type of music */
  54         MEDIA_CONTENT_TYPE_OTHERS       = 4,    /**<The type of other */
  55 } media_content_type_e;
  56
  57 /**
  58  * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
  59  * @deprecated Deprecated since 5.0.
  60  * @brief Enumeration for the storage type.
  61  * @details This information is used to establish where the folder is.
  62  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  63  */
  64 typedef enum {
  65         MEDIA_CONTENT_STORAGE_INTERNAL  = 0,    /**< The device's internal storage */
  66         MEDIA_CONTENT_STORAGE_EXTERNAL  = 1,    /**< The device's external storage like sd card*/
  67         MEDIA_CONTENT_STORAGE_EXTERNAL_USB = 2, /**< The external USB storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
  68         MEDIA_CONTENT_STORAGE_CLOUD     = 100,  /**< The Cloud storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif, Deprecated since 4.0) */
  69 } media_content_storage_e;
  70
  71 /**
  72  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  73  * @brief Enumeration for media content DB update items.
  74  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  75  */
  76 typedef enum {
  77         MEDIA_ITEM_FILE         = 0,            /**< File type, an item updated to DB */
  78         MEDIA_ITEM_DIRECTORY    = 1,            /**< Directory type, an item updated to DB */
  79 } media_content_db_update_item_type_e;
  80
  81 /**
  82  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  83  * @brief Enumeration for media content DB update types.
  84  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  85  */
  86 typedef enum {
  87         MEDIA_CONTENT_INSERT            = 0,            /**< Insert, the type of DB update */
  88         MEDIA_CONTENT_DELETE            = 1,            /**< Delete, The type of DB update */
  89         MEDIA_CONTENT_UPDATE    = 2,            /**< Update, The type of DB update */
  90 } media_content_db_update_type_e;
  91
  92 /**
  93  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  94  * @brief Enumeration for orientation types.
  95  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  96  */
  97 typedef enum {
  98         MEDIA_CONTENT_ORIENTATION_NOT_AVAILABLE  = 0,       /**< Not available*/
  99         MEDIA_CONTENT_ORIENTATION_NORMAL         = 1,       /**< Normal*/
 100         MEDIA_CONTENT_ORIENTATION_HFLIP          = 2,       /**< Flip horizontal*/
 101         MEDIA_CONTENT_ORIENTATION_ROT_180        = 3,       /**< Rotate 180 degrees*/
 102         MEDIA_CONTENT_ORIENTATION_VFLIP          = 4,       /**< Flip vertical*/
 103         MEDIA_CONTENT_ORIENTATION_TRANSPOSE      = 5,       /**< Transpose*/
 104         MEDIA_CONTENT_ORIENTATION_ROT_90         = 6,       /**< Rotate 90 degrees*/
 105         MEDIA_CONTENT_ORIENTATION_TRANSVERSE     = 7,       /**< Transverse*/
 106         MEDIA_CONTENT_ORIENTATION_ROT_270        = 8,       /**< Rotate 270 degrees*/
 107 } media_content_orientation_e;
 108
 109 /**
 110  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 111  * @brief Enumeration for ordering.
 112  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 113  */
 114 typedef enum {
 115         MEDIA_CONTENT_ORDER_ASC   = 0,      /**< Ascending order*/
 116         MEDIA_CONTENT_ORDER_DESC  = 1,      /**< Descending order*/
 117         MEDIA_CONTENT_ORDER_OTHER = 2,          /**< order by order key**/
 118 } media_content_order_e;
 119
 120 /**
 121  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 122  * @brief Enumeration for collations.
 123  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 124  */
 125 typedef enum {
 126         MEDIA_CONTENT_COLLATE_DEFAULT   = 0,        /**< Default collation BINARY */
 127         MEDIA_CONTENT_COLLATE_NOCASE    = 1,        /**< Collation NOCASE, not case sensitive */
 128         MEDIA_CONTENT_COLLATE_RTRIM     = 2,        /**< Collation RTRIM, trailing space characters are ignored */
 129         MEDIA_CONTENT_COLLATE_LOCALIZED = 3,        /**< Collation LOCALIZATION, NOCASE also applied */
 130 } media_content_collation_e;
 131
 132 /**
 133 * @brief Error class.
 134 * @details Class for Media Content error
 135 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 136 *
 137 */
 138 #define MEDIA_CONTENT_ERROR_CLASS                               TIZEN_ERROR_MEDIA_CONTENT
 139
 140 /**
 141  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 142  * @brief Enumeration for a media content error.
 143  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 144  */
 145 typedef enum {
 146         MEDIA_CONTENT_ERROR_NONE                    = TIZEN_ERROR_NONE,                    /**< Successful */
 147         MEDIA_CONTENT_ERROR_INVALID_PARAMETER       = TIZEN_ERROR_INVALID_PARAMETER,       /**< Invalid parameter */
 148         MEDIA_CONTENT_ERROR_OUT_OF_MEMORY           = TIZEN_ERROR_OUT_OF_MEMORY,           /**< Out of memory */
 149         MEDIA_CONTENT_ERROR_INVALID_OPERATION       = TIZEN_ERROR_INVALID_OPERATION,       /**< Invalid Operation */
 150         MEDIA_CONTENT_FILE_NO_SPACE_ON_DEVICE       = TIZEN_ERROR_FILE_NO_SPACE_ON_DEVICE, /**< No space left on device */
 151         MEDIA_CONTENT_ERROR_PERMISSION_DENIED             = TIZEN_ERROR_PERMISSION_DENIED,                /**< Permission denied */
 152         MEDIA_CONTENT_ERROR_DB_FAILED               = MEDIA_CONTENT_ERROR_CLASS | 0x01,    /**< DB operation failed */
 153         MEDIA_CONTENT_ERROR_DB_BUSY                 = MEDIA_CONTENT_ERROR_CLASS | 0x02,    /**< DB operation BUSY */
 154         MEDIA_CONTENT_ERROR_NETWORK                 = MEDIA_CONTENT_ERROR_CLASS | 0x03,    /**< Network Fail */
 155         MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT     = MEDIA_CONTENT_ERROR_CLASS | 0x04,    /**< Unsupported Content */
 156         MEDIA_CONTENT_ERROR_NOT_SUPPORTED           = TIZEN_ERROR_NOT_SUPPORTED,           /**< Not supported */
 157 } media_content_error_e;
 158
 159 /**
 160  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 161  * @brief Enumeration for a media group.
 162  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 163  */
 164 typedef enum {
 165         MEDIA_CONTENT_GROUP_DISPLAY_NAME = 0,    /**< Media group ID for display name */
 166         MEDIA_CONTENT_GROUP_TYPE,                /**< Media group ID for a media type */
 167         MEDIA_CONTENT_GROUP_MIME_TYPE,           /**< Media group ID for a mime type */
 168         MEDIA_CONTENT_GROUP_SIZE,                /**< Media group ID for content size */
 169         MEDIA_CONTENT_GROUP_ADDED_TIME,          /**< Media group ID for the added time */
 170         MEDIA_CONTENT_GROUP_MODIFIED_TIME,       /**< Media group ID for the modified time */
 171         MEDIA_CONTENT_GROUP_TITLE,               /**< Media group ID for a content title */
 172         MEDIA_CONTENT_GROUP_ARTIST,              /**< Media group ID for an artist*/
 173         MEDIA_CONTENT_GROUP_ALBUM_ARTIST,        /**< Media group ID for an album artist */
 174         MEDIA_CONTENT_GROUP_GENRE,               /**< Media group ID for a genre*/
 175         MEDIA_CONTENT_GROUP_COMPOSER,            /**< Media group ID for a composer*/
 176         MEDIA_CONTENT_GROUP_YEAR,                /**< Media group ID for a year*/
 177         MEDIA_CONTENT_GROUP_RECORDED_DATE,       /**< Media group ID for the recorded date*/
 178         MEDIA_CONTENT_GROUP_COPYRIGHT,           /**< Media group ID for the copyright*/
 179         MEDIA_CONTENT_GROUP_TRACK_NUM,           /**< Media group ID for a track number*/
 180         MEDIA_CONTENT_GROUP_DESCRIPTION,         /**< Media group ID for a description */
 181         MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
 182         MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
 183         MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
 184         MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot (Deprecated since 4.0)*/
 185         MEDIA_CONTENT_GROUP_RATING,              /**< Media group ID for a rating*/
 186         MEDIA_CONTENT_GROUP_AUTHOR,              /**< Media group ID for an author (Deprecated since 4.0)*/
 187         MEDIA_CONTENT_GROUP_PROVIDER,            /**< Media group ID for a provider (Deprecated since 4.0)*/
 188         MEDIA_CONTENT_GROUP_CONTENT_NAME,        /**< Media group ID for the content name (Deprecated since 4.0)*/
 189         MEDIA_CONTENT_GROUP_CATEGORY,            /**< Media group ID for a category (Deprecated since 4.0)*/
 190         MEDIA_CONTENT_GROUP_LOCATION_TAG,        /**< Media group ID for a location tag (Deprecated since 4.0)*/
 191         MEDIA_CONTENT_GROUP_AGE_RATING,          /**< Media group ID for an age rating (Deprecated since 4.0)*/
 192         MEDIA_CONTENT_GROUP_KEYWORD,             /**< Media group ID for a keyword (Deprecated since 4.0)*/
 193         MEDIA_CONTENT_GROUP_WEATHER,             /**< Media group ID for the weather (Deprecated since 4.0)*/
 194         MEDIA_CONTENT_GROUP_MAX                  /**< Invalid media group ID*/
 195 } media_group_e;
 196
 197 /**
 198  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 199  * @brief The structure type for the Media info handle.
 200  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 201  */
 202 typedef struct media_info_s *media_info_h;
 203
 204 /**
 205  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 206  * @brief The structure type for the Media folder handle.
 207  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 208  */
 209 typedef struct media_folder_s *media_folder_h;
 210
 211 /**
 212  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 213  * @brief The structure type for the Media playlist handle.
 214  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 215  */
 216 typedef struct media_playlist_s *media_playlist_h;
 217
 218 /**
 219  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 220  * @brief The structure type for the Media tag handle.
 221  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 222  */
 223 typedef struct media_tag_s *media_tag_h;
 224
 225 /**
 226  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 227  * @brief The structure type for the Media bookmark handle.
 228  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 229  */
 230 typedef struct media_bookmark_s *media_bookmark_h;
 231
 232 /**
 233  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 234  * @brief The structure type for the Media album handle.
 235  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 236  */
 237 typedef struct media_album_s *media_album_h;
 238
 239 /**
 240  * @ingroup CAPI_CONTENT_MEDIA_IMAGE_MODULE
 241  * @brief The structure type for the Image metadata handle.
 242  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 243  */
 244 typedef struct image_meta_s *image_meta_h;
 245
 246 /**
 247  * @ingroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE
 248  * @brief The structure type for the Video metadata handle.
 249  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 250  */
 251 typedef struct video_meta_s *video_meta_h;
 252
 253 /**
 254  * @ingroup CAPI_CONTENT_MEDIA_AUDIO_META_MODULE
 255  * @brief The structure type for the Audio metadata handle.
 256  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 257  */
 258 typedef struct audio_meta_s *audio_meta_h;
 259
 260 /**
 261  * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 262  * @brief The structure type for the Media filter handle.
 263  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 264  */
 265 typedef struct filter_s *filter_h;
 266
 267 /**
 268  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 269  * @deprecated Deprecated since 5.0.
 270  * @brief The structure type for the Media storage handle.
 271  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 272  */
 273 typedef void *media_storage_h;
 274
 275 /**
 276  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 277  * @brief The structure type for the Media face handle.
 278  * @since_tizen 3.0
 279  */
 280 typedef void *media_face_h;
 281
 282 /**
 283  * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
 284  * @brief The structure type for the Media content noti handle.
 285  * @since_tizen 3.0
 286  */
 287 typedef void *media_content_noti_h;
 288
 289 /**
 290  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 291  * @brief Called when the media scanning is finished.
 292  * @details The following error codes can be received: \n
 293  *             #MEDIA_CONTENT_ERROR_NONE : Success \n
 294  *             #MEDIA_CONTENT_ERROR_INVALID_PARAMETER : Invalid parameter \n
 295  *             #MEDIA_CONTENT_ERROR_INVALID_OPERATION : Invalid operation \n
 296  *             #MEDIA_CONTENT_ERROR_PERMISSION_DENIED : Permission denied \n
 297  *             #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY : Out of memory \n
 298  *             #MEDIA_CONTENT_ERROR_DB_FAILED : DB Operation failed \n
 299  *             #MEDIA_CONTENT_ERROR_DB_BUSY : DB Operation busy \n
 300  *             #MEDIA_CONTENT_ERROR_NETWORK : Network fail \n
 301  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 302  * @remarks The callback is called in a separate thread(not in the main loop).
 303  *
 304  * @param[in] error The error code
 305  * @param[in] user_data The user data passed from the foreach function
 306  *
 307  * @pre media_content_scan_folder().
 308  * @see media_content_scan_folder()
 309  */
 310 typedef void (*media_scan_completed_cb)(media_content_error_e error, void * user_data);
 311
 312 /**
 313  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 314  * @brief Called when the notification of the media DB change is subscribed.
 315  * @details The following error codes can be received: \n
 316  *             #MEDIA_CONTENT_ERROR_NONE : Success \n
 317  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 318  *
 319  * @remarks The callback is called in a separate thread(not in the main loop).
 320  *
 321  * @param[in] error The error code
 322  * @param[in] pid The PID which publishes notification
 323  * @param[in] update_item The update item of notification
 324  * @param[in] update_type The update type of notification
 325  * @param[in] media_type The type of the media content (#media_content_type_e)
 326  * @param[in] uuid The UUID of media or directory, which is updated
 327  * @param[in] path The path of the media or directory
 328  * @param[in] mime_type The MIME of the media info
 329  * @param[in] user_data The user data passed from the foreach function
 330  *
 331  * @pre media_content_add_db_updated_cb().
 332  * @see media_content_add_db_updated_cb()
 333  */
 334 typedef void (*media_content_db_update_cb)(
 335                                 media_content_error_e error,
 336                                 int pid,
 337                                 media_content_db_update_item_type_e update_item,
 338                                 media_content_db_update_type_e update_type,
 339                                 media_content_type_e media_type,
 340                                 char *uuid,
 341                                 char *path,
 342                                 char *mime_type,
 343                                 void *user_data);
 344
 345
 346 /**
 347  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 348  * @brief Called for every available media info.
 349  * @details Iterates over a list of media info.
 350  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 351  *
 352  * @remarks To use the @a media outside this function, copy the handle with media_info_clone() function. \n
 353  *                  The callback is called in the main loop.
 354  *
 355  * @param[in] media The handle to the media info
 356  * @param[in] user_data The user data passed from the foreach function
 357  *
 358  * @return @c true to continue with the next iteration of the loop,
 359  *         otherwise @c false to break out of the loop
 360  *
 361  * @pre media_tag_foreach_media_from_db(), media_playlist_foreach_media_from_db(), media_genre_foreach_media_from_db(),
 362  *      media_info_foreach_media_from_db(), media_folder_foreach_media_from_db() will invoke this function.
 363  *
 364  * @see media_info_clone()
 365  * @see media_album_foreach_media_from_db()
 366  * @see media_playlist_foreach_media_from_db()
 367  * @see media_tag_foreach_media_from_db()
 368  * @see media_info_foreach_media_from_db()
 369  * @see media_folder_foreach_media_from_db()
 370  */
 371 typedef bool (*media_info_cb)(media_info_h media, void *user_data);
 372
 373
 374 /**
 375  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 376  * @brief Called when media items are inserted completely.
 377  * @details The following error codes can be received: \n
 378  *             #MEDIA_CONTENT_ERROR_NONE : Success \n
 379  *             #MEDIA_CONTENT_ERROR_INVALID_PARAMETER : Invalid parameter \n
 380  *             #MEDIA_CONTENT_ERROR_INVALID_OPERATION : Invalid operation \n
 381  *             #MEDIA_CONTENT_ERROR_PERMISSION_DENIED : Permission denied \n
 382  *             #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY : Out of memory \n
 383  *             #MEDIA_CONTENT_ERROR_DB_FAILED : DB Operation failed \n
 384  *             #MEDIA_CONTENT_ERROR_DB_BUSY : DB Operation busy \n
 385  *             #MEDIA_CONTENT_ERROR_NETWORK : Network fail \n
 386  *             #MEDIA_CONTENT_ERROR_NOT_SUPPORTED : Not supported \n
 387  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 388  *
 389  * @remarks The callback is called in a separate thread(not in the main loop).
 390  *
 391  * @param[in] error The error code
 392  * @param[in] user_data The user data passed from the foreach function
 393  *
 394  * @pre media_info_insert_batch_to_db()
 395  * @see media_info_insert_batch_to_db()
 396  */
 397 typedef void (*media_insert_completed_cb)(media_content_error_e error, void * user_data);
 398
 399
 400 /**
 401  * @deprecated Deprecated since 4.0.
 402  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 403  * @brief Called when the burst shot is inserted completely.
 404  * @details The following error codes can be received: \n
 405  *             #MEDIA_CONTENT_ERROR_NONE : Success \n
 406  *             #MEDIA_CONTENT_ERROR_INVALID_PARAMETER : Invalid parameter \n
 407  *             #MEDIA_CONTENT_ERROR_INVALID_OPERATION : Invalid operation \n
 408  *             #MEDIA_CONTENT_ERROR_PERMISSION_DENIED : Permission denied \n
 409  *             #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY : Out of memory \n
 410  *             #MEDIA_CONTENT_ERROR_DB_FAILED : DB Operation failed \n
 411  *             #MEDIA_CONTENT_ERROR_DB_BUSY : DB Operation busy \n
 412  *             #MEDIA_CONTENT_ERROR_NETWORK : Network fail \n
 413  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 414  *
 415  * @remarks The callback is called in a separate thread(not in the main loop).
 416  *
 417  * @param[in] error The error code
 418  * @param[in] user_data The user data passed from the foreach function
 419  *
 420  * @pre media_info_insert_burst_shot_to_db()
 421  * @see media_info_insert_burst_shot_to_db()
 422  *
 423  */
 424 typedef void (*media_insert_burst_shot_completed_cb)(media_content_error_e error, void * user_data);
 425
 426
 427 /**
 428  * @deprecated Deprecated since 5.0.
 429  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 430  * @brief Called when creating a thumbnail image.
 431  * @details This callback is called for completion of generating the thumbnail image.
 432  *         The following error codes can be delivered. \n
 433  *         #MEDIA_CONTENT_ERROR_NONE, \n
 434  *         #MEDIA_CONTENT_ERROR_INVALID_PARAMETER, \n
 435  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 436  *         #MEDIA_CONTENT_ERROR_PERMISSION_DENIED, \n
 437  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 438  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 439  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 440  *
 441  * @remarks The callback is called in a separate thread(not in the main loop).
 442  *
 443  * @param[in] error The error code
 444  * @param[in] path The path of the thumbnail which is generated
 445  * @param[in] user_data The user data passed from the foreach function
 446  *
 447  * @pre media_info_create_thumbnail()
 448  * @see media_info_create_thumbnail()
 449  */
 450 typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data);
 451
 452 /**
 453  * @ingroup CAPI_CONTENT_MEDIA_FACE_DETECTION_MODULE
 454  * @brief Called when face detection on the image is completed.
 455  *
 456  * @details The following error codes can be delivered. \n
 457  *         #MEDIA_CONTENT_ERROR_NONE, \n
 458  *         #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, \n
 459  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 460  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 461  *         #MEDIA_CONTENT_ERROR_DB_BUSY, \n
 462  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 463  *
 464  * @since_tizen 3.0
 465  *
 466  * @remarks The callback is called in a separate thread(not in the main loop).
 467  *
 468  * @param[in] error The error code
 469  * @param[in] face_count The number of all detected faces
 470  * @param[in] user_data The user data passed from the foreach function
 471  *
 472  * @pre media_info_start_face_detection()
 473  * @see media_info_start_face_detection()
 474  */
 475 typedef void (*media_face_detection_completed_cb)(media_content_error_e error, const int face_count, void *user_data);
 476
 477
 478 /**
 479  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 480  * @brief Called for every available media folder.
 481  * @details Iterates over a list of folders.
 482  *
 483  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 484  *
 485  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function. \n
 486  *                  The callback is called in the main loop.
 487  *
 488  * @param[in] folder The handle to the media folder
 489  * @param[in] user_data The user data passed from the foreach function
 490  *
 491  * @return @c true to continue with the next iteration of the loop,
 492  *         otherwise @c false to break out of the loop
 493  *
 494  * @pre media_folder_foreach_folder_from_db() will invoke this function.
 495  * @see media_folder_clone()
 496  * @see media_folder_foreach_folder_from_db()
 497  */
 498 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 499
 500 /**
 501  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 502  * @brief Called for every playlist in the obtained list of playlists.
 503  * @details Iterates over a playlist list.
 504  *
 505  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 506  *
 507  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function. \n
 508  *                  The callback is called in the main loop.
 509  *
 510  * @param[in] playlist The handle to the media playlist
 511  * @param[in] user_data The user data passed from the foreach function
 512  *
 513  * @return @c true to continue with the next iteration of the loop,
 514  *         otherwise @c false to break out of the loop
 515  *
 516  * @pre media_playlist_foreach_playlist_from_db() will invoke this function.
 517  *
 518  * @see media_playlist_clone()
 519  * @see media_playlist_foreach_playlist_from_db()
 520  */
 521 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 522
 523 /**
 524  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 525  * @brief Called for every media info with playlist member ID in the obtained list of media info.
 526  * @details Iterates over playlist members.
 527  *
 528  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 529  *
 530  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function. \n
 531  *                  The callback is called in the main loop.
 532  *
 533  * @param[in] playlist_member_id The ID of the playlist member
 534  * @param[in] media The handle to the media info
 535  * @param[in] user_data The user data passed from the foreach function
 536  *
 537  * @return @c true to continue with the next iteration of the loop,
 538  *         otherwise @c false to break out of the loop
 539  *
 540  * @pre media_playlist_foreach_media_from_db() will invoke this function.
 541  *
 542  * @see media_info_clone()
 543  * @see media_playlist_foreach_media_from_db()
 544  */
 545 typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
 546
 547 /**
 548  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 549  * @brief Called for every tag in the obtained list of tags.
 550  * @details Iterates over a list of tags.
 551  *
 552  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 553  *
 554  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function. \n
 555  *                  The callback is called in the main loop.
 556  *
 557  * @param[in] tag The handle to the media tag
 558  * @param[in] user_data The user data passed from the foreach function
 559  *
 560  * @return @c true to continue with the next iteration of the loop,
 561  *         otherwise @c false to break out of the loop
 562  *
 563  * @pre media_tag_foreach_tag_from_db(), media_info_foreach_tag_from_db() will invoke this function.
 564  *
 565  * @see media_tag_clone()
 566  * @see media_tag_foreach_tag_from_db()
 567  * @see media_info_foreach_tag_from_db()
 568  */
 569 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 570
 571 /**
 572  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 573  * @brief Called for every bookmark in the obtained list of bookmarks.
 574  * @details Iterates over a bookmark list.
 575  *
 576  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 577  *
 578  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function. \n
 579  *                  The callback is called in the main loop.
 580  *
 581  * @param[in] bookmark The handle to the media bookmark
 582  * @param[in] user_data The user data passed from the foreach function
 583  *
 584  * @return @c true to continue with the next iteration of the loop,
 585  *         otherwise @c false to break out of the loop
 586  *
 587  * @pre media_info_foreach_bookmark_from_db() will invoke this function.
 588  * @see media_info_foreach_bookmark_from_db()
 589  */
 590 typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
 591
 592 /**
 593  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 594  * @brief Called for every album in the obtained list of groups.
 595  * @details Iterates over an album list.
 596  *
 597  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 598  *
 599  * @remarks To use the @a album outside this function, copy the handle with the media_album_clone() function. \n
 600  *                  The callback is called in the main loop.
 601  *
 602  * @param[in] album The handle to the media album
 603  * @param[in] user_data The user data passed from the foreach function
 604  *
 605  * @return @c true to continue with the next iteration of the loop,
 606  *         otherwise @c false to break out of the loop
 607  *
 608  * @pre media_album_foreach_album_from_db() will invoke this function.
 609  *
 610  * @see media_album_clone()
 611  * @see media_album_foreach_album_from_db()
 612  */
 613 typedef bool (*media_album_cb)(media_album_h album, void *user_data);
 614
 615 /**
 616  * @ingroup CAPI_CONTENT_MEDIA_GROUP_MODULE
 617  * @brief Called for every group in the obtained list of groups.
 618  * @details Iterates over a media group list.
 619  *
 620  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 621  *
 622  * @remarks You should not free @a group_name returned by this function. \n
 623  *                  The callback is called in the main loop.
 624  *
 625  * @param[in] group_name The name of the media group
 626  * @param[in] user_data The user data passed from the foreach function
 627  *
 628  * @return @c true to continue with the next iteration of the loop,
 629  *         otherwise @c false to break out of the loop
 630  *
 631  * @pre media_group_foreach_group_from_db() will invoke this function.
 632  * @see media_group_foreach_group_from_db()
 633  */
 634 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 635
 636 /**
 637  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 638  * @deprecated Deprecated since 5.0.
 639  * @brief Called for every storage in the obtained list of storages.
 640  * @details Iterates over a media storage list.
 641  *
 642  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 643  *
 644  * @remarks You should not destroy @a storage returned by this function. \n
 645  *                  The callback is called in the main loop.
 646  *
 647  * @param[in] storage The handle of the media storage
 648  * @param[in] user_data The user data passed from the foreach function
 649  *
 650  * @return @c true to continue with the next iteration of the loop,
 651  *         otherwise @c false to break out of the loop
 652  *
 653  * @pre media_storage_foreach_storage_from_db() will invoke this function.
 654  * @see media_storage_foreach_storage_from_db()
 655  */
 656 typedef bool (*media_storage_cb)(media_storage_h storage, void *user_data);
 657
 658 /**
 659  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 660  * @brief Called for every face in the obtained list of face.
 661  * @details Iterates over a media face list.
 662  *
 663  * @since_tizen 3.0
 664  *
 665  * @remarks You should not destroy @a face returned by this function. \n
 666  *                  The callback is called in the main loop.
 667  *
 668  * @param[in] face The handle of the media face
 669  * @param[in] user_data The user data passed from the foreach function
 670  *
 671  * @return @c true to continue with the next iteration of the loop,
 672  *         otherwise @c false to break out of the loop
 673  *
 674  * @pre media_info_foreach_face_from_db() will invoke this function.
 675  * @see media_info_foreach_face_from_db()
 676  */
 677 typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 678
 679 /**
 680  * @}
 681  */
 682
 683 /**
 684  * @addtogroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 685  * @{
 686  */
 687
 688  /**
 689  * @brief Media ID.
 690  * @details You can use above define to set the condition of media filter and order keyword.
 691  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 692  *
 693  */
 694 #define MEDIA_ID "MEDIA_ID"
 695
 696 /**
 697  * @brief Media full path.
 698  * @details You can use above define to set the condition of media filter and order keyword.
 699  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 700  *
 701  */
 702 #define MEDIA_PATH "MEDIA_PATH"
 703
 704 /**
 705  * @brief The file name including the extension.
 706  * @details You can use above define to set the condition of media filter and order keyword.
 707  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 708  *
 709  */
 710 #define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
 711
 712 /**
 713  * @brief Media type.
 714  * @details There are 5 media types:\n
 715  *               0-image, 1-video, 2-sound, 3-music, 4-other\n
 716  *               You can use above define to set the condition of media filter and order keyword.
 717  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 718  *
 719  */
 720 #define MEDIA_TYPE "MEDIA_TYPE"
 721
 722 /**
 723  * @brief Media MIME type.
 724  * @details You can use above define to set the condition of media filter and order keyword.
 725  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 726  *
 727  */
 728 #define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"
 729
 730
 731 /**
 732  * @brief Media file size.
 733  * @details You can use above define to set the condition of media filter and order keyword.
 734  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 735  *
 736  */
 737 #define MEDIA_SIZE "MEDIA_SIZE"
 738
 739 /**
 740  * @brief The time that content file was first added to media database.
 741  * @details You can use above define to set the condition of media filter and order keyword.
 742  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 743  *
 744  */
 745 #define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"
 746
 747 /**
 748  * @brief The last modification time provided by the file system.
 749  * @details You can use above define to set the condition of media filter and order keyword.
 750  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 751  *
 752  */
 753 #define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
 754
 755 /**
 756  * @brief  Media created time.
 757  * @details You can use above define to set the condition of media filter and order keyword.
 758  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 759  *
 760  */
 761 #define MEDIA_TIMELINE "MEDIA_TIMELINE"
 762
 763 /**
 764  * @brief Media thumbnail path.
 765  * @details You can use above define to set the condition of media filter and order keyword.
 766  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 767  *
 768  */
 769 #define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
 770
 771 /**
 772  * @brief Media title get from tag or file name.
 773  * @details You can use above define to set the condition of media filter and order keyword.
 774  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 775  *
 776  */
 777 #define MEDIA_TITLE "MEDIA_TITLE"
 778
 779 /**
 780  * @brief Media album name.
 781  * @details You can use above define to set the condition of media filter and order keyword.
 782  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 783  *
 784  */
 785 #define MEDIA_ALBUM "MEDIA_ALBUM"
 786
 787 /**
 788  * @brief Media artist.
 789  * @details You can use above define to set the condition of media filter and order keyword.
 790  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 791  *
 792  */
 793 #define MEDIA_ARTIST "MEDIA_ARTIST"
 794
 795 /**
 796  * @brief Media album artist.
 797  * @details You can use above define to set the condition of media filter and order keyword.
 798  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 799  *
 800  */
 801 #define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
 802
 803 /**
 804  * @brief Media genre.
 805  * @details You can use above define to set the condition of media filter and order keyword.
 806  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 807  *
 808  */
 809 #define MEDIA_GENRE "MEDIA_GENRE"
 810
 811 /**
 812  * @brief Media composer.
 813  * @details You can use above define to set the condition of media filter and order keyword.
 814  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 815  *
 816  */
 817 #define MEDIA_COMPOSER "MEDIA_COMPOSER"
 818
 819 /**
 820  * @brief Media year.
 821  * @details You can use above define to set the condition of media filter and order keyword.
 822  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 823  *
 824  */
 825 #define MEDIA_YEAR "MEDIA_YEAR"
 826
 827 /**
 828  * @brief Media recorded date.
 829  * @details You can use above define to set the condition of media filter and order keyword.
 830  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 831  *
 832  */
 833 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
 834
 835 /**
 836  * @brief Media copyright.
 837  * @details You can use above define to set the condition of media filter and order keyword.
 838  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 839  *
 840  */
 841 #define MEDIA_COPYRIGHT "MEDIA_COPYRIGHT"
 842
 843 /**
 844  * @brief Media track number.
 845  * @details You can use above define to set the condition of media filter and order keyword.
 846  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 847  *
 848  */
 849 #define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"
 850
 851 /**
 852  * @brief Media description.
 853  * @details You can use above define to set the condition of media filter and order keyword.
 854  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 855  *
 856  */
 857 #define MEDIA_DESCRIPTION "MEDIA_DESCRIPTION"
 858
 859 /**
 860  * @brief Media bitrate.
 861  * @details You can use above define to set the condition of media filter and order keyword.
 862  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 863  *
 864  */
 865 #define MEDIA_BITRATE "MEDIA_BITRATE"
 866
 867 /**
 868  * @brief Media bit per sample.
 869  * @details You can use above define to set the condition of media filter and order keyword.
 870  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 871  *
 872  */
 873 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"
 874
 875 /**
 876  * @brief Media sample rate.
 877  * @details You can use above define to set the condition of media filter and order keyword.
 878  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 879  *
 880  */
 881 #define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"
 882
 883 /**
 884  * @brief Media channel.
 885  * @details You can use above define to set the condition of media filter and order keyword.
 886  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 887  *
 888  */
 889 #define MEDIA_CHANNEL "MEDIA_CHANNEL"
 890
 891 /**
 892  * @brief Media duration.
 893  * @details You can use above define to set the condition of media filter and order keyword.
 894  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 895  *
 896  */
 897 #define MEDIA_DURATION "MEDIA_DURATION"
 898
 899 /**
 900  * @brief Media longitude.
 901  * @details You can use above define to set the condition of media filter and order keyword.
 902  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 903  *
 904  */
 905 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
 906
 907 /**
 908  * @brief Media latitude.
 909  * @details You can use above define to set the condition of media filter and order keyword.
 910  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 911  *
 912  */
 913 #define MEDIA_LATITUDE "MEDIA_LATITUDE"
 914
 915 /**
 916  * @brief Media altitude.
 917  * @details You can use above define to set the condition of media filter and order keyword.
 918  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 919  *
 920  */
 921 #define MEDIA_ALTITUDE "MEDIA_ALTITUDE"
 922
 923 /**
 924  * @brief Media width.
 925  * @details You can use above define to set the condition of media filter and order keyword.
 926  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 927  *
 928  */
 929 #define MEDIA_WIDTH "MEDIA_WIDTH"
 930
 931 /**
 932  * @brief Media height.
 933  * @details You can use above define to set the condition of media filter and order keyword.
 934  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 935  *
 936  */
 937 #define MEDIA_HEIGHT "MEDIA_HEIGHT"
 938
 939 /**
 940  * @brief Media datetaken.
 941  * @details You can use above define to set the condition of media filter and order keyword.
 942  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 943  *
 944  */
 945 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
 946
 947 /**
 948  * @brief Media orientation.
 949  * @details You can use above define to set the condition of media filter and order keyword.
 950  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 951  *
 952  */
 953 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 954
 955 /**
 956  * @deprecated Deprecated since 4.0.
 957  * @brief Media burst ID.
 958  * @details You can use above define to set the condition of media filter and order keyword.
 959  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 960  *
 961  */
 962 #define MEDIA_BURST_ID "BURST_ID"
 963
 964 /**
 965  * @deprecated Deprecated since 4.0.
 966  * @brief Media playedcount.
 967  * @details You can use above define to set the condition of media filter and order keyword.
 968  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 969  *
 970  */
 971 #define MEDIA_PLAYED_COUNT "MEDIA_PLAYED_COUNT"
 972
 973 /**
 974  * @deprecated Deprecated since 4.0.
 975  * @brief Media last played time.
 976  * @details You can use above define to set the condition of media filter and order keyword.
 977  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 978  *
 979  */
 980 #define MEDIA_LAST_PLAYED_TIME "MEDIA_LAST_PLAYED_TIME"
 981
 982 /**
 983  * @deprecated Deprecated since 4.0.
 984  * @brief Media last played position of file.
 985  * @details You can use above define to set the condition of media filter and order keyword.
 986  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 987  *
 988  */
 989 #define MEDIA_LAST_PLAYED_POSITION "MEDIA_LAST_PLAYED_POSITION"
 990
 991 /**
 992  * @brief Media rating.
 993  * @details You can use above define to set the condition of media filter and order keyword.
 994  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 995  *
 996  */
 997 #define MEDIA_RATING "MEDIA_RATING"
 998
 999 /**
1000  * @brief The time to register favourite.
1001  * @details You can use above define to set the condition of media filter and order keyword.
1002  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1003  *
1004  */
1005 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
1006
1007 /**
1008  * @deprecated Deprecated since 4.0.
1009  * @brief Media author.
1010  * @details You can use above define to set the condition of media filter and order keyword.
1011  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1012  *
1013  */
1014 #define MEDIA_AUTHOR "MEDIA_AUTHOR"
1015
1016 /**
1017  * @deprecated Deprecated since 4.0.
1018  * @brief Media provider.
1019  * @details You can use above define to set the condition of media filter and order keyword.
1020  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1021  *
1022  */
1023 #define MEDIA_PROVIDER "MEDIA_PROVIDER"
1024
1025 /**
1026  * @deprecated Deprecated since 4.0.
1027  * @brief Media content name.
1028  * @details You can use above define to set the condition of media filter and order keyword.
1029  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1030  *
1031  */
1032 #define MEDIA_CONTENT_NAME "MEDIA_CONTENT_NAME"
1033
1034 /**
1035  * @deprecated Deprecated since 4.0.
1036  * @brief Media category.
1037  * @details You can use above define to set the condition of media filter and order keyword.
1038  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1039  *
1040  */
1041 #define MEDIA_CATEGORY "MEDIA_CATEGORY"
1042
1043 /**
1044  * @deprecated Deprecated since 4.0.
1045  * @brief Media location tag.
1046  * @details You can use above define to set the condition of media filter and order keyword.
1047  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1048  *
1049  */
1050 #define MEDIA_LOCATION_TAG "MEDIA_LOCATION_TAG"
1051
1052 /**
1053  * @deprecated Deprecated since 4.0.
1054  * @brief Media age rating.
1055  * @details You can use above define to set the condition of media filter and order keyword.
1056  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1057  *
1058  */
1059 #define MEDIA_AGE_RATING "MEDIA_AGE_RATING"
1060
1061 /**
1062  * @deprecated Deprecated since 4.0.
1063  * @brief Media keyword.
1064  * @details You can use above define to set the condition of media filter and order keyword.
1065  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1066  *
1067  */
1068 #define MEDIA_KEYWORD "MEDIA_KEYWORD"
1069
1070 /**
1071  * @deprecated Deprecated since 4.0.
1072  * @brief Media weather.
1073  * @details You can use above define to set the condition of media filter and order keyword.
1074  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1075  *
1076  */
1077 #define MEDIA_WEATHER "MEDIA_WEATHER"
1078
1079 /**
1080  * @brief Is DRM.
1081  * @details There are 2 types:\n
1082  *               0-not drm, 1-drm\n
1083  *               You can use above define to set the condition of media filter and order keyword.
1084  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1085  *
1086  */
1087 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
1088
1089 /**
1090  * @deprecated Deprecated since 5.0.
1091  * @brief Media storage.
1092  * @details There are 2 types:\n
1093  *               0-internal storage, 1-external storage\n
1094  *               You can use above define to set the condition of media filter and order keyword.
1095  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1096  *
1097  */
1098 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
1099
1100 /**
1101  * @brief Media exposure time.
1102  * @details You can use above define to set the condition of media filter and order keyword.
1103  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1104  *
1105  */
1106 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
1107
1108 /**
1109  * @brief Media fnumber.
1110  * @details You can use above define to set the condition of media filter and order keyword.
1111  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1112  *
1113  */
1114 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
1115
1116 /**
1117  * @brief Media ISO.
1118  * @details You can use above define to set the condition of media filter and order keyword.
1119  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1120  *
1121  */
1122 #define MEDIA_ISO "MEDIA_ISO"
1123
1124 /**
1125  * @brief Media model.
1126  * @details You can use above define to set the condition of media filter and order keyword.
1127  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1128  *
1129  */
1130 #define MEDIA_MODEL "MEDIA_MODEL"
1131
1132 /**
1133  * @brief Media file name pinyin.
1134  * @details You can use above define to set the condition of media filter and order keyword.
1135  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1136  * @remarks Since 4.0, this keyword is related to the following feature:\n
1137  *          - %http://tizen.org/feature/content.filter.pinyin\n
1138  *             If this feature is not supported on the device, PINYIN search does not work.
1139  *
1140  */
1141 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
1142
1143 /**
1144  * @brief Media title pinyin.
1145  * @details You can use above define to set the condition of media filter and order keyword.
1146  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1147  * @remarks Since 4.0, this keyword is related to the following feature:\n
1148  *          - %http://tizen.org/feature/content.filter.pinyin\n
1149  *             If this feature is not supported on the device, PINYIN search does not work.
1150  *
1151  */
1152 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
1153
1154 /**
1155  * @brief Media album pinyin.
1156  * @details You can use above define to set the condition of media filter and order keyword.
1157  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1158  * @remarks Since 4.0, this keyword is related to the following feature:\n
1159  *          - %http://tizen.org/feature/content.filter.pinyin\n
1160  *            If this feature is not supported on the device, PINYIN search does not work.
1161  *
1162  */
1163 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
1164
1165 /**
1166  * @brief Media artist pinyin.
1167  * @details You can use above define to set the condition of media filter and order keyword.
1168  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1169  * @remarks Since 4.0, this keyword is related to the following feature:\n
1170  *          - %http://tizen.org/feature/content.filter.pinyin\n
1171  *             If this feature is not supported on the device, PINYIN search does not work.
1172  *
1173  */
1174 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
1175
1176 /**
1177  * @brief Media album artist pinyin.
1178  * @details You can use above define to set the condition of media filter and order keyword.
1179  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1180  * @remarks Since 4.0, this keyword is related to the following feature:\n
1181  *          - %http://tizen.org/feature/content.filter.pinyin\n
1182  *            If this feature is not supported on the device, PINYIN search does not work.
1183  *
1184  */
1185 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
1186
1187 /**
1188  * @brief Media genre pinyin.
1189  * @details You can use above define to set the condition of media filter and order keyword.
1190  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1191  * @remarks Since 4.0, this keyword is related to the following feature:\n
1192  *          - %http://tizen.org/feature/content.filter.pinyin\n
1193  *            If this feature is not supported on the device, PINYIN search does not work.
1194  *
1195  */
1196 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
1197
1198 /**
1199  * @brief Media composer pinyin.
1200  * @details You can use above define to set the condition of media filter and order keyword.
1201  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1202  * @remarks Since 4.0, this keyword is related to the following feature:\n
1203  *          - %http://tizen.org/feature/content.filter.pinyin\n
1204  *            If this feature is not supported on the device, PINYIN search does not work.
1205  *
1206  */
1207 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
1208
1209 /**
1210  * @brief Media copyright pinyin.
1211  * @details You can use above define to set the condition of media filter and order keyword.
1212  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1213  * @remarks Since 4.0, this keyword is related to the following feature:\n
1214  *          - %http://tizen.org/feature/content.filter.pinyin\n
1215  *            If this feature is not supported on the device, PINYIN search does not work.
1216  *
1217  */
1218 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
1219
1220 /**
1221  * @brief Media description pinyin.
1222  * @details You can use above define to set the condition of media filter and order keyword.
1223  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1224  * @remarks Since 4.0, this keyword is related to the following feature:\n
1225  *          - %http://tizen.org/feature/content.filter.pinyin\n
1226  *            If this feature is not supported on the device, PINYIN search does not work.
1227  *
1228  */
1229 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
1230
1231 /**
1232  * @deprecated Deprecated since 4.0.
1233  * @brief Media author pinyin.
1234  * @details You can use above define to set the condition of media filter and order keyword.
1235  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1236  * @remarks Since 4.0, this keyword is related to the following feature:\n
1237  *          - %http://tizen.org/feature/content.filter.pinyin\n
1238  *            If this feature is not supported on the device, PINYIN search does not work.
1239  *
1240  */
1241 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"
1242
1243 /**
1244  * @deprecated Deprecated since 4.0.
1245  * @brief Media provider pinyin.
1246  * @details You can use above define to set the condition of media filter and order keyword.
1247  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1248  * @remarks Since 4.0, this keyword is related to the following feature:\n
1249  *          - %http://tizen.org/feature/content.filter.pinyin\n
1250  *            If this feature is not supported on the device, PINYIN search does not work.
1251  *
1252  */
1253 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"
1254
1255 /**
1256  * @deprecated Deprecated since 4.0.
1257  * @brief Media content name pinyin.
1258  * @details You can use above define to set the condition of media filter and order keyword.
1259  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1260  * @remarks Since 4.0, this keyword is related to the following feature:\n
1261  *          - %http://tizen.org/feature/content.filter.pinyin\n
1262  *            If this feature is not supported on the device, PINYIN search does not work.
1263  *
1264  */
1265 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"
1266
1267 /**
1268  * @deprecated Deprecated since 4.0.
1269  * @brief Media category pinyin.
1270  * @details You can use above define to set the condition of media filter and order keyword.
1271  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1272  * @remarks Since 4.0, this keyword is related to the following feature:\n
1273  *          - %http://tizen.org/feature/content.filter.pinyin\n
1274  *            If this feature is not supported on the device, PINYIN search does not work.
1275  *
1276  */
1277 #define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"
1278
1279 /**
1280  * @deprecated Deprecated since 4.0.
1281  * @brief Media location tag pinyin.
1282  * @details You can use above define to set the condition of media filter and order keyword.
1283  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1284  * @remarks Since 4.0, this keyword is related to the following feature:\n
1285  *          - %http://tizen.org/feature/content.filter.pinyin\n
1286  *            If this feature is not supported on the device, PINYIN search does not work.
1287  *
1288  */
1289 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"
1290
1291 /**
1292  * @deprecated Deprecated since 4.0.
1293  * @brief Media age rating pinyin.
1294  * @details You can use above define to set the condition of media filter and order keyword.
1295  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1296  * @remarks Since 4.0, this keyword is related to the following feature:\n
1297  *          - %http://tizen.org/feature/content.filter.pinyin\n
1298  *            If this feature is not supported on the device, PINYIN search does not work.
1299  *
1300  */
1301 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"
1302
1303 /**
1304  * @deprecated Deprecated since 4.0.
1305  * @brief Media keyword pinyin.
1306  * @details You can use above define to set the condition of media filter and order keyword.
1307  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1308  * @remarks Since 4.0, this keyword is related to the following feature:\n
1309  *          - %http://tizen.org/feature/content.filter.pinyin\n
1310  *            If this feature is not supported on the device, PINYIN search does not work.
1311  *
1312  */
1313 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"
1314
1315 /**
1316  * @brief Virtual Reality content.
1317  * @details You can use above define to set the condition of media filter and order keyword.
1318  * @since_tizen 3.0
1319  *
1320  */
1321 #define MEDIA_360 "MEDIA_360"
1322
1323  /**
1324  * @brief Folder ID.
1325  * @details You can use above define to set the condition of folder filter and order keyword.
1326  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1327  */
1328 #define FOLDER_ID "FOLDER_ID"
1329
1330 /**
1331  * @brief Folder full path.
1332  * @details You can use above define to set the condition of folder filter and order keyword.
1333  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1334  */
1335 #define FOLDER_PATH "FOLDER_PATH"
1336
1337 /**
1338  * @brief Folder base name.
1339  * @details You can use above define to set the condition of folder filter and order keyword.
1340  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1341  */
1342 #define FOLDER_NAME "FOLDER_NAME"
1343
1344 /**
1345  * @deprecated Deprecated since 4.0.
1346  * @brief Folder modified time.
1347  * @details You can use above define to set the condition of folder filter and order keyword.
1348  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1349  */
1350 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"
1351
1352 /**
1353  * @deprecated Deprecated since 5.0.
1354  * @brief Folder storage.
1355  * @details There are 2 types:\n
1356  *               0-internal storage, 1-external storage\n
1357  *               You can use above define to set the condition of folder filter and order keyword.
1358  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1359  */
1360 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"
1361
1362 /**
1363  * @brief Folder base name pinyin.
1364  * @details You can use above define to set the condition of folder filter and order keyword.
1365  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1366  * @remarks Since 4.0, this keyword is related to the following feature:\n
1367  *          - %http://tizen.org/feature/content.filter.pinyin\n
1368  *            If this feature is not supported on the device, PINYIN search does not work.
1369  */
1370 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
1371
1372 /**
1373  * @deprecated Deprecated since 4.0.
1374  * @brief Folder order info.
1375  * @details You can use above define to set the condition of folder filter and order keyword.
1376  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1377  */
1378 #define FOLDER_ORDER "FOLDER_ORDER"
1379
1380 /**
1381  * @deprecated Deprecated since 4.0.
1382  * @brief Parent folder id.
1383  * @details You can use above define to set the condition of folder filter and order keyword.
1384  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1385  */
1386 #define FOLDER_PARENT_FOLDER_ID "FOLDER_PARENT_FOLDER_ID"
1387
1388 /**
1389  * @brief Playlist name.
1390  * @details You can use above define to set the condition of playlist filter and order keyword.
1391  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1392  */
1393 #define PLAYLIST_NAME "PLAYLIST_NAME"
1394
1395 /**
1396  * @brief Playlist id.
1397  * @details You can use above define to set the condition of playlist filter and order keyword.
1398  * @since_tizen 4.0
1399  */
1400 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
1401
1402 /**
1403  * @brief Playlist member order.
1404  * @details You can use above define to set the condition of playlist filter and order keyword.
1405  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1406  */
1407 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
1408
1409 /**
1410  * @brief Media count in playlist.
1411  * @details You can use above define to set the condition of playlist filter and order keyword.
1412  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1413  */
1414 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
1415
1416 /**
1417  * @brief Tag name.
1418  * @details You can use above define to set the condition of tag filter and order keyword.
1419  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1420  */
1421 #define TAG_NAME "TAG_NAME"
1422
1423 /**
1424  * @brief Tag id.
1425  * @details You can use above define to set the condition of tag filter and order keyword.
1426  * @since_tizen 4.0
1427  */
1428 #define MEDIA_TAG_ID "TAG_ID"
1429
1430 /**
1431  * @brief Media count in tag.
1432  * @details You can use above define to set the condition of tag filter and order keyword.
1433  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1434  */
1435 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
1436
1437 /**
1438  * @brief Bookmark marked time.
1439  * @details You can use above define to set the condition of bookmark filter and order keyword.
1440  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1441  */
1442 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
1443
1444 /**
1445  * @brief Bookmark id.
1446  * @details You can use above define to set the condition of bookmark filter and order keyword.
1447  * @since_tizen 4.0
1448  */
1449 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
1450
1451 /**
1452  * @brief Bookmark name.
1453  * @details You can use above define to set the condition of bookmark filter and order keyword.
1454  * @since_tizen 4.0
1455  */
1456 #define BOOKMARK_NAME "BOOKMARK_NAME"
1457
1458 /**
1459  * @deprecated Deprecated since 5.0.
1460  * @brief Storage ID.
1461  * @details You can use above define to set the condition of storage filter and order keyword.
1462  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1463  */
1464 #define MEDIA_STORAGE_ID                                        "STORAGE_ID"
1465
1466 /**
1467  * @deprecated Deprecated since 5.0.
1468  * @brief Storage path.
1469  * @details You can use above define to set the condition of storage filter and order keyword.
1470  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1471  */
1472 #define MEDIA_STORAGE_PATH                              "STORAGE_PATH"
1473
1474 /**
1475  * @brief Face tag.
1476  * @details You can use above define to set the condition of face filter and order keyword.
1477  * @since_tizen 3.0
1478  */
1479 #define MEDIA_FACE_TAG  "MEDIA_FACE_TAG"
1480
1481 /**
1482  * @brief Face id.
1483  * @details You can use above define to set the condition of face filter and order keyword.
1484  * @since_tizen 4.0
1485  */
1486 #define MEDIA_FACE_ID   "MEDIA_FACE_ID"
1487
1488 /**
1489  * @}
1490  */
1491
1492
1493 #ifdef __cplusplus
1494 }
1495 #endif /* __cplusplus */
1496
1497
1498 #endif /*__TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__*/