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