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