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  * @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  * @deprecated Deprecated since 5.0.
 427  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 428  * @brief Called when creating a thumbnail image.
 429  * @details This callback is called for completion of generating the thumbnail image.
 430  *         The following error codes can be delivered. \n
 431  *         #MEDIA_CONTENT_ERROR_NONE, \n
 432  *         #MEDIA_CONTENT_ERROR_INVALID_PARAMETER, \n
 433  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 434  *         #MEDIA_CONTENT_ERROR_PERMISSION_DENIED, \n
 435  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 436  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 437  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 438  *
 439  * @remarks The callback is called in a separate thread(not in the main loop).
 440  *
 441  * @param[in] error The error code
 442  * @param[in] path The path of the thumbnail which is generated
 443  * @param[in] user_data The user data passed from the foreach function
 444  *
 445  * @pre media_info_create_thumbnail()
 446  * @see media_info_create_thumbnail()
 447  */
 448 typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data);
 449
 450 /**
 451  * @ingroup CAPI_CONTENT_MEDIA_FACE_DETECTION_MODULE
 452  * @brief Called when face detection on the image is completed.
 453  *
 454  * @details The following error codes can be delivered. \n
 455  *         #MEDIA_CONTENT_ERROR_NONE, \n
 456  *         #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, \n
 457  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 458  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 459  *         #MEDIA_CONTENT_ERROR_DB_BUSY, \n
 460  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 461  *
 462  * @since_tizen 3.0
 463  *
 464  * @remarks The callback is called in a separate thread(not in the main loop).
 465  *
 466  * @param[in] error The error code
 467  * @param[in] face_count The number of all detected faces
 468  * @param[in] user_data The user data passed from the foreach function
 469  *
 470  * @pre media_info_start_face_detection()
 471  * @see media_info_start_face_detection()
 472  */
 473 typedef void (*media_face_detection_completed_cb)(media_content_error_e error, const int face_count, void *user_data);
 474
 475
 476 /**
 477  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 478  * @brief Called for every available media folder.
 479  * @details Iterates over a list of folders.
 480  *
 481  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 482  *
 483  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function. \n
 484  *                  The callback is called in the main loop.
 485  *
 486  * @param[in] folder The handle to the media folder
 487  * @param[in] user_data The user data passed from the foreach function
 488  *
 489  * @return @c true to continue with the next iteration of the loop,
 490  *         otherwise @c false to break out of the loop
 491  *
 492  * @pre media_folder_foreach_folder_from_db() will invoke this function.
 493  * @see media_folder_clone()
 494  * @see media_folder_foreach_folder_from_db()
 495  */
 496 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 497
 498 /**
 499  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 500  * @brief Called for every playlist in the obtained list of playlists.
 501  * @details Iterates over a playlist list.
 502  *
 503  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 504  *
 505  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function. \n
 506  *                  The callback is called in the main loop.
 507  *
 508  * @param[in] playlist The handle to the media playlist
 509  * @param[in] user_data The user data passed from the foreach function
 510  *
 511  * @return @c true to continue with the next iteration of the loop,
 512  *         otherwise @c false to break out of the loop
 513  *
 514  * @pre media_playlist_foreach_playlist_from_db() will invoke this function.
 515  *
 516  * @see media_playlist_clone()
 517  * @see media_playlist_foreach_playlist_from_db()
 518  */
 519 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 520
 521 /**
 522  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 523  * @brief Called for every media info with playlist member ID in the obtained list of media info.
 524  * @details Iterates over playlist members.
 525  *
 526  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 527  *
 528  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function. \n
 529  *                  The callback is called in the main loop.
 530  *
 531  * @param[in] playlist_member_id The ID of the playlist member
 532  * @param[in] media The handle to the media info
 533  * @param[in] user_data The user data passed from the foreach function
 534  *
 535  * @return @c true to continue with the next iteration of the loop,
 536  *         otherwise @c false to break out of the loop
 537  *
 538  * @pre media_playlist_foreach_media_from_db() will invoke this function.
 539  *
 540  * @see media_info_clone()
 541  * @see media_playlist_foreach_media_from_db()
 542  */
 543 typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
 544
 545 /**
 546  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 547  * @brief Called for every tag in the obtained list of tags.
 548  * @details Iterates over a list of tags.
 549  *
 550  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 551  *
 552  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function. \n
 553  *                  The callback is called in the main loop.
 554  *
 555  * @param[in] tag The handle to the media tag
 556  * @param[in] user_data The user data passed from the foreach function
 557  *
 558  * @return @c true to continue with the next iteration of the loop,
 559  *         otherwise @c false to break out of the loop
 560  *
 561  * @pre media_tag_foreach_tag_from_db(), media_info_foreach_tag_from_db() will invoke this function.
 562  *
 563  * @see media_tag_clone()
 564  * @see media_tag_foreach_tag_from_db()
 565  * @see media_info_foreach_tag_from_db()
 566  */
 567 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 568
 569 /**
 570  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 571  * @brief Called for every bookmark in the obtained list of bookmarks.
 572  * @details Iterates over a bookmark list.
 573  *
 574  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 575  *
 576  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function. \n
 577  *                  The callback is called in the main loop.
 578  *
 579  * @param[in] bookmark The handle to the media bookmark
 580  * @param[in] user_data The user data passed from the foreach function
 581  *
 582  * @return @c true to continue with the next iteration of the loop,
 583  *         otherwise @c false to break out of the loop
 584  *
 585  * @pre media_info_foreach_bookmark_from_db() will invoke this function.
 586  * @see media_info_foreach_bookmark_from_db()
 587  */
 588 typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
 589
 590 /**
 591  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 592  * @brief Called for every album in the obtained list of groups.
 593  * @details Iterates over an album list.
 594  *
 595  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 596  *
 597  * @remarks To use the @a album outside this function, copy the handle with the media_album_clone() function. \n
 598  *                  The callback is called in the main loop.
 599  *
 600  * @param[in] album The handle to the media album
 601  * @param[in] user_data The user data passed from the foreach function
 602  *
 603  * @return @c true to continue with the next iteration of the loop,
 604  *         otherwise @c false to break out of the loop
 605  *
 606  * @pre media_album_foreach_album_from_db() will invoke this function.
 607  *
 608  * @see media_album_clone()
 609  * @see media_album_foreach_album_from_db()
 610  */
 611 typedef bool (*media_album_cb)(media_album_h album, void *user_data);
 612
 613 /**
 614  * @ingroup CAPI_CONTENT_MEDIA_GROUP_MODULE
 615  * @brief Called for every group in the obtained list of groups.
 616  * @details Iterates over a media group list.
 617  *
 618  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 619  *
 620  * @remarks You should not free @a group_name returned by this function. \n
 621  *                  The callback is called in the main loop.
 622  *
 623  * @param[in] group_name The name of the media group
 624  * @param[in] user_data The user data passed from the foreach function
 625  *
 626  * @return @c true to continue with the next iteration of the loop,
 627  *         otherwise @c false to break out of the loop
 628  *
 629  * @pre media_group_foreach_group_from_db() will invoke this function.
 630  * @see media_group_foreach_group_from_db()
 631  */
 632 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 633
 634 /**
 635  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 636  * @brief Called for every storage in the obtained list of storages.
 637  * @details Iterates over a media storage list.
 638  *
 639  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 640  *
 641  * @remarks You should not destroy @a storage returned by this function. \n
 642  *                  The callback is called in the main loop.
 643  *
 644  * @param[in] storage The handle of the media storage
 645  * @param[in] user_data The user data passed from the foreach function
 646  *
 647  * @return @c true to continue with the next iteration of the loop,
 648  *         otherwise @c false to break out of the loop
 649  *
 650  * @pre media_storage_foreach_storage_from_db() will invoke this function.
 651  * @see media_storage_foreach_storage_from_db()
 652  */
 653 typedef bool (*media_storage_cb)(media_storage_h storage, void *user_data);
 654
 655 /**
 656  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 657  * @brief Called for every face in the obtained list of face.
 658  * @details Iterates over a media face list.
 659  *
 660  * @since_tizen 3.0
 661  *
 662  * @remarks You should not destroy @a face returned by this function. \n
 663  *                  The callback is called in the main loop.
 664  *
 665  * @param[in] face The handle of the media face
 666  * @param[in] user_data The user data passed from the foreach function
 667  *
 668  * @return @c true to continue with the next iteration of the loop,
 669  *         otherwise @c false to break out of the loop
 670  *
 671  * @pre media_info_foreach_face_from_db() will invoke this function.
 672  * @see media_info_foreach_face_from_db()
 673  */
 674 typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 675
 676 /**
 677  * @}
 678  */
 679
 680 /**
 681  * @addtogroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 682  * @{
 683  */
 684
 685  /**
 686  * @brief Media ID.
 687  * @details You can use above define to set the condition of media filter and order keyword.
 688  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 689  *
 690  */
 691 #define MEDIA_ID "MEDIA_ID"
 692
 693 /**
 694  * @brief Media full path.
 695  * @details You can use above define to set the condition of media filter and order keyword.
 696  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 697  *
 698  */
 699 #define MEDIA_PATH "MEDIA_PATH"
 700
 701 /**
 702  * @brief The file name including the extension.
 703  * @details You can use above define to set the condition of media filter and order keyword.
 704  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 705  *
 706  */
 707 #define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
 708
 709 /**
 710  * @brief Media type.
 711  * @details There are 5 media types:\n
 712  *               0-image, 1-video, 2-sound, 3-music, 4-other\n
 713  *               You can use above define to set the condition of media filter and order keyword.
 714  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 715  *
 716  */
 717 #define MEDIA_TYPE "MEDIA_TYPE"
 718
 719 /**
 720  * @brief Media MIME type.
 721  * @details You can use above define to set the condition of media filter and order keyword.
 722  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 723  *
 724  */
 725 #define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"
 726
 727
 728 /**
 729  * @brief Media file size.
 730  * @details You can use above define to set the condition of media filter and order keyword.
 731  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 732  *
 733  */
 734 #define MEDIA_SIZE "MEDIA_SIZE"
 735
 736 /**
 737  * @brief The time that content file was first added to media database.
 738  * @details You can use above define to set the condition of media filter and order keyword.
 739  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 740  *
 741  */
 742 #define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"
 743
 744 /**
 745  * @brief The last modification time provided by the file system.
 746  * @details You can use above define to set the condition of media filter and order keyword.
 747  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 748  *
 749  */
 750 #define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
 751
 752 /**
 753  * @brief  Media created time.
 754  * @details You can use above define to set the condition of media filter and order keyword.
 755  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 756  *
 757  */
 758 #define MEDIA_TIMELINE "MEDIA_TIMELINE"
 759
 760 /**
 761  * @brief Media thumbnail path.
 762  * @details You can use above define to set the condition of media filter and order keyword.
 763  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 764  *
 765  */
 766 #define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
 767
 768 /**
 769  * @brief Media title get from tag or file name.
 770  * @details You can use above define to set the condition of media filter and order keyword.
 771  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 772  *
 773  */
 774 #define MEDIA_TITLE "MEDIA_TITLE"
 775
 776 /**
 777  * @brief Media album name.
 778  * @details You can use above define to set the condition of media filter and order keyword.
 779  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 780  *
 781  */
 782 #define MEDIA_ALBUM "MEDIA_ALBUM"
 783
 784 /**
 785  * @brief Media artist.
 786  * @details You can use above define to set the condition of media filter and order keyword.
 787  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 788  *
 789  */
 790 #define MEDIA_ARTIST "MEDIA_ARTIST"
 791
 792 /**
 793  * @brief Media album artist.
 794  * @details You can use above define to set the condition of media filter and order keyword.
 795  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 796  *
 797  */
 798 #define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
 799
 800 /**
 801  * @brief Media genre.
 802  * @details You can use above define to set the condition of media filter and order keyword.
 803  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 804  *
 805  */
 806 #define MEDIA_GENRE "MEDIA_GENRE"
 807
 808 /**
 809  * @brief Media composer.
 810  * @details You can use above define to set the condition of media filter and order keyword.
 811  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 812  *
 813  */
 814 #define MEDIA_COMPOSER "MEDIA_COMPOSER"
 815
 816 /**
 817  * @brief Media year.
 818  * @details You can use above define to set the condition of media filter and order keyword.
 819  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 820  *
 821  */
 822 #define MEDIA_YEAR "MEDIA_YEAR"
 823
 824 /**
 825  * @brief Media recorded date.
 826  * @details You can use above define to set the condition of media filter and order keyword.
 827  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 828  *
 829  */
 830 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
 831
 832 /**
 833  * @brief Media copyright.
 834  * @details You can use above define to set the condition of media filter and order keyword.
 835  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 836  *
 837  */
 838 #define MEDIA_COPYRIGHT "MEDIA_COPYRIGHT"
 839
 840 /**
 841  * @brief Media track number.
 842  * @details You can use above define to set the condition of media filter and order keyword.
 843  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 844  *
 845  */
 846 #define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"
 847
 848 /**
 849  * @brief Media description.
 850  * @details You can use above define to set the condition of media filter and order keyword.
 851  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 852  *
 853  */
 854 #define MEDIA_DESCRIPTION "MEDIA_DESCRIPTION"
 855
 856 /**
 857  * @brief Media bitrate.
 858  * @details You can use above define to set the condition of media filter and order keyword.
 859  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 860  *
 861  */
 862 #define MEDIA_BITRATE "MEDIA_BITRATE"
 863
 864 /**
 865  * @brief Media bit per sample.
 866  * @details You can use above define to set the condition of media filter and order keyword.
 867  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 868  *
 869  */
 870 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"
 871
 872 /**
 873  * @brief Media sample rate.
 874  * @details You can use above define to set the condition of media filter and order keyword.
 875  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 876  *
 877  */
 878 #define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"
 879
 880 /**
 881  * @brief Media channel.
 882  * @details You can use above define to set the condition of media filter and order keyword.
 883  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 884  *
 885  */
 886 #define MEDIA_CHANNEL "MEDIA_CHANNEL"
 887
 888 /**
 889  * @brief Media duration.
 890  * @details You can use above define to set the condition of media filter and order keyword.
 891  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 892  *
 893  */
 894 #define MEDIA_DURATION "MEDIA_DURATION"
 895
 896 /**
 897  * @brief Media longitude.
 898  * @details You can use above define to set the condition of media filter and order keyword.
 899  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 900  *
 901  */
 902 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
 903
 904 /**
 905  * @brief Media latitude.
 906  * @details You can use above define to set the condition of media filter and order keyword.
 907  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 908  *
 909  */
 910 #define MEDIA_LATITUDE "MEDIA_LATITUDE"
 911
 912 /**
 913  * @brief Media altitude.
 914  * @details You can use above define to set the condition of media filter and order keyword.
 915  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 916  *
 917  */
 918 #define MEDIA_ALTITUDE "MEDIA_ALTITUDE"
 919
 920 /**
 921  * @brief Media width.
 922  * @details You can use above define to set the condition of media filter and order keyword.
 923  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 924  *
 925  */
 926 #define MEDIA_WIDTH "MEDIA_WIDTH"
 927
 928 /**
 929  * @brief Media height.
 930  * @details You can use above define to set the condition of media filter and order keyword.
 931  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 932  *
 933  */
 934 #define MEDIA_HEIGHT "MEDIA_HEIGHT"
 935
 936 /**
 937  * @brief Media datetaken.
 938  * @details You can use above define to set the condition of media filter and order keyword.
 939  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 940  *
 941  */
 942 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
 943
 944 /**
 945  * @brief Media orientation.
 946  * @details You can use above define to set the condition of media filter and order keyword.
 947  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 948  *
 949  */
 950 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 951
 952 /**
 953  * @deprecated Deprecated since 4.0.
 954  * @brief Media burst ID.
 955  * @details You can use above define to set the condition of media filter and order keyword.
 956  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 957  *
 958  */
 959 #define MEDIA_BURST_ID "BURST_ID"
 960
 961 /**
 962  * @deprecated Deprecated since 4.0.
 963  * @brief Media playedcount.
 964  * @details You can use above define to set the condition of media filter and order keyword.
 965  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 966  *
 967  */
 968 #define MEDIA_PLAYED_COUNT "MEDIA_PLAYED_COUNT"
 969
 970 /**
 971  * @deprecated Deprecated since 4.0.
 972  * @brief Media last played time.
 973  * @details You can use above define to set the condition of media filter and order keyword.
 974  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 975  *
 976  */
 977 #define MEDIA_LAST_PLAYED_TIME "MEDIA_LAST_PLAYED_TIME"
 978
 979 /**
 980  * @deprecated Deprecated since 4.0.
 981  * @brief Media last played position of file.
 982  * @details You can use above define to set the condition of media filter and order keyword.
 983  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 984  *
 985  */
 986 #define MEDIA_LAST_PLAYED_POSITION "MEDIA_LAST_PLAYED_POSITION"
 987
 988 /**
 989  * @brief Media rating.
 990  * @details You can use above define to set the condition of media filter and order keyword.
 991  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 992  *
 993  */
 994 #define MEDIA_RATING "MEDIA_RATING"
 995
 996 /**
 997  * @brief The time to register favourite.
 998  * @details You can use above define to set the condition of media filter and order keyword.
 999  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1000  *
1001  */
1002 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
1003
1004 /**
1005  * @deprecated Deprecated since 4.0.
1006  * @brief Media author.
1007  * @details You can use above define to set the condition of media filter and order keyword.
1008  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1009  *
1010  */
1011 #define MEDIA_AUTHOR "MEDIA_AUTHOR"
1012
1013 /**
1014  * @deprecated Deprecated since 4.0.
1015  * @brief Media provider.
1016  * @details You can use above define to set the condition of media filter and order keyword.
1017  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1018  *
1019  */
1020 #define MEDIA_PROVIDER "MEDIA_PROVIDER"
1021
1022 /**
1023  * @deprecated Deprecated since 4.0.
1024  * @brief Media content name.
1025  * @details You can use above define to set the condition of media filter and order keyword.
1026  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1027  *
1028  */
1029 #define MEDIA_CONTENT_NAME "MEDIA_CONTENT_NAME"
1030
1031 /**
1032  * @deprecated Deprecated since 4.0.
1033  * @brief Media category.
1034  * @details You can use above define to set the condition of media filter and order keyword.
1035  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1036  *
1037  */
1038 #define MEDIA_CATEGORY "MEDIA_CATEGORY"
1039
1040 /**
1041  * @deprecated Deprecated since 4.0.
1042  * @brief Media location tag.
1043  * @details You can use above define to set the condition of media filter and order keyword.
1044  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1045  *
1046  */
1047 #define MEDIA_LOCATION_TAG "MEDIA_LOCATION_TAG"
1048
1049 /**
1050  * @deprecated Deprecated since 4.0.
1051  * @brief Media age rating.
1052  * @details You can use above define to set the condition of media filter and order keyword.
1053  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1054  *
1055  */
1056 #define MEDIA_AGE_RATING "MEDIA_AGE_RATING"
1057
1058 /**
1059  * @deprecated Deprecated since 4.0.
1060  * @brief Media keyword.
1061  * @details You can use above define to set the condition of media filter and order keyword.
1062  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1063  *
1064  */
1065 #define MEDIA_KEYWORD "MEDIA_KEYWORD"
1066
1067 /**
1068  * @deprecated Deprecated since 4.0.
1069  * @brief Media weather.
1070  * @details You can use above define to set the condition of media filter and order keyword.
1071  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1072  *
1073  */
1074 #define MEDIA_WEATHER "MEDIA_WEATHER"
1075
1076 /**
1077  * @brief Is DRM.
1078  * @details There are 2 types:\n
1079  *               0-not drm, 1-drm\n
1080  *               You can use above define to set the condition of media filter and order keyword.
1081  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1082  *
1083  */
1084 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
1085
1086 /**
1087  * @brief Media storage.
1088  * @details There are 2 types:\n
1089  *               0-internal storage, 1-external storage\n
1090  *               You can use above define to set the condition of media filter and order keyword.
1091  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1092  *
1093  */
1094 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
1095
1096 /**
1097  * @brief Media exposure time.
1098  * @details You can use above define to set the condition of media filter and order keyword.
1099  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1100  *
1101  */
1102 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
1103
1104 /**
1105  * @brief Media fnumber.
1106  * @details You can use above define to set the condition of media filter and order keyword.
1107  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1108  *
1109  */
1110 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
1111
1112 /**
1113  * @brief Media ISO.
1114  * @details You can use above define to set the condition of media filter and order keyword.
1115  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1116  *
1117  */
1118 #define MEDIA_ISO "MEDIA_ISO"
1119
1120 /**
1121  * @brief Media model.
1122  * @details You can use above define to set the condition of media filter and order keyword.
1123  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1124  *
1125  */
1126 #define MEDIA_MODEL "MEDIA_MODEL"
1127
1128 /**
1129  * @brief Media file name pinyin.
1130  * @details You can use above define to set the condition of media filter and order keyword.
1131  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1132  * @remarks Since 4.0, this keyword is related to the following feature:\n
1133  *          - %http://tizen.org/feature/content.filter.pinyin\n
1134  *             If this feature is not supported on the device, PINYIN search does not work.
1135  *
1136  */
1137 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
1138
1139 /**
1140  * @brief Media title pinyin.
1141  * @details You can use above define to set the condition of media filter and order keyword.
1142  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1143  * @remarks Since 4.0, this keyword is related to the following feature:\n
1144  *          - %http://tizen.org/feature/content.filter.pinyin\n
1145  *             If this feature is not supported on the device, PINYIN search does not work.
1146  *
1147  */
1148 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
1149
1150 /**
1151  * @brief Media album pinyin.
1152  * @details You can use above define to set the condition of media filter and order keyword.
1153  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1154  * @remarks Since 4.0, this keyword is related to the following feature:\n
1155  *          - %http://tizen.org/feature/content.filter.pinyin\n
1156  *            If this feature is not supported on the device, PINYIN search does not work.
1157  *
1158  */
1159 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
1160
1161 /**
1162  * @brief Media artist pinyin.
1163  * @details You can use above define to set the condition of media filter and order keyword.
1164  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1165  * @remarks Since 4.0, this keyword is related to the following feature:\n
1166  *          - %http://tizen.org/feature/content.filter.pinyin\n
1167  *             If this feature is not supported on the device, PINYIN search does not work.
1168  *
1169  */
1170 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
1171
1172 /**
1173  * @brief Media album artist pinyin.
1174  * @details You can use above define to set the condition of media filter and order keyword.
1175  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1176  * @remarks Since 4.0, this keyword is related to the following feature:\n
1177  *          - %http://tizen.org/feature/content.filter.pinyin\n
1178  *            If this feature is not supported on the device, PINYIN search does not work.
1179  *
1180  */
1181 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
1182
1183 /**
1184  * @brief Media genre pinyin.
1185  * @details You can use above define to set the condition of media filter and order keyword.
1186  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1187  * @remarks Since 4.0, this keyword is related to the following feature:\n
1188  *          - %http://tizen.org/feature/content.filter.pinyin\n
1189  *            If this feature is not supported on the device, PINYIN search does not work.
1190  *
1191  */
1192 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
1193
1194 /**
1195  * @brief Media composer pinyin.
1196  * @details You can use above define to set the condition of media filter and order keyword.
1197  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1198  * @remarks Since 4.0, this keyword is related to the following feature:\n
1199  *          - %http://tizen.org/feature/content.filter.pinyin\n
1200  *            If this feature is not supported on the device, PINYIN search does not work.
1201  *
1202  */
1203 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
1204
1205 /**
1206  * @brief Media copyright pinyin.
1207  * @details You can use above define to set the condition of media filter and order keyword.
1208  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1209  * @remarks Since 4.0, this keyword is related to the following feature:\n
1210  *          - %http://tizen.org/feature/content.filter.pinyin\n
1211  *            If this feature is not supported on the device, PINYIN search does not work.
1212  *
1213  */
1214 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
1215
1216 /**
1217  * @brief Media description pinyin.
1218  * @details You can use above define to set the condition of media filter and order keyword.
1219  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1220  * @remarks Since 4.0, this keyword is related to the following feature:\n
1221  *          - %http://tizen.org/feature/content.filter.pinyin\n
1222  *            If this feature is not supported on the device, PINYIN search does not work.
1223  *
1224  */
1225 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
1226
1227 /**
1228  * @deprecated Deprecated since 4.0.
1229  * @brief Media author pinyin.
1230  * @details You can use above define to set the condition of media filter and order keyword.
1231  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1232  * @remarks Since 4.0, this keyword is related to the following feature:\n
1233  *          - %http://tizen.org/feature/content.filter.pinyin\n
1234  *            If this feature is not supported on the device, PINYIN search does not work.
1235  *
1236  */
1237 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"
1238
1239 /**
1240  * @deprecated Deprecated since 4.0.
1241  * @brief Media provider pinyin.
1242  * @details You can use above define to set the condition of media filter and order keyword.
1243  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1244  * @remarks Since 4.0, this keyword is related to the following feature:\n
1245  *          - %http://tizen.org/feature/content.filter.pinyin\n
1246  *            If this feature is not supported on the device, PINYIN search does not work.
1247  *
1248  */
1249 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"
1250
1251 /**
1252  * @deprecated Deprecated since 4.0.
1253  * @brief Media content name pinyin.
1254  * @details You can use above define to set the condition of media filter and order keyword.
1255  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1256  * @remarks Since 4.0, this keyword is related to the following feature:\n
1257  *          - %http://tizen.org/feature/content.filter.pinyin\n
1258  *            If this feature is not supported on the device, PINYIN search does not work.
1259  *
1260  */
1261 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"
1262
1263 /**
1264  * @deprecated Deprecated since 4.0.
1265  * @brief Media category pinyin.
1266  * @details You can use above define to set the condition of media filter and order keyword.
1267  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1268  * @remarks Since 4.0, this keyword is related to the following feature:\n
1269  *          - %http://tizen.org/feature/content.filter.pinyin\n
1270  *            If this feature is not supported on the device, PINYIN search does not work.
1271  *
1272  */
1273 #define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"
1274
1275 /**
1276  * @deprecated Deprecated since 4.0.
1277  * @brief Media location tag pinyin.
1278  * @details You can use above define to set the condition of media filter and order keyword.
1279  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1280  * @remarks Since 4.0, this keyword is related to the following feature:\n
1281  *          - %http://tizen.org/feature/content.filter.pinyin\n
1282  *            If this feature is not supported on the device, PINYIN search does not work.
1283  *
1284  */
1285 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"
1286
1287 /**
1288  * @deprecated Deprecated since 4.0.
1289  * @brief Media age rating pinyin.
1290  * @details You can use above define to set the condition of media filter and order keyword.
1291  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1292  * @remarks Since 4.0, this keyword is related to the following feature:\n
1293  *          - %http://tizen.org/feature/content.filter.pinyin\n
1294  *            If this feature is not supported on the device, PINYIN search does not work.
1295  *
1296  */
1297 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"
1298
1299 /**
1300  * @deprecated Deprecated since 4.0.
1301  * @brief Media keyword pinyin.
1302  * @details You can use above define to set the condition of media filter and order keyword.
1303  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1304  * @remarks Since 4.0, this keyword is related to the following feature:\n
1305  *          - %http://tizen.org/feature/content.filter.pinyin\n
1306  *            If this feature is not supported on the device, PINYIN search does not work.
1307  *
1308  */
1309 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"
1310
1311 /**
1312  * @brief Virtual Reality content.
1313  * @details You can use above define to set the condition of media filter and order keyword.
1314  * @since_tizen 3.0
1315  *
1316  */
1317 #define MEDIA_360 "MEDIA_360"
1318
1319  /**
1320  * @brief Folder ID.
1321  * @details You can use above define to set the condition of folder filter and order keyword.
1322  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1323  */
1324 #define FOLDER_ID "FOLDER_ID"
1325
1326 /**
1327  * @brief Folder full path.
1328  * @details You can use above define to set the condition of folder filter and order keyword.
1329  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1330  */
1331 #define FOLDER_PATH "FOLDER_PATH"
1332
1333 /**
1334  * @brief Folder base name.
1335  * @details You can use above define to set the condition of folder filter and order keyword.
1336  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1337  */
1338 #define FOLDER_NAME "FOLDER_NAME"
1339
1340 /**
1341  * @deprecated Deprecated since 4.0.
1342  * @brief Folder modified time.
1343  * @details You can use above define to set the condition of folder filter and order keyword.
1344  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1345  */
1346 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"
1347
1348 /**
1349  * @brief Folder storage.
1350  * @details There are 2 types:\n
1351  *               0-internal storage, 1-external storage\n
1352  *               You can use above define to set the condition of folder filter and order keyword.
1353  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1354  */
1355 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"
1356
1357 /**
1358  * @brief Folder base name pinyin.
1359  * @details You can use above define to set the condition of folder filter and order keyword.
1360  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1361  * @remarks Since 4.0, this keyword is related to the following feature:\n
1362  *          - %http://tizen.org/feature/content.filter.pinyin\n
1363  *            If this feature is not supported on the device, PINYIN search does not work.
1364  */
1365 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
1366
1367 /**
1368  * @deprecated Deprecated since 4.0.
1369  * @brief Folder order info.
1370  * @details You can use above define to set the condition of folder filter and order keyword.
1371  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1372  */
1373 #define FOLDER_ORDER "FOLDER_ORDER"
1374
1375 /**
1376  * @deprecated Deprecated since 4.0.
1377  * @brief Parent folder id.
1378  * @details You can use above define to set the condition of folder filter and order keyword.
1379  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1380  */
1381 #define FOLDER_PARENT_FOLDER_ID "FOLDER_PARENT_FOLDER_ID"
1382
1383 /**
1384  * @brief Playlist name.
1385  * @details You can use above define to set the condition of playlist filter and order keyword.
1386  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1387  */
1388 #define PLAYLIST_NAME "PLAYLIST_NAME"
1389
1390 /**
1391  * @brief Playlist id.
1392  * @details You can use above define to set the condition of playlist filter and order keyword.
1393  * @since_tizen 4.0
1394  */
1395 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
1396
1397 /**
1398  * @brief Playlist member order.
1399  * @details You can use above define to set the condition of playlist filter and order keyword.
1400  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1401  */
1402 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
1403
1404 /**
1405  * @brief Media count in playlist.
1406  * @details You can use above define to set the condition of playlist filter and order keyword.
1407  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1408  */
1409 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
1410
1411 /**
1412  * @brief Tag name.
1413  * @details You can use above define to set the condition of tag filter and order keyword.
1414  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1415  */
1416 #define TAG_NAME "TAG_NAME"
1417
1418 /**
1419  * @brief Tag id.
1420  * @details You can use above define to set the condition of tag filter and order keyword.
1421  * @since_tizen 4.0
1422  */
1423 #define MEDIA_TAG_ID "TAG_ID"
1424
1425 /**
1426  * @brief Media count in tag.
1427  * @details You can use above define to set the condition of tag filter and order keyword.
1428  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1429  */
1430 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
1431
1432 /**
1433  * @brief Bookmark marked time.
1434  * @details You can use above define to set the condition of bookmark filter and order keyword.
1435  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1436  */
1437 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
1438
1439 /**
1440  * @brief Bookmark id.
1441  * @details You can use above define to set the condition of bookmark filter and order keyword.
1442  * @since_tizen 4.0
1443  */
1444 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
1445
1446 /**
1447  * @brief Bookmark name.
1448  * @details You can use above define to set the condition of bookmark filter and order keyword.
1449  * @since_tizen 4.0
1450  */
1451 #define BOOKMARK_NAME "BOOKMARK_NAME"
1452
1453 /**
1454  * @brief Storage ID.
1455  * @details You can use above define to set the condition of storage filter and order keyword.
1456  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1457  */
1458 #define MEDIA_STORAGE_ID                                        "STORAGE_ID"
1459
1460 /**
1461  * @brief Storage path.
1462  * @details You can use above define to set the condition of storage filter and order keyword.
1463  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1464  */
1465 #define MEDIA_STORAGE_PATH                              "STORAGE_PATH"
1466
1467 /**
1468  * @brief Face tag.
1469  * @details You can use above define to set the condition of face filter and order keyword.
1470  * @since_tizen 3.0
1471  */
1472 #define MEDIA_FACE_TAG  "MEDIA_FACE_TAG"
1473
1474 /**
1475  * @brief Face id.
1476  * @details You can use above define to set the condition of face filter and order keyword.
1477  * @since_tizen 4.0
1478  */
1479 #define MEDIA_FACE_ID   "MEDIA_FACE_ID"
1480
1481 /**
1482  * @}
1483  */
1484
1485
1486 #ifdef __cplusplus
1487 }
1488 #endif /* __cplusplus */
1489
1490
1491 #endif /*__TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__*/