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 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_BOOK         = 5,    /**<The type of book (Since 6.5)*/
  56 } media_content_type_e;
  57
  58 /**
  59  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  60  * @deprecated Deprecated since 5.0.
  61  * @brief Enumeration for the storage type.
  62  * @details This information is used to establish where the folder is.
  63  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  64  */
  65 typedef enum {
  66         MEDIA_CONTENT_STORAGE_INTERNAL  = 0,    /**< The device's internal storage */
  67         MEDIA_CONTENT_STORAGE_EXTERNAL  = 1,    /**< The device's external storage like sd card*/
  68         MEDIA_CONTENT_STORAGE_EXTERNAL_USB = 2, /**< The external USB storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
  69 } media_content_storage_e;
  70
  71 /**
  72  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  73  * @brief Enumeration for media content DB update items.
  74  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  75  */
  76 typedef enum {
  77         MEDIA_ITEM_FILE         = 0,            /**< File type, an item updated to DB */
  78         MEDIA_ITEM_DIRECTORY    = 1,            /**< Directory type, an item updated to DB */
  79 } media_content_db_update_item_type_e;
  80
  81 /**
  82  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  83  * @brief Enumeration for media content DB update types.
  84  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  85  */
  86 typedef enum {
  87         MEDIA_CONTENT_INSERT            = 0,            /**< Insert, the type of DB update */
  88         MEDIA_CONTENT_DELETE            = 1,            /**< Delete, The type of DB update */
  89         MEDIA_CONTENT_UPDATE    = 2,            /**< Update, The type of DB update */
  90 } media_content_db_update_type_e;
  91
  92 /**
  93  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  94  * @brief Enumeration for orientation types.
  95  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  96  */
  97 typedef enum {
  98         MEDIA_CONTENT_ORIENTATION_NOT_AVAILABLE  = 0,       /**< Not available*/
  99         MEDIA_CONTENT_ORIENTATION_NORMAL         = 1,       /**< Normal*/
 100         MEDIA_CONTENT_ORIENTATION_HFLIP          = 2,       /**< Flip horizontal*/
 101         MEDIA_CONTENT_ORIENTATION_ROT_180        = 3,       /**< Rotate 180 degrees*/
 102         MEDIA_CONTENT_ORIENTATION_VFLIP          = 4,       /**< Flip vertical*/
 103         MEDIA_CONTENT_ORIENTATION_TRANSPOSE      = 5,       /**< Transpose*/
 104         MEDIA_CONTENT_ORIENTATION_ROT_90         = 6,       /**< Rotate 90 degrees*/
 105         MEDIA_CONTENT_ORIENTATION_TRANSVERSE     = 7,       /**< Transverse*/
 106         MEDIA_CONTENT_ORIENTATION_ROT_270        = 8,       /**< Rotate 270 degrees*/
 107 } media_content_orientation_e;
 108
 109 /**
 110  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 111  * @brief Enumeration for ordering.
 112  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 113  */
 114 typedef enum {
 115         MEDIA_CONTENT_ORDER_ASC   = 0,      /**< Ascending order*/
 116         MEDIA_CONTENT_ORDER_DESC  = 1,      /**< Descending order*/
 117         MEDIA_CONTENT_ORDER_OTHER = 2,          /**< order by order key**/
 118 } media_content_order_e;
 119
 120 /**
 121  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 122  * @brief Enumeration for collations.
 123  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 124  */
 125 typedef enum {
 126         MEDIA_CONTENT_COLLATE_DEFAULT   = 0,        /**< Default collation BINARY */
 127         MEDIA_CONTENT_COLLATE_NOCASE    = 1,        /**< Collation NOCASE, not case sensitive */
 128         MEDIA_CONTENT_COLLATE_RTRIM     = 2,        /**< Collation RTRIM, trailing space characters are ignored */
 129         MEDIA_CONTENT_COLLATE_LOCALIZED = 3,        /**< Collation LOCALIZATION, NOCASE also applied */
 130 } media_content_collation_e;
 131
 132 /**
 133 * @brief Error class.
 134 * @details Class for Media Content error
 135 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 136 *
 137 */
 138 #define MEDIA_CONTENT_ERROR_CLASS                               TIZEN_ERROR_MEDIA_CONTENT
 139
 140 /**
 141  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 142  * @brief Enumeration for a media content error.
 143  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 144  */
 145 typedef enum {
 146         MEDIA_CONTENT_ERROR_NONE                    = TIZEN_ERROR_NONE,                    /**< Successful */
 147         MEDIA_CONTENT_ERROR_INVALID_PARAMETER       = TIZEN_ERROR_INVALID_PARAMETER,       /**< Invalid parameter */
 148         MEDIA_CONTENT_ERROR_OUT_OF_MEMORY           = TIZEN_ERROR_OUT_OF_MEMORY,           /**< Out of memory */
 149         MEDIA_CONTENT_ERROR_INVALID_OPERATION       = TIZEN_ERROR_INVALID_OPERATION,       /**< Invalid Operation */
 150         MEDIA_CONTENT_FILE_NO_SPACE_ON_DEVICE       = TIZEN_ERROR_FILE_NO_SPACE_ON_DEVICE, /**< No space left on device */
 151         MEDIA_CONTENT_ERROR_PERMISSION_DENIED             = TIZEN_ERROR_PERMISSION_DENIED,                /**< Permission denied */
 152         MEDIA_CONTENT_ERROR_DB_FAILED               = MEDIA_CONTENT_ERROR_CLASS | 0x01,    /**< DB operation failed */
 153         MEDIA_CONTENT_ERROR_DB_BUSY                 = MEDIA_CONTENT_ERROR_CLASS | 0x02,    /**< DB operation BUSY */
 154         MEDIA_CONTENT_ERROR_NETWORK                 = MEDIA_CONTENT_ERROR_CLASS | 0x03,    /**< Network Fail */
 155         MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT     = MEDIA_CONTENT_ERROR_CLASS | 0x04,    /**< Unsupported Content */
 156         MEDIA_CONTENT_ERROR_NOT_SUPPORTED           = TIZEN_ERROR_NOT_SUPPORTED,           /**< Not supported */
 157 } media_content_error_e;
 158
 159 /**
 160  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 161  * @brief Enumeration for a media group.
 162  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 163  */
 164 typedef enum {
 165         MEDIA_CONTENT_GROUP_DISPLAY_NAME = 0,    /**< Media group ID for display name */
 166         MEDIA_CONTENT_GROUP_TYPE,                /**< Media group ID for a media type */
 167         MEDIA_CONTENT_GROUP_MIME_TYPE,           /**< Media group ID for a mime type */
 168         MEDIA_CONTENT_GROUP_SIZE,                /**< Media group ID for content size */
 169         MEDIA_CONTENT_GROUP_ADDED_TIME,          /**< Media group ID for the added time */
 170         MEDIA_CONTENT_GROUP_MODIFIED_TIME,       /**< Media group ID for the modified time */
 171         MEDIA_CONTENT_GROUP_TITLE,               /**< Media group ID for a content title */
 172         MEDIA_CONTENT_GROUP_ARTIST,              /**< Media group ID for an artist*/
 173         MEDIA_CONTENT_GROUP_ALBUM_ARTIST,        /**< Media group ID for an album artist */
 174         MEDIA_CONTENT_GROUP_GENRE,               /**< Media group ID for a genre*/
 175         MEDIA_CONTENT_GROUP_COMPOSER,            /**< Media group ID for a composer*/
 176         MEDIA_CONTENT_GROUP_YEAR,                /**< Media group ID for a year*/
 177         MEDIA_CONTENT_GROUP_RECORDED_DATE,       /**< Media group ID for the recorded date*/
 178         MEDIA_CONTENT_GROUP_COPYRIGHT,           /**< Media group ID for the copyright*/
 179         MEDIA_CONTENT_GROUP_TRACK_NUM,           /**< Media group ID for a track number*/
 180         MEDIA_CONTENT_GROUP_DESCRIPTION,         /**< Media group ID for a description */
 181         MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
 182         MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
 183         MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
 184         MEDIA_CONTENT_GROUP_RATING = 20,         /**< Media group ID for a rating*/
 185         MEDIA_CONTENT_GROUP_MAX = 29             /**< Invalid media group ID*/
 186 } media_group_e;
 187
 188 /**
 189  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 190  * @brief The structure type for the Media info handle.
 191  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 192  */
 193 typedef struct media_info_s *media_info_h;
 194
 195 /**
 196  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 197  * @brief The structure type for the Media folder handle.
 198  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 199  */
 200 typedef struct media_folder_s *media_folder_h;
 201
 202 /**
 203  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 204  * @brief The structure type for the Media playlist handle.
 205  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 206  */
 207 typedef struct media_playlist_s *media_playlist_h;
 208
 209 /**
 210  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 211  * @brief The structure type for the Media tag handle.
 212  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 213  */
 214 typedef struct media_tag_s *media_tag_h;
 215
 216 /**
 217  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 218  * @brief The structure type for the Media bookmark handle.
 219  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 220  */
 221 typedef struct media_bookmark_s *media_bookmark_h;
 222
 223 /**
 224  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 225  * @brief The structure type for the Media album handle.
 226  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 227  */
 228 typedef struct media_album_s *media_album_h;
 229
 230 /**
 231  * @ingroup CAPI_CONTENT_MEDIA_IMAGE_META_MODULE
 232  * @brief The structure type for the Image metadata handle.
 233  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 234  */
 235 typedef struct image_meta_s *image_meta_h;
 236
 237 /**
 238  * @ingroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE
 239  * @brief The structure type for the Video metadata handle.
 240  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 241  */
 242 typedef struct video_meta_s *video_meta_h;
 243
 244 /**
 245  * @ingroup CAPI_CONTENT_MEDIA_AUDIO_META_MODULE
 246  * @brief The structure type for the Audio metadata handle.
 247  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 248  */
 249 typedef struct audio_meta_s *audio_meta_h;
 250
 251 /**
 252  * @ingroup CAPI_CONTENT_MEDIA_BOOK_META_MODULE
 253  * @brief The structure type for the Book metadata handle.
 254  * @since_tizen 6.5
 255  */
 256 typedef struct book_meta_s *book_meta_h;
 257
 258 /**
 259  * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 260  * @brief The structure type for the Media filter handle.
 261  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 262  */
 263 typedef struct filter_s *filter_h;
 264
 265 /**
 266  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 267  * @deprecated Deprecated since 5.0.
 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_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 5.0.
 400  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 401  * @brief Called when creating a thumbnail image.
 402  * @details This callback is called for completion of generating the thumbnail image.
 403  *         The following error codes can be delivered. \n
 404  *         #MEDIA_CONTENT_ERROR_NONE, \n
 405  *         #MEDIA_CONTENT_ERROR_INVALID_PARAMETER, \n
 406  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 407  *         #MEDIA_CONTENT_ERROR_PERMISSION_DENIED, \n
 408  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 409  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 410  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 411  *
 412  * @remarks The callback is called in a separate thread(not in the main loop).
 413  *
 414  * @param[in] error The error code
 415  * @param[in] path The path of the thumbnail which is generated
 416  * @param[in] user_data The user data passed from the foreach function
 417  *
 418  * @pre media_info_create_thumbnail()
 419  * @see media_info_create_thumbnail()
 420  */
 421 typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data);
 422
 423 /**
 424  * @ingroup CAPI_CONTENT_MEDIA_FACE_DETECTION_MODULE
 425  * @brief Called when face detection on the image is completed.
 426  *
 427  * @details The following error codes can be delivered. \n
 428  *         #MEDIA_CONTENT_ERROR_NONE, \n
 429  *         #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, \n
 430  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 431  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 432  *         #MEDIA_CONTENT_ERROR_DB_BUSY, \n
 433  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 434  *
 435  * @since_tizen 3.0
 436  *
 437  * @remarks The callback is called in a separate thread(not in the main loop).
 438  *
 439  * @param[in] error The error code
 440  * @param[in] face_count The number of all detected faces
 441  * @param[in] user_data The user data passed from the foreach function
 442  *
 443  * @pre media_info_start_face_detection()
 444  * @see media_info_start_face_detection()
 445  */
 446 typedef void (*media_face_detection_completed_cb)(media_content_error_e error, const int face_count, void *user_data);
 447
 448
 449 /**
 450  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 451  * @brief Called for every available media folder.
 452  * @details Iterates over a list of folders.
 453  *
 454  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 455  *
 456  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function. \n
 457  *                  The callback is called in the main loop.
 458  *
 459  * @param[in] folder The handle to the media folder
 460  * @param[in] user_data The user data passed from the foreach function
 461  *
 462  * @return @c true to continue with the next iteration of the loop,
 463  *         otherwise @c false to break out of the loop
 464  *
 465  * @pre media_folder_foreach_folder_from_db() will invoke this function.
 466  * @see media_folder_clone()
 467  * @see media_folder_foreach_folder_from_db()
 468  */
 469 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 470
 471 /**
 472  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 473  * @brief Called for every playlist in the obtained list of playlists.
 474  * @details Iterates over a playlist list.
 475  *
 476  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 477  *
 478  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function. \n
 479  *                  The callback is called in the main loop.
 480  *
 481  * @param[in] playlist The handle to the media playlist
 482  * @param[in] user_data The user data passed from the foreach function
 483  *
 484  * @return @c true to continue with the next iteration of the loop,
 485  *         otherwise @c false to break out of the loop
 486  *
 487  * @pre media_playlist_foreach_playlist_from_db() will invoke this function.
 488  *
 489  * @see media_playlist_clone()
 490  * @see media_playlist_foreach_playlist_from_db()
 491  */
 492 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 493
 494 /**
 495  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 496  * @brief Called for every media info with playlist member ID in the obtained list of media info.
 497  * @details Iterates over playlist members.
 498  *
 499  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 500  *
 501  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function. \n
 502  *                  The callback is called in the main loop.
 503  *
 504  * @param[in] playlist_member_id The ID of the playlist member
 505  * @param[in] media The handle to the media info
 506  * @param[in] user_data The user data passed from the foreach function
 507  *
 508  * @return @c true to continue with the next iteration of the loop,
 509  *         otherwise @c false to break out of the loop
 510  *
 511  * @pre media_playlist_foreach_media_from_db() will invoke this function.
 512  *
 513  * @see media_info_clone()
 514  * @see media_playlist_foreach_media_from_db()
 515  */
 516 typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
 517
 518 /**
 519  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 520  * @brief Called for every tag in the obtained list of tags.
 521  * @details Iterates over a list of tags.
 522  *
 523  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 524  *
 525  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function. \n
 526  *                  The callback is called in the main loop.
 527  *
 528  * @param[in] tag The handle to the media tag
 529  * @param[in] user_data The user data passed from the foreach function
 530  *
 531  * @return @c true to continue with the next iteration of the loop,
 532  *         otherwise @c false to break out of the loop
 533  *
 534  * @pre media_tag_foreach_tag_from_db(), media_info_foreach_tag_from_db() will invoke this function.
 535  *
 536  * @see media_tag_clone()
 537  * @see media_tag_foreach_tag_from_db()
 538  * @see media_info_foreach_tag_from_db()
 539  */
 540 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 541
 542 /**
 543  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 544  * @brief Called for every bookmark in the obtained list of bookmarks.
 545  * @details Iterates over a bookmark list.
 546  *
 547  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 548  *
 549  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function. \n
 550  *                  The callback is called in the main loop.
 551  *
 552  * @param[in] bookmark The handle to the media bookmark
 553  * @param[in] user_data The user data passed from the foreach function
 554  *
 555  * @return @c true to continue with the next iteration of the loop,
 556  *         otherwise @c false to break out of the loop
 557  *
 558  * @pre media_info_foreach_bookmark_from_db() will invoke this function.
 559  * @see media_info_foreach_bookmark_from_db()
 560  */
 561 typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
 562
 563 /**
 564  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 565  * @brief Called for every album in the obtained list of groups.
 566  * @details Iterates over an album list.
 567  *
 568  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 569  *
 570  * @remarks To use the @a album outside this function, copy the handle with the media_album_clone() function. \n
 571  *                  The callback is called in the main loop.
 572  *
 573  * @param[in] album The handle to the media album
 574  * @param[in] user_data The user data passed from the foreach function
 575  *
 576  * @return @c true to continue with the next iteration of the loop,
 577  *         otherwise @c false to break out of the loop
 578  *
 579  * @pre media_album_foreach_album_from_db() will invoke this function.
 580  *
 581  * @see media_album_clone()
 582  * @see media_album_foreach_album_from_db()
 583  */
 584 typedef bool (*media_album_cb)(media_album_h album, void *user_data);
 585
 586 /**
 587  * @ingroup CAPI_CONTENT_MEDIA_GROUP_MODULE
 588  * @brief Called for every group in the obtained list of groups.
 589  * @details Iterates over a media group list.
 590  *
 591  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 592  *
 593  * @remarks You should not free @a group_name returned by this function. \n
 594  *                  The callback is called in the main loop.
 595  *
 596  * @param[in] group_name The name of the media group
 597  * @param[in] user_data The user data passed from the foreach function
 598  *
 599  * @return @c true to continue with the next iteration of the loop,
 600  *         otherwise @c false to break out of the loop
 601  *
 602  * @pre media_group_foreach_group_from_db() will invoke this function.
 603  * @see media_group_foreach_group_from_db()
 604  */
 605 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 606
 607 /**
 608  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 609  * @deprecated Deprecated since 5.0.
 610  * @brief Called for every storage in the obtained list of storages.
 611  * @details Iterates over a media storage list.
 612  *
 613  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 614  *
 615  * @remarks You should not destroy @a storage returned by this function. \n
 616  *                  The callback is called in the main loop.
 617  *
 618  * @param[in] storage The handle of the media storage
 619  * @param[in] user_data The user data passed from the foreach function
 620  *
 621  * @return @c true to continue with the next iteration of the loop,
 622  *         otherwise @c false to break out of the loop
 623  *
 624  * @pre media_storage_foreach_storage_from_db() will invoke this function.
 625  * @see media_storage_foreach_storage_from_db()
 626  */
 627 typedef bool (*media_storage_cb)(media_storage_h storage, void *user_data);
 628
 629 /**
 630  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 631  * @brief Called for every face in the obtained list of face.
 632  * @details Iterates over a media face list.
 633  *
 634  * @since_tizen 3.0
 635  *
 636  * @remarks You should not destroy @a face returned by this function. \n
 637  *                  The callback is called in the main loop.
 638  *
 639  * @param[in] face The handle of the media face
 640  * @param[in] user_data The user data passed from the foreach function
 641  *
 642  * @return @c true to continue with the next iteration of the loop,
 643  *         otherwise @c false to break out of the loop
 644  *
 645  * @pre media_info_foreach_face_from_db() will invoke this function.
 646  * @see media_info_foreach_face_from_db()
 647  */
 648 typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 649
 650 /**
 651  * @}
 652  */
 653
 654 /**
 655  * @addtogroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 656  * @{
 657  */
 658
 659  /**
 660  * @brief Media ID.
 661  * @details You can use above define to set the condition of media filter and order keyword.
 662  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 663  *
 664  */
 665 #define MEDIA_ID "MEDIA_ID"
 666
 667 /**
 668  * @brief Media full path.
 669  * @details You can use above define to set the condition of media filter and order keyword.
 670  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 671  *
 672  */
 673 #define MEDIA_PATH "MEDIA_PATH"
 674
 675 /**
 676  * @brief The file name including the extension.
 677  * @details You can use above define to set the condition of media filter and order keyword.
 678  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 679  *
 680  */
 681 #define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
 682
 683 /**
 684  * @brief Media type.
 685  * @details There are 5 media types:\n
 686  *               0-image, 1-video, 2-sound, 3-music, 4-other\n
 687  *               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_TYPE "MEDIA_TYPE"
 692
 693 /**
 694  * @brief Media MIME type.
 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_MIME_TYPE "MEDIA_MIME_TYPE"
 700
 701
 702 /**
 703  * @brief Media file size.
 704  * @details You can use above define to set the condition of media filter and order keyword.
 705  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 706  *
 707  */
 708 #define MEDIA_SIZE "MEDIA_SIZE"
 709
 710 /**
 711  * @brief The time that content file was first added to media database.
 712  * @details 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_ADDED_TIME "MEDIA_ADDED_TIME"
 717
 718 /**
 719  * @brief The last modification time provided by the file system.
 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_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
 725
 726 /**
 727  * @brief  Media created time.
 728  * @details You can use above define to set the condition of media filter and order keyword.
 729  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 730  *
 731  */
 732 #define MEDIA_TIMELINE "MEDIA_TIMELINE"
 733
 734 /**
 735  * @brief Media thumbnail path.
 736  * @details You can use above define to set the condition of media filter and order keyword.
 737  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 738  *
 739  */
 740 #define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
 741
 742 /**
 743  * @brief Media title get from tag or file name.
 744  * @details You can use above define to set the condition of media filter and order keyword.
 745  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 746  *
 747  */
 748 #define MEDIA_TITLE "MEDIA_TITLE"
 749
 750 /**
 751  * @brief Media album name.
 752  * @details You can use above define to set the condition of media filter and order keyword.
 753  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 754  *
 755  */
 756 #define MEDIA_ALBUM "MEDIA_ALBUM"
 757
 758 /**
 759  * @brief Media artist.
 760  * @details You can use above define to set the condition of media filter and order keyword.
 761  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 762  *
 763  */
 764 #define MEDIA_ARTIST "MEDIA_ARTIST"
 765
 766 /**
 767  * @brief Media album artist.
 768  * @details You can use above define to set the condition of media filter and order keyword.
 769  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 770  *
 771  */
 772 #define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
 773
 774 /**
 775  * @brief Media genre.
 776  * @details You can use above define to set the condition of media filter and order keyword.
 777  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 778  *
 779  */
 780 #define MEDIA_GENRE "MEDIA_GENRE"
 781
 782 /**
 783  * @brief Media composer.
 784  * @details You can use above define to set the condition of media filter and order keyword.
 785  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 786  *
 787  */
 788 #define MEDIA_COMPOSER "MEDIA_COMPOSER"
 789
 790 /**
 791  * @brief Media year.
 792  * @details You can use above define to set the condition of media filter and order keyword.
 793  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 794  *
 795  */
 796 #define MEDIA_YEAR "MEDIA_YEAR"
 797
 798 /**
 799  * @brief Media recorded date.
 800  * @details You can use above define to set the condition of media filter and order keyword.
 801  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 802  *
 803  */
 804 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
 805
 806 /**
 807  * @deprecated Deprecated since 5.5.
 808  * @brief Media copyright.
 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_COPYRIGHT "MEDIA_COPYRIGHT"
 814
 815 /**
 816  * @brief Media track number.
 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_TRACK_NUM "MEDIA_TRACK_NUM"
 822
 823 /**
 824  * @deprecated Deprecated since 5.5.
 825  * @brief Media description.
 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_DESCRIPTION "MEDIA_DESCRIPTION"
 831
 832 /**
 833  * @deprecated Deprecated since 5.5.
 834  * @brief Media bitrate.
 835  * @details You can use above define to set the condition of media filter and order keyword.
 836  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 837  *
 838  */
 839 #define MEDIA_BITRATE "MEDIA_BITRATE"
 840
 841 /**
 842  * @deprecated Deprecated since 5.5.
 843  * @brief Media bit per sample.
 844  * @details You can use above define to set the condition of media filter and order keyword.
 845  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 846  *
 847  */
 848 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"
 849
 850 /**
 851  * @deprecated Deprecated since 5.5.
 852  * @brief Media sample rate.
 853  * @details You can use above define to set the condition of media filter and order keyword.
 854  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 855  *
 856  */
 857 #define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"
 858
 859 /**
 860  * @deprecated Deprecated since 5.5.
 861  * @brief Media channel.
 862  * @details You can use above define to set the condition of media filter and order keyword.
 863  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 864  *
 865  */
 866 #define MEDIA_CHANNEL "MEDIA_CHANNEL"
 867
 868 /**
 869  * @brief Media duration.
 870  * @details You can use above define to set the condition of media filter and order keyword.
 871  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 872  *
 873  */
 874 #define MEDIA_DURATION "MEDIA_DURATION"
 875
 876 /**
 877  * @brief Media longitude.
 878  * @details You can use above define to set the condition of media filter and order keyword.
 879  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 880  *
 881  */
 882 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
 883
 884 /**
 885  * @brief Media latitude.
 886  * @details You can use above define to set the condition of media filter and order keyword.
 887  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 888  *
 889  */
 890 #define MEDIA_LATITUDE "MEDIA_LATITUDE"
 891
 892 /**
 893  * @brief Media altitude.
 894  * @details You can use above define to set the condition of media filter and order keyword.
 895  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 896  *
 897  */
 898 #define MEDIA_ALTITUDE "MEDIA_ALTITUDE"
 899
 900 /**
 901  * @brief Media width.
 902  * @details You can use above define to set the condition of media filter and order keyword.
 903  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 904  *
 905  */
 906 #define MEDIA_WIDTH "MEDIA_WIDTH"
 907
 908 /**
 909  * @brief Media height.
 910  * @details You can use above define to set the condition of media filter and order keyword.
 911  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 912  *
 913  */
 914 #define MEDIA_HEIGHT "MEDIA_HEIGHT"
 915
 916 /**
 917  * @brief Media datetaken.
 918  * @details You can use above define to set the condition of media filter and order keyword.
 919  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 920  *
 921  */
 922 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
 923
 924 /**
 925  * @deprecated Deprecated since 5.5.
 926  * @brief Media orientation.
 927  * @details You can use above define to set the condition of media filter and order keyword.
 928  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 929  *
 930  */
 931 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 932
 933 /**
 934  * @deprecated Deprecated since 5.5.
 935  * @brief Media rating.
 936  * @details You can use above define to set the condition of media filter and order keyword.
 937  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 938  *
 939  */
 940 #define MEDIA_RATING "MEDIA_RATING"
 941
 942 /**
 943  * @brief The time to register favourite.
 944  * @details You can use above define to set the condition of media filter and order keyword.
 945  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 946  *
 947  */
 948 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
 949
 950 /**
 951  * @brief Is DRM.
 952  * @details There are 2 types:\n
 953  *               0-not drm, 1-drm\n
 954  *               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_IS_DRM "MEDIA_IS_DRM"
 959
 960 /**
 961  * @deprecated Deprecated since 5.0.
 962  * @brief Media storage.
 963  * @details There are 3 types:\n
 964  *               0-internal storage, 1-SD card, 2-USB storage\n
 965  *               You can use above define to set the condition of media filter and order keyword.
 966  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 967  *
 968  */
 969 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
 970
 971 /**
 972  * @deprecated Deprecated since 5.5.
 973  * @brief Media exposure time.
 974  * @details You can use above define to set the condition of media filter and order keyword.
 975  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 976  *
 977  */
 978 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
 979
 980 /**
 981  * @deprecated Deprecated since 5.5.
 982  * @brief Media fnumber.
 983  * @details You can use above define to set the condition of media filter and order keyword.
 984  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 985  *
 986  */
 987 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
 988
 989 /**
 990  * @deprecated Deprecated since 5.5.
 991  * @brief Media ISO.
 992  * @details You can use above define to set the condition of media filter and order keyword.
 993  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 994  *
 995  */
 996 #define MEDIA_ISO "MEDIA_ISO"
 997
 998 /**
 999  * @deprecated Deprecated since 5.5.
1000  * @brief Media model.
1001  * @details You can use above define to set the condition of media filter and order keyword.
1002  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1003  *
1004  */
1005 #define MEDIA_MODEL "MEDIA_MODEL"
1006
1007 /**
1008  * @brief Media file name pinyin.
1009  * @details You can use above define to set the condition of media filter and order keyword.
1010  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1011  * @remarks Since 4.0, this keyword is related to the following feature:\n
1012  *          - %http://tizen.org/feature/content.filter.pinyin\n
1013  *             If this feature is not supported on the device, PINYIN search does not work.
1014  *
1015  */
1016 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
1017
1018 /**
1019  * @brief Media title pinyin.
1020  * @details You can use above define to set the condition of media filter and order keyword.
1021  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1022  * @remarks Since 4.0, this keyword is related to the following feature:\n
1023  *          - %http://tizen.org/feature/content.filter.pinyin\n
1024  *             If this feature is not supported on the device, PINYIN search does not work.
1025  *
1026  */
1027 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
1028
1029 /**
1030  * @brief Media album pinyin.
1031  * @details You can use above define to set the condition of media filter and order keyword.
1032  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1033  * @remarks Since 4.0, this keyword is related to the following feature:\n
1034  *          - %http://tizen.org/feature/content.filter.pinyin\n
1035  *            If this feature is not supported on the device, PINYIN search does not work.
1036  *
1037  */
1038 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
1039
1040 /**
1041  * @brief Media artist pinyin.
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  * @remarks Since 4.0, this keyword is related to the following feature:\n
1045  *          - %http://tizen.org/feature/content.filter.pinyin\n
1046  *             If this feature is not supported on the device, PINYIN search does not work.
1047  *
1048  */
1049 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
1050
1051 /**
1052  * @brief Media album artist pinyin.
1053  * @details You can use above define to set the condition of media filter and order keyword.
1054  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1055  * @remarks Since 4.0, this keyword is related to the following feature:\n
1056  *          - %http://tizen.org/feature/content.filter.pinyin\n
1057  *            If this feature is not supported on the device, PINYIN search does not work.
1058  *
1059  */
1060 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
1061
1062 /**
1063  * @brief Media genre pinyin.
1064  * @details You can use above define to set the condition of media filter and order keyword.
1065  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1066  * @remarks Since 4.0, this keyword is related to the following feature:\n
1067  *          - %http://tizen.org/feature/content.filter.pinyin\n
1068  *            If this feature is not supported on the device, PINYIN search does not work.
1069  *
1070  */
1071 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
1072
1073 /**
1074  * @brief Media composer pinyin.
1075  * @details You can use above define to set the condition of media filter and order keyword.
1076  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1077  * @remarks Since 4.0, this keyword is related to the following feature:\n
1078  *          - %http://tizen.org/feature/content.filter.pinyin\n
1079  *            If this feature is not supported on the device, PINYIN search does not work.
1080  *
1081  */
1082 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
1083
1084 /**
1085  * @deprecated Deprecated since 5.5.
1086  * @brief Media copyright pinyin.
1087  * @details You can use above define to set the condition of media filter and order keyword.
1088  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1089  * @remarks Since 4.0, this keyword is related to the following feature:\n
1090  *          - %http://tizen.org/feature/content.filter.pinyin\n
1091  *            If this feature is not supported on the device, PINYIN search does not work.
1092  *
1093  */
1094 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
1095
1096 /**
1097  * @deprecated Deprecated since 5.5.
1098  * @brief Media description pinyin.
1099  * @details You can use above define to set the condition of media filter and order keyword.
1100  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1101  * @remarks Since 4.0, this keyword is related to the following feature:\n
1102  *          - %http://tizen.org/feature/content.filter.pinyin\n
1103  *            If this feature is not supported on the device, PINYIN search does not work.
1104  *
1105  */
1106 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
1107
1108 /**
1109  * @brief Virtual Reality content.
1110  * @details You can use above define to set the condition of media filter and order keyword.
1111  * @since_tizen 3.0
1112  *
1113  */
1114 #define MEDIA_360 "MEDIA_360"
1115
1116  /**
1117  * @brief Folder ID.
1118  * @details You can use above define to set the condition of folder filter and order keyword.
1119  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1120  */
1121 #define FOLDER_ID "FOLDER_ID"
1122
1123 /**
1124  * @brief Folder full path.
1125  * @details You can use above define to set the condition of folder filter and order keyword.
1126  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1127  */
1128 #define FOLDER_PATH "FOLDER_PATH"
1129
1130 /**
1131  * @brief Folder base name.
1132  * @details You can use above define to set the condition of folder filter and order keyword.
1133  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1134  */
1135 #define FOLDER_NAME "FOLDER_NAME"
1136
1137 /**
1138  * @deprecated Deprecated since 5.0.
1139  * @brief Folder storage.
1140  * @details There are 2 types:\n
1141  *               0-internal storage, 1-external storage\n
1142  *               You can use above define to set the condition of folder filter and order keyword.
1143  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1144  */
1145 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"
1146
1147 /**
1148  * @brief Folder base name pinyin.
1149  * @details You can use above define to set the condition of folder filter and order keyword.
1150  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1151  * @remarks Since 4.0, this keyword is related to the following feature:\n
1152  *          - %http://tizen.org/feature/content.filter.pinyin\n
1153  *            If this feature is not supported on the device, PINYIN search does not work.
1154  */
1155 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
1156
1157 /**
1158  * @brief Playlist name.
1159  * @details You can use above define to set the condition of playlist filter and order keyword.
1160  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1161  */
1162 #define PLAYLIST_NAME "PLAYLIST_NAME"
1163
1164 /**
1165  * @brief Playlist id.
1166  * @details You can use above define to set the condition of playlist filter and order keyword.
1167  * @since_tizen 4.0
1168  */
1169 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
1170
1171 /**
1172  * @brief Playlist member order.
1173  * @details You can use above define to set the condition of playlist filter and order keyword.
1174  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1175  */
1176 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
1177
1178 /**
1179  * @brief Media count in playlist.
1180  * @details You can use above define to set the condition of playlist filter and order keyword.
1181  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1182  */
1183 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
1184
1185 /**
1186  * @brief Tag name.
1187  * @details You can use above define to set the condition of tag filter and order keyword.
1188  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1189  */
1190 #define TAG_NAME "TAG_NAME"
1191
1192 /**
1193  * @brief Tag id.
1194  * @details You can use above define to set the condition of tag filter and order keyword.
1195  * @since_tizen 4.0
1196  */
1197 #define MEDIA_TAG_ID "TAG_ID"
1198
1199 /**
1200  * @brief Media count in tag.
1201  * @details You can use above define to set the condition of tag filter and order keyword.
1202  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1203  */
1204 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
1205
1206 /**
1207  * @brief Bookmark marked time.
1208  * @details You can use above define to set the condition of bookmark filter and order keyword.
1209  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1210  */
1211 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
1212
1213 /**
1214  * @brief Bookmark id.
1215  * @details You can use above define to set the condition of bookmark filter and order keyword.
1216  * @since_tizen 4.0
1217  */
1218 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
1219
1220 /**
1221  * @brief Bookmark name.
1222  * @details You can use above define to set the condition of bookmark filter and order keyword.
1223  * @since_tizen 4.0
1224  */
1225 #define BOOKMARK_NAME "BOOKMARK_NAME"
1226
1227 /**
1228  * @deprecated Deprecated since 5.0.
1229  * @brief Storage ID.
1230  * @details You can use above define to set the condition of storage filter and order keyword.
1231  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1232  */
1233 #define MEDIA_STORAGE_ID                                        "STORAGE_ID"
1234
1235 /**
1236  * @deprecated Deprecated since 5.0.
1237  * @brief Storage path.
1238  * @details You can use above define to set the condition of storage filter and order keyword.
1239  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1240  */
1241 #define MEDIA_STORAGE_PATH                              "STORAGE_PATH"
1242
1243 /**
1244  * @brief Face tag.
1245  * @details You can use above define to set the condition of face filter and order keyword.
1246  * @since_tizen 3.0
1247  */
1248 #define MEDIA_FACE_TAG  "MEDIA_FACE_TAG"
1249
1250 /**
1251  * @brief Face id.
1252  * @details You can use above define to set the condition of face filter and order keyword.
1253  * @since_tizen 4.0
1254  */
1255 #define MEDIA_FACE_ID   "MEDIA_FACE_ID"
1256
1257 /**
1258  * @}
1259  */
1260
1261
1262 #ifdef __cplusplus
1263 }
1264 #endif /* __cplusplus */
1265
1266
1267 #endif /*__TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__*/