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