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_e;
  56
  57 /**
  58  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  59  * @deprecated Deprecated since 5.0.
  60  * @brief Enumeration for the storage type.
  61  * @details This information is used to establish where the folder is.
  62  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  63  */
  64 typedef enum {
  65         MEDIA_CONTENT_STORAGE_INTERNAL  = 0,    /**< The device's internal storage */
  66         MEDIA_CONTENT_STORAGE_EXTERNAL  = 1,    /**< The device's external storage like sd card*/
  67         MEDIA_CONTENT_STORAGE_EXTERNAL_USB = 2, /**< The external USB storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
  68 } media_content_storage_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_RATING = 20,         /**< Media group ID for a rating*/
 184         MEDIA_CONTENT_GROUP_MAX = 29             /**< Invalid media group ID*/
 185 } media_group_e;
 186
 187 /**
 188  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 189  * @brief The structure type for the Media info handle.
 190  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 191  */
 192 typedef struct media_info_s *media_info_h;
 193
 194 /**
 195  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 196  * @brief The structure type for the Media folder handle.
 197  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 198  */
 199 typedef struct media_folder_s *media_folder_h;
 200
 201 /**
 202  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 203  * @brief The structure type for the Media playlist handle.
 204  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 205  */
 206 typedef struct media_playlist_s *media_playlist_h;
 207
 208 /**
 209  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 210  * @brief The structure type for the Media tag handle.
 211  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 212  */
 213 typedef struct media_tag_s *media_tag_h;
 214
 215 /**
 216  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 217  * @brief The structure type for the Media bookmark handle.
 218  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 219  */
 220 typedef struct media_bookmark_s *media_bookmark_h;
 221
 222 /**
 223  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 224  * @brief The structure type for the Media album handle.
 225  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 226  */
 227 typedef struct media_album_s *media_album_h;
 228
 229 /**
 230  * @ingroup CAPI_CONTENT_MEDIA_IMAGE_META_MODULE
 231  * @brief The structure type for the Image metadata handle.
 232  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 233  */
 234 typedef struct image_meta_s *image_meta_h;
 235
 236 /**
 237  * @ingroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE
 238  * @brief The structure type for the Video metadata handle.
 239  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 240  */
 241 typedef struct video_meta_s *video_meta_h;
 242
 243 /**
 244  * @ingroup CAPI_CONTENT_MEDIA_AUDIO_META_MODULE
 245  * @brief The structure type for the Audio metadata handle.
 246  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 247  */
 248 typedef struct audio_meta_s *audio_meta_h;
 249
 250 /**
 251  * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 252  * @brief The structure type for the Media filter handle.
 253  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 254  */
 255 typedef struct filter_s *filter_h;
 256
 257 /**
 258  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 259  * @deprecated Deprecated since 5.0.
 260  * @brief The structure type for the Media storage handle.
 261  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 262  */
 263 typedef void *media_storage_h;
 264
 265 /**
 266  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 267  * @brief The structure type for the Media face handle.
 268  * @since_tizen 3.0
 269  */
 270 typedef void *media_face_h;
 271
 272 /**
 273  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 274  * @brief The structure type for the Media content noti handle.
 275  * @since_tizen 3.0
 276  */
 277 typedef void *media_content_noti_h;
 278
 279 /**
 280  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 281  * @brief Called when the media scanning is finished.
 282  * @details The following error codes can be received: \n
 283  *             #MEDIA_CONTENT_ERROR_NONE : Success \n
 284  *             #MEDIA_CONTENT_ERROR_INVALID_PARAMETER : Invalid parameter \n
 285  *             #MEDIA_CONTENT_ERROR_INVALID_OPERATION : Invalid operation \n
 286  *             #MEDIA_CONTENT_ERROR_PERMISSION_DENIED : Permission denied \n
 287  *             #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY : Out of memory \n
 288  *             #MEDIA_CONTENT_ERROR_DB_FAILED : DB Operation failed \n
 289  *             #MEDIA_CONTENT_ERROR_DB_BUSY : DB Operation busy \n
 290  *             #MEDIA_CONTENT_ERROR_NETWORK : Network fail \n
 291  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 292  * @remarks The callback is called in a separate thread(not in the main loop).
 293  *
 294  * @param[in] error The error code
 295  * @param[in] user_data The user data passed from the foreach function
 296  *
 297  * @pre media_content_scan_folder().
 298  * @see media_content_scan_folder()
 299  */
 300 typedef void (*media_scan_completed_cb)(media_content_error_e error, void * user_data);
 301
 302 /**
 303  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 304  * @brief Called when the notification of the media DB change is subscribed.
 305  * @details The following error codes can be received: \n
 306  *             #MEDIA_CONTENT_ERROR_NONE : Success \n
 307  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 308  *
 309  * @remarks The callback is called in a separate thread(not in the main loop).
 310  *
 311  * @param[in] error The error code
 312  * @param[in] pid The PID which publishes notification
 313  * @param[in] update_item The update item of notification
 314  * @param[in] update_type The update type of notification
 315  * @param[in] media_type The type of the media content (#media_content_type_e)
 316  * @param[in] uuid The UUID of media or directory, which is updated
 317  * @param[in] path The path of the media or directory
 318  * @param[in] mime_type The MIME of the media info
 319  * @param[in] user_data The user data passed from the foreach function
 320  *
 321  * @pre media_content_add_db_updated_cb().
 322  * @see media_content_add_db_updated_cb()
 323  */
 324 typedef void (*media_content_db_update_cb)(
 325                                 media_content_error_e error,
 326                                 int pid,
 327                                 media_content_db_update_item_type_e update_item,
 328                                 media_content_db_update_type_e update_type,
 329                                 media_content_type_e media_type,
 330                                 char *uuid,
 331                                 char *path,
 332                                 char *mime_type,
 333                                 void *user_data);
 334
 335
 336 /**
 337  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 338  * @brief Called for every available media info.
 339  * @details Iterates over a list of media info.
 340  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 341  *
 342  * @remarks To use the @a media outside this function, copy the handle with media_info_clone() function. \n
 343  *                  The callback is called in the main loop.
 344  *
 345  * @param[in] media The handle to the media info
 346  * @param[in] user_data The user data passed from the foreach function
 347  *
 348  * @return @c true to continue with the next iteration of the loop,
 349  *         otherwise @c false to break out of the loop
 350  *
 351  * @pre media_tag_foreach_media_from_db(), media_playlist_foreach_media_from_db(), media_genre_foreach_media_from_db(),
 352  *      media_info_foreach_media_from_db(), media_folder_foreach_media_from_db() will invoke this function.
 353  *
 354  * @see media_info_clone()
 355  * @see media_album_foreach_media_from_db()
 356  * @see media_playlist_foreach_media_from_db()
 357  * @see media_tag_foreach_media_from_db()
 358  * @see media_info_foreach_media_from_db()
 359  * @see media_folder_foreach_media_from_db()
 360  */
 361 typedef bool (*media_info_cb)(media_info_h media, void *user_data);
 362
 363
 364 /**
 365  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 366  * @brief Called when media items are inserted completely.
 367  * @details The following error codes can be received: \n
 368  *             #MEDIA_CONTENT_ERROR_NONE : Success \n
 369  *             #MEDIA_CONTENT_ERROR_INVALID_PARAMETER : Invalid parameter \n
 370  *             #MEDIA_CONTENT_ERROR_INVALID_OPERATION : Invalid operation \n
 371  *             #MEDIA_CONTENT_ERROR_PERMISSION_DENIED : Permission denied \n
 372  *             #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY : Out of memory \n
 373  *             #MEDIA_CONTENT_ERROR_DB_FAILED : DB Operation failed \n
 374  *             #MEDIA_CONTENT_ERROR_DB_BUSY : DB Operation busy \n
 375  *             #MEDIA_CONTENT_ERROR_NETWORK : Network fail \n
 376  *             #MEDIA_CONTENT_ERROR_NOT_SUPPORTED : Not supported \n
 377  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 378  *
 379  * @remarks The callback is called in a separate thread(not in the main loop).
 380  *
 381  * @param[in] error The error code
 382  * @param[in] user_data The user data passed from the foreach function
 383  *
 384  * @pre media_info_insert_batch_to_db()
 385  * @see media_info_insert_batch_to_db()
 386  */
 387 typedef void (*media_insert_completed_cb)(media_content_error_e error, void * user_data);
 388
 389
 390 /**
 391  * @deprecated Deprecated since 5.0.
 392  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 393  * @brief Called when creating a thumbnail image.
 394  * @details This callback is called for completion of generating the thumbnail image.
 395  *         The following error codes can be delivered. \n
 396  *         #MEDIA_CONTENT_ERROR_NONE, \n
 397  *         #MEDIA_CONTENT_ERROR_INVALID_PARAMETER, \n
 398  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 399  *         #MEDIA_CONTENT_ERROR_PERMISSION_DENIED, \n
 400  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 401  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 402  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 403  *
 404  * @remarks The callback is called in a separate thread(not in the main loop).
 405  *
 406  * @param[in] error The error code
 407  * @param[in] path The path of the thumbnail which is generated
 408  * @param[in] user_data The user data passed from the foreach function
 409  *
 410  * @pre media_info_create_thumbnail()
 411  * @see media_info_create_thumbnail()
 412  */
 413 typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data);
 414
 415 /**
 416  * @ingroup CAPI_CONTENT_MEDIA_FACE_DETECTION_MODULE
 417  * @brief Called when face detection on the image is completed.
 418  *
 419  * @details The following error codes can be delivered. \n
 420  *         #MEDIA_CONTENT_ERROR_NONE, \n
 421  *         #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, \n
 422  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 423  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 424  *         #MEDIA_CONTENT_ERROR_DB_BUSY, \n
 425  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 426  *
 427  * @since_tizen 3.0
 428  *
 429  * @remarks The callback is called in a separate thread(not in the main loop).
 430  *
 431  * @param[in] error The error code
 432  * @param[in] face_count The number of all detected faces
 433  * @param[in] user_data The user data passed from the foreach function
 434  *
 435  * @pre media_info_start_face_detection()
 436  * @see media_info_start_face_detection()
 437  */
 438 typedef void (*media_face_detection_completed_cb)(media_content_error_e error, const int face_count, void *user_data);
 439
 440
 441 /**
 442  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 443  * @brief Called for every available media folder.
 444  * @details Iterates over a list of folders.
 445  *
 446  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 447  *
 448  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function. \n
 449  *                  The callback is called in the main loop.
 450  *
 451  * @param[in] folder The handle to the media folder
 452  * @param[in] user_data The user data passed from the foreach function
 453  *
 454  * @return @c true to continue with the next iteration of the loop,
 455  *         otherwise @c false to break out of the loop
 456  *
 457  * @pre media_folder_foreach_folder_from_db() will invoke this function.
 458  * @see media_folder_clone()
 459  * @see media_folder_foreach_folder_from_db()
 460  */
 461 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 462
 463 /**
 464  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 465  * @brief Called for every playlist in the obtained list of playlists.
 466  * @details Iterates over a playlist list.
 467  *
 468  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 469  *
 470  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function. \n
 471  *                  The callback is called in the main loop.
 472  *
 473  * @param[in] playlist The handle to the media playlist
 474  * @param[in] user_data The user data passed from the foreach function
 475  *
 476  * @return @c true to continue with the next iteration of the loop,
 477  *         otherwise @c false to break out of the loop
 478  *
 479  * @pre media_playlist_foreach_playlist_from_db() will invoke this function.
 480  *
 481  * @see media_playlist_clone()
 482  * @see media_playlist_foreach_playlist_from_db()
 483  */
 484 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 485
 486 /**
 487  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 488  * @brief Called for every media info with playlist member ID in the obtained list of media info.
 489  * @details Iterates over playlist members.
 490  *
 491  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 492  *
 493  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function. \n
 494  *                  The callback is called in the main loop.
 495  *
 496  * @param[in] playlist_member_id The ID of the playlist member
 497  * @param[in] media The handle to the media info
 498  * @param[in] user_data The user data passed from the foreach function
 499  *
 500  * @return @c true to continue with the next iteration of the loop,
 501  *         otherwise @c false to break out of the loop
 502  *
 503  * @pre media_playlist_foreach_media_from_db() will invoke this function.
 504  *
 505  * @see media_info_clone()
 506  * @see media_playlist_foreach_media_from_db()
 507  */
 508 typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
 509
 510 /**
 511  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 512  * @brief Called for every tag in the obtained list of tags.
 513  * @details Iterates over a list of tags.
 514  *
 515  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 516  *
 517  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function. \n
 518  *                  The callback is called in the main loop.
 519  *
 520  * @param[in] tag The handle to the media tag
 521  * @param[in] user_data The user data passed from the foreach function
 522  *
 523  * @return @c true to continue with the next iteration of the loop,
 524  *         otherwise @c false to break out of the loop
 525  *
 526  * @pre media_tag_foreach_tag_from_db(), media_info_foreach_tag_from_db() will invoke this function.
 527  *
 528  * @see media_tag_clone()
 529  * @see media_tag_foreach_tag_from_db()
 530  * @see media_info_foreach_tag_from_db()
 531  */
 532 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 533
 534 /**
 535  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 536  * @brief Called for every bookmark in the obtained list of bookmarks.
 537  * @details Iterates over a bookmark list.
 538  *
 539  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 540  *
 541  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function. \n
 542  *                  The callback is called in the main loop.
 543  *
 544  * @param[in] bookmark The handle to the media bookmark
 545  * @param[in] user_data The user data passed from the foreach function
 546  *
 547  * @return @c true to continue with the next iteration of the loop,
 548  *         otherwise @c false to break out of the loop
 549  *
 550  * @pre media_info_foreach_bookmark_from_db() will invoke this function.
 551  * @see media_info_foreach_bookmark_from_db()
 552  */
 553 typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
 554
 555 /**
 556  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 557  * @brief Called for every album in the obtained list of groups.
 558  * @details Iterates over an album list.
 559  *
 560  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 561  *
 562  * @remarks To use the @a album outside this function, copy the handle with the media_album_clone() function. \n
 563  *                  The callback is called in the main loop.
 564  *
 565  * @param[in] album The handle to the media album
 566  * @param[in] user_data The user data passed from the foreach function
 567  *
 568  * @return @c true to continue with the next iteration of the loop,
 569  *         otherwise @c false to break out of the loop
 570  *
 571  * @pre media_album_foreach_album_from_db() will invoke this function.
 572  *
 573  * @see media_album_clone()
 574  * @see media_album_foreach_album_from_db()
 575  */
 576 typedef bool (*media_album_cb)(media_album_h album, void *user_data);
 577
 578 /**
 579  * @ingroup CAPI_CONTENT_MEDIA_GROUP_MODULE
 580  * @brief Called for every group in the obtained list of groups.
 581  * @details Iterates over a media group list.
 582  *
 583  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 584  *
 585  * @remarks You should not free @a group_name returned by this function. \n
 586  *                  The callback is called in the main loop.
 587  *
 588  * @param[in] group_name The name of the media group
 589  * @param[in] user_data The user data passed from the foreach function
 590  *
 591  * @return @c true to continue with the next iteration of the loop,
 592  *         otherwise @c false to break out of the loop
 593  *
 594  * @pre media_group_foreach_group_from_db() will invoke this function.
 595  * @see media_group_foreach_group_from_db()
 596  */
 597 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 598
 599 /**
 600  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 601  * @deprecated Deprecated since 5.0.
 602  * @brief Called for every storage in the obtained list of storages.
 603  * @details Iterates over a media storage list.
 604  *
 605  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 606  *
 607  * @remarks You should not destroy @a storage returned by this function. \n
 608  *                  The callback is called in the main loop.
 609  *
 610  * @param[in] storage The handle of the media storage
 611  * @param[in] user_data The user data passed from the foreach function
 612  *
 613  * @return @c true to continue with the next iteration of the loop,
 614  *         otherwise @c false to break out of the loop
 615  *
 616  * @pre media_storage_foreach_storage_from_db() will invoke this function.
 617  * @see media_storage_foreach_storage_from_db()
 618  */
 619 typedef bool (*media_storage_cb)(media_storage_h storage, void *user_data);
 620
 621 /**
 622  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 623  * @brief Called for every face in the obtained list of face.
 624  * @details Iterates over a media face list.
 625  *
 626  * @since_tizen 3.0
 627  *
 628  * @remarks You should not destroy @a face returned by this function. \n
 629  *                  The callback is called in the main loop.
 630  *
 631  * @param[in] face The handle of the media face
 632  * @param[in] user_data The user data passed from the foreach function
 633  *
 634  * @return @c true to continue with the next iteration of the loop,
 635  *         otherwise @c false to break out of the loop
 636  *
 637  * @pre media_info_foreach_face_from_db() will invoke this function.
 638  * @see media_info_foreach_face_from_db()
 639  */
 640 typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 641
 642 /**
 643  * @}
 644  */
 645
 646 /**
 647  * @addtogroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 648  * @{
 649  */
 650
 651  /**
 652  * @brief Media ID.
 653  * @details You can use above define to set the condition of media filter and order keyword.
 654  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 655  *
 656  */
 657 #define MEDIA_ID "MEDIA_ID"
 658
 659 /**
 660  * @brief Media full path.
 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_PATH "MEDIA_PATH"
 666
 667 /**
 668  * @brief The file name including the extension.
 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_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
 674
 675 /**
 676  * @brief Media type.
 677  * @details There are 5 media types:\n
 678  *               0-image, 1-video, 2-sound, 3-music, 4-other\n
 679  *               You can use above define to set the condition of media filter and order keyword.
 680  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 681  *
 682  */
 683 #define MEDIA_TYPE "MEDIA_TYPE"
 684
 685 /**
 686  * @brief Media MIME type.
 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_MIME_TYPE "MEDIA_MIME_TYPE"
 692
 693
 694 /**
 695  * @brief Media file size.
 696  * @details You can use above define to set the condition of media filter and order keyword.
 697  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 698  *
 699  */
 700 #define MEDIA_SIZE "MEDIA_SIZE"
 701
 702 /**
 703  * @brief The time that content file was first added to media database.
 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_ADDED_TIME "MEDIA_ADDED_TIME"
 709
 710 /**
 711  * @brief The last modification time provided by the file system.
 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_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
 717
 718 /**
 719  * @brief  Media created time.
 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_TIMELINE "MEDIA_TIMELINE"
 725
 726 /**
 727  * @brief Media thumbnail path.
 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_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
 733
 734 /**
 735  * @brief Media title get from tag or file name.
 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_TITLE "MEDIA_TITLE"
 741
 742 /**
 743  * @brief Media album 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_ALBUM "MEDIA_ALBUM"
 749
 750 /**
 751  * @brief Media artist.
 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_ARTIST "MEDIA_ARTIST"
 757
 758 /**
 759  * @brief Media album 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_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
 765
 766 /**
 767  * @brief Media genre.
 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_GENRE "MEDIA_GENRE"
 773
 774 /**
 775  * @brief Media composer.
 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_COMPOSER "MEDIA_COMPOSER"
 781
 782 /**
 783  * @brief Media year.
 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_YEAR "MEDIA_YEAR"
 789
 790 /**
 791  * @brief Media recorded date.
 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_RECORDED_DATE "MEDIA_RECORDED_DATE"
 797
 798 /**
 799  * @deprecated Deprecated since 5.5.
 800  * @brief Media copyright.
 801  * @details You can use above define to set the condition of media filter and order keyword.
 802  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 803  *
 804  */
 805 #define MEDIA_COPYRIGHT "MEDIA_COPYRIGHT"
 806
 807 /**
 808  * @brief Media track number.
 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_TRACK_NUM "MEDIA_TRACK_NUM"
 814
 815 /**
 816  * @deprecated Deprecated since 5.5.
 817  * @brief Media description.
 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_DESCRIPTION "MEDIA_DESCRIPTION"
 823
 824 /**
 825  * @deprecated Deprecated since 5.5.
 826  * @brief Media bitrate.
 827  * @details You can use above define to set the condition of media filter and order keyword.
 828  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 829  *
 830  */
 831 #define MEDIA_BITRATE "MEDIA_BITRATE"
 832
 833 /**
 834  * @deprecated Deprecated since 5.5.
 835  * @brief Media bit per sample.
 836  * @details You can use above define to set the condition of media filter and order keyword.
 837  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 838  *
 839  */
 840 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"
 841
 842 /**
 843  * @deprecated Deprecated since 5.5.
 844  * @brief Media sample rate.
 845  * @details You can use above define to set the condition of media filter and order keyword.
 846  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 847  *
 848  */
 849 #define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"
 850
 851 /**
 852  * @deprecated Deprecated since 5.5.
 853  * @brief Media channel.
 854  * @details You can use above define to set the condition of media filter and order keyword.
 855  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 856  *
 857  */
 858 #define MEDIA_CHANNEL "MEDIA_CHANNEL"
 859
 860 /**
 861  * @brief Media duration.
 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_DURATION "MEDIA_DURATION"
 867
 868 /**
 869  * @brief Media longitude.
 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_LONGITUDE "MEDIA_LONGITUDE"
 875
 876 /**
 877  * @brief Media latitude.
 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_LATITUDE "MEDIA_LATITUDE"
 883
 884 /**
 885  * @brief Media altitude.
 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_ALTITUDE "MEDIA_ALTITUDE"
 891
 892 /**
 893  * @brief Media width.
 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_WIDTH "MEDIA_WIDTH"
 899
 900 /**
 901  * @brief Media height.
 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_HEIGHT "MEDIA_HEIGHT"
 907
 908 /**
 909  * @brief Media datetaken.
 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_DATETAKEN "MEDIA_DATETAKEN"
 915
 916 /**
 917  * @deprecated Deprecated since 5.5.
 918  * @brief Media orientation.
 919  * @details You can use above define to set the condition of media filter and order keyword.
 920  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 921  *
 922  */
 923 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 924
 925 /**
 926  * @deprecated Deprecated since 5.5.
 927  * @brief Media rating.
 928  * @details You can use above define to set the condition of media filter and order keyword.
 929  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 930  *
 931  */
 932 #define MEDIA_RATING "MEDIA_RATING"
 933
 934 /**
 935  * @brief The time to register favourite.
 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_FAVOURITE "MEDIA_FAVOURITE"
 941
 942 /**
 943  * @brief Is DRM.
 944  * @details There are 2 types:\n
 945  *               0-not drm, 1-drm\n
 946  *               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_IS_DRM "MEDIA_IS_DRM"
 951
 952 /**
 953  * @deprecated Deprecated since 5.0.
 954  * @brief Media storage.
 955  * @details There are 3 types:\n
 956  *               0-internal storage, 1-SD card, 2-USB storage\n
 957  *               You can use above define to set the condition of media filter and order keyword.
 958  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 959  *
 960  */
 961 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
 962
 963 /**
 964  * @deprecated Deprecated since 5.5.
 965  * @brief Media exposure time.
 966  * @details You can use above define to set the condition of media filter and order keyword.
 967  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 968  *
 969  */
 970 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
 971
 972 /**
 973  * @deprecated Deprecated since 5.5.
 974  * @brief Media fnumber.
 975  * @details You can use above define to set the condition of media filter and order keyword.
 976  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 977  *
 978  */
 979 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
 980
 981 /**
 982  * @deprecated Deprecated since 5.5.
 983  * @brief Media ISO.
 984  * @details You can use above define to set the condition of media filter and order keyword.
 985  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 986  *
 987  */
 988 #define MEDIA_ISO "MEDIA_ISO"
 989
 990 /**
 991  * @deprecated Deprecated since 5.5.
 992  * @brief Media model.
 993  * @details You can use above define to set the condition of media filter and order keyword.
 994  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 995  *
 996  */
 997 #define MEDIA_MODEL "MEDIA_MODEL"
 998
 999 /**
1000  * @brief Media file name pinyin.
1001  * @details You can use above define to set the condition of media filter and order keyword.
1002  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1003  * @remarks Since 4.0, this keyword is related to the following feature:\n
1004  *          - %http://tizen.org/feature/content.filter.pinyin\n
1005  *             If this feature is not supported on the device, PINYIN search does not work.
1006  *
1007  */
1008 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
1009
1010 /**
1011  * @brief Media title pinyin.
1012  * @details You can use above define to set the condition of media filter and order keyword.
1013  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1014  * @remarks Since 4.0, this keyword is related to the following feature:\n
1015  *          - %http://tizen.org/feature/content.filter.pinyin\n
1016  *             If this feature is not supported on the device, PINYIN search does not work.
1017  *
1018  */
1019 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
1020
1021 /**
1022  * @brief Media album pinyin.
1023  * @details You can use above define to set the condition of media filter and order keyword.
1024  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1025  * @remarks Since 4.0, this keyword is related to the following feature:\n
1026  *          - %http://tizen.org/feature/content.filter.pinyin\n
1027  *            If this feature is not supported on the device, PINYIN search does not work.
1028  *
1029  */
1030 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
1031
1032 /**
1033  * @brief Media artist pinyin.
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  * @remarks Since 4.0, this keyword is related to the following feature:\n
1037  *          - %http://tizen.org/feature/content.filter.pinyin\n
1038  *             If this feature is not supported on the device, PINYIN search does not work.
1039  *
1040  */
1041 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
1042
1043 /**
1044  * @brief Media album artist pinyin.
1045  * @details You can use above define to set the condition of media filter and order keyword.
1046  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1047  * @remarks Since 4.0, this keyword is related to the following feature:\n
1048  *          - %http://tizen.org/feature/content.filter.pinyin\n
1049  *            If this feature is not supported on the device, PINYIN search does not work.
1050  *
1051  */
1052 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
1053
1054 /**
1055  * @brief Media genre pinyin.
1056  * @details You can use above define to set the condition of media filter and order keyword.
1057  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1058  * @remarks Since 4.0, this keyword is related to the following feature:\n
1059  *          - %http://tizen.org/feature/content.filter.pinyin\n
1060  *            If this feature is not supported on the device, PINYIN search does not work.
1061  *
1062  */
1063 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
1064
1065 /**
1066  * @brief Media composer pinyin.
1067  * @details You can use above define to set the condition of media filter and order keyword.
1068  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1069  * @remarks Since 4.0, this keyword is related to the following feature:\n
1070  *          - %http://tizen.org/feature/content.filter.pinyin\n
1071  *            If this feature is not supported on the device, PINYIN search does not work.
1072  *
1073  */
1074 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
1075
1076 /**
1077  * @deprecated Deprecated since 5.5.
1078  * @brief Media copyright pinyin.
1079  * @details You can use above define to set the condition of media filter and order keyword.
1080  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1081  * @remarks Since 4.0, this keyword is related to the following feature:\n
1082  *          - %http://tizen.org/feature/content.filter.pinyin\n
1083  *            If this feature is not supported on the device, PINYIN search does not work.
1084  *
1085  */
1086 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
1087
1088 /**
1089  * @deprecated Deprecated since 5.5.
1090  * @brief Media description pinyin.
1091  * @details You can use above define to set the condition of media filter and order keyword.
1092  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1093  * @remarks Since 4.0, this keyword is related to the following feature:\n
1094  *          - %http://tizen.org/feature/content.filter.pinyin\n
1095  *            If this feature is not supported on the device, PINYIN search does not work.
1096  *
1097  */
1098 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
1099
1100 /**
1101  * @brief Virtual Reality content.
1102  * @details You can use above define to set the condition of media filter and order keyword.
1103  * @since_tizen 3.0
1104  *
1105  */
1106 #define MEDIA_360 "MEDIA_360"
1107
1108  /**
1109  * @brief Folder ID.
1110  * @details You can use above define to set the condition of folder filter and order keyword.
1111  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1112  */
1113 #define FOLDER_ID "FOLDER_ID"
1114
1115 /**
1116  * @brief Folder full path.
1117  * @details You can use above define to set the condition of folder filter and order keyword.
1118  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1119  */
1120 #define FOLDER_PATH "FOLDER_PATH"
1121
1122 /**
1123  * @brief Folder base name.
1124  * @details You can use above define to set the condition of folder filter and order keyword.
1125  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1126  */
1127 #define FOLDER_NAME "FOLDER_NAME"
1128
1129 /**
1130  * @deprecated Deprecated since 5.0.
1131  * @brief Folder storage.
1132  * @details There are 2 types:\n
1133  *               0-internal storage, 1-external storage\n
1134  *               You can use above define to set the condition of folder filter and order keyword.
1135  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1136  */
1137 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"
1138
1139 /**
1140  * @brief Folder base name pinyin.
1141  * @details You can use above define to set the condition of folder 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 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
1148
1149 /**
1150  * @brief Playlist name.
1151  * @details You can use above define to set the condition of playlist filter and order keyword.
1152  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1153  */
1154 #define PLAYLIST_NAME "PLAYLIST_NAME"
1155
1156 /**
1157  * @brief Playlist id.
1158  * @details You can use above define to set the condition of playlist filter and order keyword.
1159  * @since_tizen 4.0
1160  */
1161 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
1162
1163 /**
1164  * @brief Playlist member order.
1165  * @details You can use above define to set the condition of playlist filter and order keyword.
1166  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1167  */
1168 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
1169
1170 /**
1171  * @brief Media count in playlist.
1172  * @details You can use above define to set the condition of playlist filter and order keyword.
1173  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1174  */
1175 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
1176
1177 /**
1178  * @brief Tag name.
1179  * @details You can use above define to set the condition of tag filter and order keyword.
1180  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1181  */
1182 #define TAG_NAME "TAG_NAME"
1183
1184 /**
1185  * @brief Tag id.
1186  * @details You can use above define to set the condition of tag filter and order keyword.
1187  * @since_tizen 4.0
1188  */
1189 #define MEDIA_TAG_ID "TAG_ID"
1190
1191 /**
1192  * @brief Media count in tag.
1193  * @details You can use above define to set the condition of tag filter and order keyword.
1194  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1195  */
1196 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
1197
1198 /**
1199  * @brief Bookmark marked time.
1200  * @details You can use above define to set the condition of bookmark filter and order keyword.
1201  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1202  */
1203 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
1204
1205 /**
1206  * @brief Bookmark id.
1207  * @details You can use above define to set the condition of bookmark filter and order keyword.
1208  * @since_tizen 4.0
1209  */
1210 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
1211
1212 /**
1213  * @brief Bookmark name.
1214  * @details You can use above define to set the condition of bookmark filter and order keyword.
1215  * @since_tizen 4.0
1216  */
1217 #define BOOKMARK_NAME "BOOKMARK_NAME"
1218
1219 /**
1220  * @deprecated Deprecated since 5.0.
1221  * @brief Storage ID.
1222  * @details You can use above define to set the condition of storage filter and order keyword.
1223  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1224  */
1225 #define MEDIA_STORAGE_ID                                        "STORAGE_ID"
1226
1227 /**
1228  * @deprecated Deprecated since 5.0.
1229  * @brief Storage path.
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_PATH                              "STORAGE_PATH"
1234
1235 /**
1236  * @brief Face tag.
1237  * @details You can use above define to set the condition of face filter and order keyword.
1238  * @since_tizen 3.0
1239  */
1240 #define MEDIA_FACE_TAG  "MEDIA_FACE_TAG"
1241
1242 /**
1243  * @brief Face id.
1244  * @details You can use above define to set the condition of face filter and order keyword.
1245  * @since_tizen 4.0
1246  */
1247 #define MEDIA_FACE_ID   "MEDIA_FACE_ID"
1248
1249 /**
1250  * @}
1251  */
1252
1253
1254 #ifdef __cplusplus
1255 }
1256 #endif /* __cplusplus */
1257
1258
1259 #endif /*__TIZEN_CONTENT_MEDIA_CONTENT_TYPE_H__*/