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_MEDIA_CONTENT_TYPE_H__
  19 #define __TIZEN_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 #if 0
  29 #ifndef _USE_SENIOR_MODE
  30 #define _USE_SENIOR_MODE
  31 #endif
  32 #endif
  33
  34 /**
  35  * @file media_content_type.h
  36  * @brief This file contains API related to media-content enumerations for media data types, groups, orientations, \n
  37  *        classes of errors and definitions of media-data. \n
  38  *        Listed APIs are called when iterating over lists of album, group, bookmark and other media,  \n
  39  *        when media items and burst shot are inserted completely and when notification of media DB change is subscribed.
  40  */
  41
  42 /**
  43 * @addtogroup CAPI_MEDIA_CONTENT_MODULE
  44  * @{
  45  */
  46
  47 /**
  48  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  49  * @brief Enumeration for the media file format.
  50  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  51  */
  52 typedef enum {
  53         MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
  54         MEDIA_CONTENT_TYPE_VIDEO                = 1,    /**<The type of a video */
  55         MEDIA_CONTENT_TYPE_SOUND        = 2,    /**<The type of sound */
  56         MEDIA_CONTENT_TYPE_MUSIC                = 3,    /**<The type of music */
  57         MEDIA_CONTENT_TYPE_OTHERS       = 4,    /**<The type of other */
  58         MEDIA_CONTENT_TYPE_PVR                  = 5,            /**<The type of PVR */
  59         MEDIA_CONTENT_TYPE_UHD                  = 6,            /**<The type of UHD */
  60         MEDIA_CONTENT_TYPE_SCSA                 = 7,            /**<The type of SCSA */
  61 } media_content_type_e;
  62
  63 /**
  64  * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
  65  * @brief Enumeration for the storage type.
  66  * @details This information is used to establish where the folder is.
  67  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  68  */
  69 typedef enum {
  70         MEDIA_CONTENT_STORAGE_INTERNAL  = 0,    /**< The device's internal storage */
  71         MEDIA_CONTENT_STORAGE_EXTERNAL  = 1,    /**< The device's external storage like sd card*/
  72         MEDIA_CONTENT_STORAGE_EXTERNAL_USB = 2, /**< The external USB storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
  73         MEDIA_CONTENT_STORAGE_CLOUD     = 100,  /**< The Cloud storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif, Deprecated since 4.0) */
  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_content_db_update_item_type_e;
  85
  86 /**
  87  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  88  * @brief Enumeration for media content DB update types.
  89  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  90  */
  91 typedef enum {
  92         MEDIA_CONTENT_INSERT            = 0,            /**< Insert, the type of DB update */
  93         MEDIA_CONTENT_DELETE            = 1,            /**< Delete, The type of DB update */
  94         MEDIA_CONTENT_UPDATE    = 2,            /**< Update, The type of DB update */
  95 } media_content_db_update_type_e;
  96
  97 /**
  98  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  99  * @brief Enumeration for orientation types.
 100  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 101  */
 102 typedef enum {
 103         MEDIA_CONTENT_ORIENTATION_NOT_AVAILABLE  = 0,       /**< Not available*/
 104         MEDIA_CONTENT_ORIENTATION_NORMAL         = 1,       /**< Normal*/
 105         MEDIA_CONTENT_ORIENTATION_HFLIP          = 2,       /**< Flip horizontal*/
 106         MEDIA_CONTENT_ORIENTATION_ROT_180        = 3,       /**< Rotate 180 degrees*/
 107         MEDIA_CONTENT_ORIENTATION_VFLIP          = 4,       /**< Flip vertical*/
 108         MEDIA_CONTENT_ORIENTATION_TRANSPOSE      = 5,       /**< Transpose*/
 109         MEDIA_CONTENT_ORIENTATION_ROT_90         = 6,       /**< Rotate 90 degrees*/
 110         MEDIA_CONTENT_ORIENTATION_TRANSVERSE     = 7,       /**< Transverse*/
 111         MEDIA_CONTENT_ORIENTATION_ROT_270        = 8,       /**< Rotate 270 degrees*/
 112 } media_content_orientation_e;
 113
 114 /**
 115  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 116  * @brief Enumeration for ordering.
 117  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 118  */
 119 typedef enum {
 120         MEDIA_CONTENT_ORDER_ASC   = 0,      /**< Ascending order*/
 121         MEDIA_CONTENT_ORDER_DESC  = 1,      /**< Descending order*/
 122         MEDIA_CONTENT_ORDER_OTHER = 2,          /** order by order key**/
 123 } media_content_order_e;
 124
 125 /**
 126  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 127  * @brief Enumeration for collations.
 128  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 129  */
 130 typedef enum {
 131         MEDIA_CONTENT_COLLATE_DEFAULT   = 0,        /**< Default collation BINARY */
 132         MEDIA_CONTENT_COLLATE_NOCASE    = 1,        /**< Collation NOCASE, not case sensitive */
 133         MEDIA_CONTENT_COLLATE_RTRIM     = 2,        /**< Collation RTRIM, trailing space characters are ignored */
 134         MEDIA_CONTENT_COLLATE_LOCALIZED = 3,        /**< Collation LOCALIZATION, NOCASE also applied */
 135 } media_content_collation_e;
 136
 137 #define MEDIA_CONTENT_ERROR_CLASS                               TIZEN_ERROR_MEDIA_CONTENT
 138
 139 /**
 140  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 141  * @brief Enumeration for a media content error.
 142  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 143  */
 144 typedef enum {
 145         MEDIA_CONTENT_ERROR_NONE                    = TIZEN_ERROR_NONE,                    /**< Successful */
 146         MEDIA_CONTENT_ERROR_INVALID_PARAMETER       = TIZEN_ERROR_INVALID_PARAMETER,       /**< Invalid parameter */
 147         MEDIA_CONTENT_ERROR_OUT_OF_MEMORY           = TIZEN_ERROR_OUT_OF_MEMORY,           /**< Out of memory */
 148         MEDIA_CONTENT_ERROR_INVALID_OPERATION       = TIZEN_ERROR_INVALID_OPERATION,       /**< Invalid Operation */
 149         MEDIA_CONTENT_FILE_NO_SPACE_ON_DEVICE       = TIZEN_ERROR_FILE_NO_SPACE_ON_DEVICE, /**< No space left on device */
 150         MEDIA_CONTENT_ERROR_PERMISSION_DENIED             = TIZEN_ERROR_PERMISSION_DENIED,                /**< Permission denied */
 151         MEDIA_CONTENT_ERROR_DB_FAILED               = MEDIA_CONTENT_ERROR_CLASS | 0x01,    /**< DB operation failed */
 152         MEDIA_CONTENT_ERROR_DB_BUSY                 = MEDIA_CONTENT_ERROR_CLASS | 0x02,    /**< DB operation BUSY */
 153         MEDIA_CONTENT_ERROR_NETWORK                 = MEDIA_CONTENT_ERROR_CLASS | 0x03,    /**< Network Fail */
 154         MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT     = MEDIA_CONTENT_ERROR_CLASS | 0x04,    /**< Unsupported Content */
 155         MEDIA_CONTENT_ERROR_NOT_SUPPORTED           = TIZEN_ERROR_NOT_SUPPORTED,           /**< Not supported */
 156 } media_content_error_e;
 157
 158 /**
 159  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 160  * @brief Enumeration for a media group.
 161  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 162  */
 163 typedef enum {
 164         MEDIA_CONTENT_GROUP_DISPLAY_NAME = 0,    /**< Media group ID for display name */
 165         MEDIA_CONTENT_GROUP_TYPE,                /**< Media group ID for a media type */
 166         MEDIA_CONTENT_GROUP_MIME_TYPE,           /**< Media group ID for a mime type */
 167         MEDIA_CONTENT_GROUP_SIZE,                /**< Media group ID for content size */
 168         MEDIA_CONTENT_GROUP_ADDED_TIME,          /**< Media group ID for the added time */
 169         MEDIA_CONTENT_GROUP_MODIFIED_TIME,       /**< Media group ID for the modified time */
 170         MEDIA_CONTENT_GROUP_TITLE,               /**< Media group ID for a content title */
 171         MEDIA_CONTENT_GROUP_ARTIST,              /**< Media group ID for an artist*/
 172         MEDIA_CONTENT_GROUP_ALBUM_ARTIST,        /**< Media group ID for an album artist */
 173         MEDIA_CONTENT_GROUP_GENRE,               /**< Media group ID for a genre*/
 174         MEDIA_CONTENT_GROUP_COMPOSER,            /**< Media group ID for a composer*/
 175         MEDIA_CONTENT_GROUP_YEAR,                /**< Media group ID for a year*/
 176         MEDIA_CONTENT_GROUP_RECORDED_DATE,       /**< Media group ID for the recorded date*/
 177         MEDIA_CONTENT_GROUP_COPYRIGHT,           /**< Media group ID for the copyright*/
 178         MEDIA_CONTENT_GROUP_TRACK_NUM,           /**< Media group ID for a track number*/
 179         MEDIA_CONTENT_GROUP_DESCRIPTION,         /**< Media group ID for a description */
 180         MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
 181         MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
 182         MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
 183         MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot (Deprecated since 4.0)*/
 184         MEDIA_CONTENT_GROUP_RATING,              /**< Media group ID for a rating*/
 185         MEDIA_CONTENT_GROUP_AUTHOR,              /**< Media group ID for an author (Deprecated since 4.0)*/
 186         MEDIA_CONTENT_GROUP_PROVIDER,            /**< Media group ID for a provider (Deprecated since 4.0)*/
 187         MEDIA_CONTENT_GROUP_CONTENT_NAME,        /**< Media group ID for the content name (Deprecated since 4.0)*/
 188         MEDIA_CONTENT_GROUP_CATEGORY,            /**< Media group ID for a category (Deprecated since 4.0)*/
 189         MEDIA_CONTENT_GROUP_LOCATION_TAG,        /**< Media group ID for a location tag (Deprecated since 4.0)*/
 190         MEDIA_CONTENT_GROUP_AGE_RATING,          /**< Media group ID for an age rating (Deprecated since 4.0)*/
 191         MEDIA_CONTENT_GROUP_KEYWORD,             /**< Media group ID for a keyword (Deprecated since 4.0)*/
 192         MEDIA_CONTENT_GROUP_WEATHER,             /**< Media group ID for the weather (Deprecated since 4.0)*/
 193         MEDIA_CONTENT_GROUP_MODIFIED_MONTH,              /**< Media group ID for the modified time*/
 194         MEDIA_CONTENT_GROUP_MODIFIED_DATE,               /**< Media group ID for the modified date*/
 195 #ifdef _USE_SENIOR_MODE
 196         MEDIA_CONTENT_GROUP_CONTACT,
 197 #endif
 198         MEDIA_CONTENT_GROUP_ALBUM,
 199         MEDIA_CONTENT_GROUP_MAX,                /**< Invalid media group ID*/
 200         MEDIA_PVR_GROUP_DURATION,
 201         MEDIA_PVR_GROUP_TIME_ZONE,
 202         MEDIA_PVR_GROUP_PTC,
 203         MEDIA_PVR_GROUP_MAJOR,
 204         MEDIA_PVR_GROUP_MINOR,
 205         MEDIA_PVR_GROUP_CHANNEL_TYPE,
 206         MEDIA_PVR_GROUP_CHANNEL_NAME,
 207         MEDIA_PVR_GROUP_CHANNEL_NUM,
 208         MEDIA_PVR_GROUP_PROGRAM_TITLE,
 209         MEDIA_PVR_GROUP_PROGRAM_NUM,
 210         MEDIA_PVR_GROUP_PROGRAM_CRID,
 211         MEDIA_PVR_GROUP_GUIDANCE,
 212         MEDIA_PVR_GROUP_SYNOPSIS,
 213         MEDIA_PVR_GROUP_GENRE,
 214         MEDIA_PVR_GROUP_LANGUAGE,
 215         MEDIA_PVR_GROUP_EMBARGO_TIME,
 216         MEDIA_PVR_GROUP_EXPIRY_TIME,
 217         MEDIA_PVR_GROUP_START_TIME,
 218         MEDIA_PVR_GROUP_PROGRAM_START_TIME,
 219         MEDIA_PVR_GROUP_PROGRAM_END_TIME,
 220         MEDIA_PVR_GROUP_PROGRAM_DATE,
 221         MEDIA_PVR_GROUP_PARENTAL_RATING,
 222         MEDIA_PVR_GROUP_TIMER_RECORD,
 223         MEDIA_PVR_GROUP_SERIES_RECORD,
 224         MEDIA_PVR_GROUP_HD,
 225         MEDIA_PVR_GROUP_SUBTITLE,
 226         MEDIA_PVR_GROUP_TTX,
 227         MEDIA_PVR_GROUP_AD,
 228         MEDIA_PVR_GROUP_HARDOF_HEARINGRADIO,
 229         MEDIA_PVR_GROUP_DATA_SERVICE,
 230         MEDIA_PVR_GROUP_CONTENT_LOCK,
 231         MEDIA_PVR_GROUP_CONTENT_WATCH,
 232         MEDIA_PVR_GROUP_HAS_AUDIO_ONLY,
 233         MEDIA_PVR_GROUP_IS_LOCAL_RECORDED,
 234         MEDIA_PVR_GROUP_RESOLUTION,
 235         MEDIA_PVR_GROUP_ASPECTRATIO,
 236         MEDIA_PVR_GROUP_MODIFIED_MONTH,
 237         MEDIA_PVR_GROUP_MODIFIED_DATE,
 238         MEDIA_PVR_GROUP_SPORTS_TYPE,
 239         MEDIA_PVR_GROUP_GUIDANCE_LENGTH,
 240         MEDIA_PVR_GROUP_TVMODE,
 241         MEDIA_PVR_GROUP_PLAY_COUNT,
 242         MEDIA_PVR_GROUP_PRIVATE_DATA,
 243         MEDIA_PVR_GROUP_MAX,
 244         MEDIA_UHD_GROUP_CONTENT_TITLE,
 245         MEDIA_UHD_GROUP_RELEASE_DATE,
 246         MEDIA_UHD_GROUP_SUB_TYPE,
 247         MEDIA_UHD_GROUP_FILE_NAME,
 248         MEDIA_UHD_GROUP_PLAYED_COUNT,
 249         MEDIA_UHD_GROUP_MAX,
 250         MEDIA_GROUP_MAX,
 251 } media_group_e;
 252
 253 /**
 254  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 255  * @brief The structure type for the Media info handle.
 256  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 257  */
 258 typedef struct media_info_s *media_info_h;
 259
 260 /**
 261  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 262  * @brief The structure type for the Media folder handle.
 263  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 264  */
 265 typedef struct media_folder_s *media_folder_h;
 266
 267 /**
 268  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 269  * @brief The structure type for the Media playlist handle.
 270  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 271  */
 272 typedef struct media_playlist_s *media_playlist_h;
 273
 274 /**
 275  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 276  * @brief The structure type for the Media tag handle.
 277  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 278  */
 279 typedef struct media_tag_s *media_tag_h;
 280
 281 /**
 282  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 283  * @brief The structure type for the Media bookmark handle.
 284  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 285  */
 286 typedef struct media_bookmark_s *media_bookmark_h;
 287
 288 /**
 289  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 290  * @brief The structure type for the Media album handle.
 291  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 292  */
 293 typedef struct media_album_s *media_album_h;
 294
 295 /**
 296  * @ingroup CAPI_CONTENT_MEDIA_IMAGE_MODULE
 297  * @brief The structure type for the Image metadata handle.
 298  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 299  */
 300 typedef struct image_meta_s *image_meta_h;
 301
 302 /**
 303  * @ingroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE
 304  * @brief The structure type for the Video metadata handle.
 305  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 306  */
 307 typedef struct video_meta_s *video_meta_h;
 308
 309 /**
 310  * @ingroup CAPI_CONTENT_MEDIA_AUDIO_META_MODULE
 311  * @brief The structure type for the Audio metadata handle.
 312  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 313  */
 314 typedef struct audio_meta_s *audio_meta_h;
 315
 316 /**
 317  * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 318  * @brief The structure type for the Media filter handle.
 319  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 320  */
 321 typedef struct filter_s *filter_h;
 322
 323 /**
 324  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 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_CONTENT_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  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 348  * @remarks The callback is called in a separate thread(not in the main loop).
 349  *
 350  * @param[in] error     The error code
 351  * @param[in] user_data The user data passed from the foreach function
 352  *
 353  * @pre media_content_scan().
 354  *
 355  * @see media_content_scan()
 356  *
 357  */
 358 typedef void (*media_scan_completed_cb)(media_content_error_e error, void * user_data);
 359
 360 /**
 361  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 362  * @brief Called when the notification of the media DB change is subscribed.
 363  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 364  *
 365  * @remarks The callback is called in a separate thread(not in the main loop).
 366  *
 367  * @param[in] error       The error code
 368  * @param[in] pid         The PID which publishes notification
 369  * @param[in] update_item The update item of notification
 370  * @param[in] update_type The update type of notification
 371  * @param[in] media_type  The type of the media content (#media_content_type_e)
 372  * @param[in] uuid        The UUID of media or directory, which is updated
 373  * @param[in] path        The path of the media or directory
 374  * @param[in] mime_type   The mime type of the media info
 375  * @param[in] user_data   The user data passed from the foreach function
 376  *
 377  * @pre media_content_db_update_subscribe().
 378  * @see media_content_db_update_subscribe()
 379  */
 380 typedef void (*media_content_db_update_cb)(
 381                                 media_content_error_e error,
 382                                 int pid,
 383                                 media_content_db_update_item_type_e update_item,
 384                                 media_content_db_update_type_e update_type,
 385                                 media_content_type_e media_type,
 386                                 char *uuid,
 387                                 char *path,
 388                                 char *mime_type,
 389                                 void *user_data);
 390
 391
 392 /**
 393  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 394  * @brief Called for every available media info.
 395  * @details Iterates over a list of media info.
 396  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 397  *
 398  * @remarks To use the @a media outside this function, copy the handle with media_info_clone() function. \n
 399  *                  The callback is called in the main loop.
 400  *
 401  * @param[in] media     The handle to the media info
 402  * @param[in] user_data The user data passed from the foreach function
 403  *
 404  * @return @c true to continue with the next iteration of the loop,
 405  *         otherwise @c false to break out of the loop
 406  *
 407  * @pre media_tag_foreach_media_from_db(), media_playlist_foreach_media_from_db(), media_genre_foreach_media_from_db(),
 408  *      media_info_foreach_media_from_db(), media_folder_foreach_media_from_db() will invoke this function.
 409  *
 410  * @see media_info_clone()
 411  * @see media_album_foreach_media_from_db()
 412  * @see media_playlist_foreach_media_from_db()
 413  * @see media_tag_foreach_media_from_db()
 414  * @see media_info_foreach_media_from_db()
 415  * @see media_folder_foreach_media_from_db()
 416  */
 417 typedef bool (*media_info_cb)(media_info_h media, void *user_data);
 418
 419
 420 /**
 421  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 422  * @brief Called when media items are inserted completely.
 423  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 424  *
 425  * @remarks The callback is called in a separate thread(not in the main loop).
 426  *
 427  * @param[in] media     The handle to the media info
 428  * @param[in] user_data The user data passed from the foreach function
 429  *
 430  * @pre media_info_insert_batch_to_db()
 431  *
 432  * @see media_info_insert_batch_to_db()
 433  */
 434 typedef void (*media_insert_completed_cb)(media_content_error_e error, void * user_data);
 435
 436
 437 /**
 438  * @deprecated Deprecated since 4.0.
 439  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 440  * @brief Called when the burst shot is inserted completely.
 441  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 442  *
 443  * @remarks The callback is called in a separate thread(not in the main loop).
 444  *
 445  * @param[in] media     The handle to the media info
 446  * @param[in] user_data The user data passed from the foreach function
 447  *
 448  * @pre media_info_insert_burst_shot_to_db()
 449  *
 450  * @see media_info_insert_burst_shot_to_db()
 451  *
 452  */
 453 typedef void (*media_insert_burst_shot_completed_cb)(media_content_error_e error, void * user_data);
 454
 455
 456 /**
 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  *
 477  * @see media_info_create_thumbnail()
 478  */
 479 typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data);
 480
 481 /**
 482  * @ingroup CAPI_CONTENT_MEDIA_FACE_DETECTION_MODULE
 483  * @brief Called when face detection on the image is completed.
 484  *
 485  * @details The following error codes can be delivered. \n
 486  *         #MEDIA_CONTENT_ERROR_NONE, \n
 487  *         #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, \n
 488  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 489  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 490  *         #MEDIA_CONTENT_ERROR_DB_BUSY, \n
 491  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 492  *
 493  * @since_tizen 3.0
 494  *
 495  * @remarks The callback is called in a separate thread(not in the main loop).
 496  *
 497  * @param[in] error     The error code
 498  * @param[in] face_count      The number of all detected faces
 499  * @param[in] user_data The user data passed from the foreach function
 500  *
 501  * @pre media_info_start_face_detection()
 502  *
 503  * @see media_info_start_face_detection()
 504  */
 505 typedef void (*media_face_detection_completed_cb)(media_content_error_e error, const int face_count, void *user_data);
 506
 507
 508 /**
 509  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 510  * @brief Called for every available media folder.
 511  * @details Iterates over a list of folders.
 512  *
 513  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 514  *
 515  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function. \n
 516  *                  The callback is called in the main loop.
 517  *
 518  * @param[in] folder    The handle to the media folder
 519  * @param[in] user_data The user data passed from the foreach function
 520  *
 521  * @return @c true to continue with the next iteration of the loop,
 522  *         otherwise @c false to break out of the loop
 523  *
 524  * @pre media_folder_foreach_folder_from_db() will invoke this function.
 525  * @see media_folder_clone()
 526  * @see media_folder_foreach_folder_from_db()
 527  */
 528 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 529
 530 /**
 531  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 532  * @brief Called for every playlist in the obtained list of playlists.
 533  * @details Iterates over a playlist list.
 534  *
 535  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 536  *
 537  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function. \n
 538  *                  The callback is called in the main loop.
 539  *
 540  * @param[in] playlist  The handle to the media playlist
 541  * @param[in] user_data The user data passed from the foreach function
 542  *
 543  * @return @c true to continue with the next iteration of the loop,
 544  *         otherwise @c false to break out of the loop
 545  *
 546  * @pre media_playlist_foreach_playlist_from_db() will invoke this function.
 547  *
 548  * @see media_playlist_clone()
 549  * @see media_playlist_foreach_playlist_from_db()
 550  */
 551 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 552
 553 /**
 554  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 555  * @brief Called for every media info with playlist member ID in the obtained list of media info.
 556  * @details Iterates over playlist members.
 557  *
 558  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 559  *
 560  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function. \n
 561  *                  The callback is called in the main loop.
 562  *
 563  * @param[in] playlist_member_id The ID to member of the playlist
 564  * @param[in] media              The handle to the media info
 565  * @param[in] user_data          The user data passed from the foreach function
 566  *
 567  * @return @c true to continue with the next iteration of the loop,
 568  *         otherwise @c false to break out of the loop
 569  *
 570  * @pre media_playlist_foreach_media_from_db() will invoke this function.
 571  *
 572  * @see media_info_clone()
 573  * @see media_playlist_foreach_media_from_db()
 574  */
 575 typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
 576
 577 /**
 578  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 579  * @brief Called for every tag in the obtained list of tags.
 580  * @details Iterates over a list of tags.
 581  *
 582  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 583  *
 584  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function. \n
 585  *                  The callback is called in the main loop.
 586  *
 587  * @param[in] tag       The handle to the media tag
 588  * @param[in] user_data The user data passed from the foreach function
 589  *
 590  * @return @c true to continue with the next iteration of the loop,
 591  *         otherwise @c false to break out of the loop
 592  *
 593  * @pre media_tag_foreach_tag_from_db(), media_info_foreach_tag_from_db() will invoke this function.
 594  *
 595  * @see media_tag_clone()
 596  * @see media_tag_foreach_tag_from_db()
 597  * @see media_info_foreach_tag_from_db()
 598  */
 599 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 600
 601 /**
 602  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 603  * @brief Called for every bookmark in the obtained list of bookmarks.
 604  * @details Iterates over a bookmark list.
 605  *
 606  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 607  *
 608  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function. \n
 609  *                  The callback is called in the main loop.
 610  *
 611  * @param[in] bookmark  The handle to the video bookmark
 612  * @param[in] user_data The user data passed from the foreach function
 613  *
 614  * @return @c true to continue with the next iteration of the loop,
 615  *         otherwise @c false to break out of the loop
 616  *
 617  * @pre media_info_foreach_bookmark_from_db() will invoke this function.
 618  *
 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  *
 664  * @see media_group_foreach_group_from_db()
 665  */
 666 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 667
 668 /**
 669  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 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  *
 686  * @see media_storage_foreach_storage_from_db()
 687  */
 688 typedef bool (*media_storage_cb)(media_storage_h storage, void *user_data);
 689
 690 /**
 691  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 692  * @brief Called for every face in the obtained list of face.
 693  * @details Iterates over a media face list.
 694  *
 695  * @since_tizen 3.0
 696  *
 697  * @remarks You should not destroy @a face returned by this function. \n
 698  *                  The callback is called in the main loop.
 699  *
 700  * @param[in] face     The handle of the media face
 701  * @param[in] user_data  The user data passed from the foreach function
 702  *
 703  * @return @c true to continue with the next iteration of the loop,
 704  *         otherwise @c false to break out of the loop
 705  *
 706  * @pre media_info_foreach_face_from_db() will invoke this function.
 707  *
 708  * @see media_info_foreach_face_from_db()
 709  */
 710 typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 711
 712 /**
 713  * @}
 714  */
 715
 716 /**
 717  * @addtogroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 718  * @{
 719  */
 720
 721  /**
 722  * @brief Media ID
 723  * @details You can use above define to set the condition of media filter and order keyword.
 724  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 725  *
 726  */
 727 #define MEDIA_ID "MEDIA_ID"
 728
 729 /**
 730  * @brief Media full path
 731  * @details You can use above define to set the condition of media filter and order keyword.
 732  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 733  *
 734  */
 735 #define MEDIA_PATH "MEDIA_PATH"
 736
 737 /**
 738  * @brief The file name including the extension
 739  * @details You can use above define to set the condition of media filter and order keyword.
 740  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 741  *
 742  */
 743 #define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
 744
 745 /**
 746  * @brief Media type
 747  * @details There are 5 media types:\n
 748  *               0-image, 1-video, 2-sound, 3-music, 4-other\n
 749  *               You can use above define to set the condition of media filter and order keyword.
 750  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 751  *
 752  */
 753 #define MEDIA_TYPE "MEDIA_TYPE"
 754
 755 /**
 756  * @brief Media MIME type
 757  * @details You can use above define to set the condition of media filter and order keyword.
 758  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 759  *
 760  */
 761 #define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"
 762
 763
 764 /**
 765  * @brief Media file size
 766  * @details You can use above define to set the condition of media filter and order keyword.
 767  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 768  *
 769  */
 770 #define MEDIA_SIZE "MEDIA_SIZE"
 771
 772 /**
 773  * @brief The time that content file was first added to media database
 774  * @details You can use above define to set the condition of media filter and order keyword.
 775  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 776  *
 777  */
 778 #define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"
 779
 780 /**
 781  * @brief The last modification time provided by the file system
 782  * @details You can use above define to set the condition of media filter and order keyword.
 783  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 784  *
 785  */
 786 #define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
 787
 788 /**
 789  * @brief  Media created time
 790  * @details You can use above define to set the condition of media filter and order keyword.
 791  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 792  *
 793  */
 794 #define MEDIA_TIMELINE "MEDIA_TIMELINE"
 795
 796 /**
 797  * @brief Media thumbnail path
 798  * @details You can use above define to set the condition of media filter and order keyword.
 799  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 800  *
 801  */
 802 #define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
 803
 804 /**
 805  * @brief Media title get from tag or file name
 806  * @details You can use above define to set the condition of media filter and order keyword.
 807  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 808  *
 809  */
 810 #define MEDIA_TITLE "MEDIA_TITLE"
 811
 812 /**
 813  * @brief Media album name
 814  * @details You can use above define to set the condition of media filter and order keyword.
 815  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 816  *
 817  */
 818 #define MEDIA_ALBUM "MEDIA_ALBUM"
 819
 820 /**
 821  * @brief Media artist
 822  * @details You can use above define to set the condition of media filter and order keyword.
 823  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 824  *
 825  */
 826 #define MEDIA_ARTIST "MEDIA_ARTIST"
 827
 828 /**
 829  * @brief Media album artist
 830  * @details You can use above define to set the condition of media filter and order keyword.
 831  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 832  *
 833  */
 834 #define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
 835
 836 /**
 837  * @brief Media genre
 838  * @details You can use above define to set the condition of media filter and order keyword.
 839  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 840  *
 841  */
 842 #define MEDIA_GENRE "MEDIA_GENRE"
 843
 844 /**
 845  * @brief Media composer
 846  * @details You can use above define to set the condition of media filter and order keyword.
 847  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 848  *
 849  */
 850 #define MEDIA_COMPOSER "MEDIA_COMPOSER"
 851
 852 /**
 853  * @brief Media year
 854  * @details You can use above define to set the condition of media filter and order keyword.
 855  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 856  *
 857  */
 858 #define MEDIA_YEAR "MEDIA_YEAR"
 859
 860 /**
 861  * @brief Media recorded date
 862  * @details You can use above define to set the condition of media filter and order keyword.
 863  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 864  *
 865  */
 866 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
 867
 868 /**
 869  * @brief Media copyright
 870  * @details You can use above define to set the condition of media filter and order keyword.
 871  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 872  *
 873  */
 874 #define MEDIA_COPYRIGHT "MEDIA_COPYRIGHT"
 875
 876 /**
 877  * @brief Media track number
 878  * @details You can use above define to set the condition of media filter and order keyword.
 879  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 880  *
 881  */
 882 #define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"
 883
 884 /**
 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  * @brief Media bitrate
 894  * @details You can use above define to set the condition of media filter and order keyword.
 895  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 896  *
 897  */
 898 #define MEDIA_BITRATE "MEDIA_BITRATE"
 899
 900 /**
 901  * @brief Media bit per sample
 902  * @details You can use above define to set the condition of media filter and order keyword.
 903  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 904  *
 905  */
 906 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"
 907
 908 /**
 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  * @brief Media channel
 918  * @details You can use above define to set the condition of media filter and order keyword.
 919  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 920  *
 921  */
 922 #define MEDIA_CHANNEL "MEDIA_CHANNEL"
 923
 924 /**
 925  * @brief Media duration
 926  * @details You can use above define to set the condition of media filter and order keyword.
 927  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 928  *
 929  */
 930 #define MEDIA_DURATION "MEDIA_DURATION"
 931
 932 /**
 933  * @brief Media longitude
 934  * @details You can use above define to set the condition of media filter and order keyword.
 935  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 936  *
 937  */
 938 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
 939
 940 /**
 941  * @brief Media latitude
 942  * @details You can use above define to set the condition of media filter and order keyword.
 943  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 944  *
 945  */
 946 #define MEDIA_LATITUDE "MEDIA_LATITUDE"
 947
 948 /**
 949  * @brief Media altitude
 950  * @details You can use above define to set the condition of media filter and order keyword.
 951  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 952  *
 953  */
 954 #define MEDIA_ALTITUDE "MEDIA_ALTITUDE"
 955
 956 /**
 957  * @brief Media width
 958  * @details You can use above define to set the condition of media filter and order keyword.
 959  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 960  *
 961  */
 962 #define MEDIA_WIDTH "MEDIA_WIDTH"
 963
 964 /**
 965  * @brief Media height
 966  * @details You can use above define to set the condition of media filter and order keyword.
 967  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 968  *
 969  */
 970 #define MEDIA_HEIGHT "MEDIA_HEIGHT"
 971
 972 /**
 973  * @brief Media datetaken
 974  * @details You can use above define to set the condition of media filter and order keyword.
 975  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 976  *
 977  */
 978 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
 979
 980 /**
 981  * @brief Media orientation
 982  * @details You can use above define to set the condition of media filter and order keyword.
 983  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 984  *
 985  */
 986 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 987
 988 /**
 989  * @deprecated Deprecated since 4.0.
 990  * @brief Media burst ID
 991  * @details You can use above define to set the condition of media filter and order keyword.
 992  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 993  *
 994  */
 995 #define MEDIA_BURST_ID "BURST_ID"
 996
 997 /**
 998  * @deprecated Deprecated since 4.0.
 999  * @brief Media playedcount
1000  * @details You can use above define to set the condition of media filter and order keyword.
1001  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1002  *
1003  */
1004 #define MEDIA_PLAYED_COUNT "MEDIA_PLAYED_COUNT"
1005
1006 /**
1007  * @deprecated Deprecated since 4.0.
1008  * @brief Media last played time
1009  * @details You can use above define to set the condition of media filter and order keyword.
1010  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1011  *
1012  */
1013 #define MEDIA_LAST_PLAYED_TIME "MEDIA_LAST_PLAYED_TIME"
1014
1015 /**
1016  * @deprecated Deprecated since 4.0.
1017  * @brief Media last played position of file
1018  * @details You can use above define to set the condition of media filter and order keyword.
1019  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1020  *
1021  */
1022 #define MEDIA_LAST_PLAYED_POSITION "MEDIA_LAST_PLAYED_POSITION"
1023
1024 /**
1025  * @brief Media rating
1026  * @details You can use above define to set the condition of media filter and order keyword.
1027  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1028  *
1029  */
1030 #define MEDIA_RATING "MEDIA_RATING"
1031
1032 /**
1033  * @brief The time to register favourite
1034  * @details You can use above define to set the condition of media filter and order keyword.
1035  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1036  *
1037  */
1038 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
1039
1040 /**
1041  * @deprecated Deprecated since 4.0.
1042  * @brief Media author
1043  * @details You can use above define to set the condition of media filter and order keyword.
1044  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1045  *
1046  */
1047 #define MEDIA_AUTHOR "MEDIA_AUTHOR"
1048
1049 /**
1050  * @deprecated Deprecated since 4.0.
1051  * @brief Media provider
1052  * @details You can use above define to set the condition of media filter and order keyword.
1053  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1054  *
1055  */
1056 #define MEDIA_PROVIDER "MEDIA_PROVIDER"
1057
1058 /**
1059  * @deprecated Deprecated since 4.0.
1060  * @brief Media content name
1061  * @details You can use above define to set the condition of media filter and order keyword.
1062  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1063  *
1064  */
1065 #define MEDIA_CONTENT_NAME "MEDIA_CONTENT_NAME"
1066
1067 /**
1068  * @deprecated Deprecated since 4.0.
1069  * @brief Media category
1070  * @details You can use above define to set the condition of media filter and order keyword.
1071  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1072  *
1073  */
1074 #define MEDIA_CATEGORY "MEDIA_CATEGORY"
1075
1076 /**
1077  * @deprecated Deprecated since 4.0.
1078  * @brief Media location tag
1079  * @details You can use above define to set the condition of media filter and order keyword.
1080  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1081  *
1082  */
1083 #define MEDIA_LOCATION_TAG "MEDIA_LOCATION_TAG"
1084
1085 /**
1086  * @deprecated Deprecated since 4.0.
1087  * @brief Media age rating
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  *
1091  */
1092 #define MEDIA_AGE_RATING "MEDIA_AGE_RATING"
1093
1094 /**
1095  * @deprecated Deprecated since 4.0.
1096  * @brief Media keyword
1097  * @details You can use above define to set the condition of media filter and order keyword.
1098  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1099  *
1100  */
1101 #define MEDIA_KEYWORD "MEDIA_KEYWORD"
1102
1103 /**
1104  * @deprecated Deprecated since 4.0.
1105  * @brief Media weather
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  *
1109  */
1110 #define MEDIA_WEATHER "MEDIA_WEATHER"
1111
1112 /**
1113  * @brief Is DRM
1114  * @details There are 2 types:\n
1115  *               0-not drm, 1-drm\n
1116  *               You can use above define to set the condition of media filter and order keyword.
1117  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1118  *
1119  */
1120 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
1121
1122 /**
1123  * @brief Media storage
1124  * @details There are 2 types:\n
1125  *               0-internal storage, 1-external storage\n
1126  *               You can use above define to set the condition of media filter and order keyword.
1127  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1128  *
1129  */
1130 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
1131
1132 /**
1133  * @brief Media exposure time
1134  * @details You can use above define to set the condition of media filter and order keyword.
1135  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1136  *
1137  */
1138 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
1139
1140 /**
1141  * @brief Media fnumber
1142  * @details You can use above define to set the condition of media filter and order keyword.
1143  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1144  *
1145  */
1146 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
1147
1148 /**
1149  * @brief Media ISO
1150  * @details You can use above define to set the condition of media filter and order keyword.
1151  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1152  *
1153  */
1154 #define MEDIA_ISO "MEDIA_ISO"
1155
1156 /**
1157  * @brief Media model
1158  * @details You can use above define to set the condition of media filter and order keyword.
1159  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1160  *
1161  */
1162 #define MEDIA_MODEL "MEDIA_MODEL"
1163
1164 /**
1165  * @brief Media file name 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  *
1169  */
1170 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
1171
1172 /**
1173  * @brief Media title pinyin
1174  * @details You can use above define to set the condition of media filter and order keyword.
1175  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1176  *
1177  */
1178 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
1179
1180 /**
1181  * @brief Media album pinyin
1182  * @details You can use above define to set the condition of media filter and order keyword.
1183  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1184  *
1185  */
1186 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
1187
1188 /**
1189  * @brief Media artist pinyin
1190  * @details You can use above define to set the condition of media filter and order keyword.
1191  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1192  *
1193  */
1194 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
1195
1196 /**
1197  * @brief Media album artist pinyin
1198  * @details You can use above define to set the condition of media filter and order keyword.
1199  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1200  *
1201  */
1202 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
1203
1204 /**
1205  * @brief Media genre pinyin
1206  * @details You can use above define to set the condition of media filter and order keyword.
1207  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1208  *
1209  */
1210 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
1211
1212 /**
1213  * @brief Media composer pinyin
1214  * @details You can use above define to set the condition of media filter and order keyword.
1215  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1216  *
1217  */
1218 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
1219
1220 /**
1221  * @brief Media copyright pinyin
1222  * @details You can use above define to set the condition of media filter and order keyword.
1223  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1224  *
1225  */
1226 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
1227
1228 /**
1229  * @brief Media description pinyin
1230  * @details You can use above define to set the condition of media filter and order keyword.
1231  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1232  *
1233  */
1234 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
1235
1236 /**
1237  * @deprecated Deprecated since 4.0.
1238  * @brief Media author pinyin
1239  * @details You can use above define to set the condition of media filter and order keyword.
1240  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1241  *
1242  */
1243 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"
1244
1245 /**
1246  * @deprecated Deprecated since 4.0.
1247  * @brief Media provider pinyin
1248  * @details You can use above define to set the condition of media filter and order keyword.
1249  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1250  *
1251  */
1252 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"
1253
1254 /**
1255  * @deprecated Deprecated since 4.0.
1256  * @brief Media content name pinyin
1257  * @details You can use above define to set the condition of media filter and order keyword.
1258  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1259  *
1260  */
1261 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"
1262
1263 /**
1264  * @deprecated Deprecated since 4.0.
1265  * @brief Media category pinyin
1266  * @details You can use above define to set the condition of media filter and order keyword.
1267  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1268  *
1269  */
1270 #define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"
1271
1272 /**
1273  * @deprecated Deprecated since 4.0.
1274  * @brief Media location tag pinyin
1275  * @details You can use above define to set the condition of media filter and order keyword.
1276  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1277  *
1278  */
1279 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"
1280
1281 /**
1282  * @deprecated Deprecated since 4.0.
1283  * @brief Media age rating pinyin
1284  * @details You can use above define to set the condition of media filter and order keyword.
1285  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1286  *
1287  */
1288 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"
1289
1290 /**
1291  * @deprecated Deprecated since 4.0.
1292  * @brief Media keyword pinyin
1293  * @details You can use above define to set the condition of media filter and order keyword.
1294  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1295  *
1296  */
1297 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"
1298
1299 /**
1300  * @brief Virtual Reality content
1301  * @details You can use above define to set the condition of media filter and order keyword.
1302  * @since_tizen 3.0
1303  *
1304  */
1305 #define MEDIA_360 "MEDIA_360"
1306
1307  /**
1308  * @brief Folder ID
1309  * @details You can use above define to set the condition of folder filter and order keyword.
1310  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1311  */
1312 #define FOLDER_ID "FOLDER_ID"
1313
1314 /**
1315  * @brief Folder full path
1316  * @details You can use above define to set the condition of folder filter and order keyword.
1317  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1318  */
1319 #define FOLDER_PATH "FOLDER_PATH"
1320
1321 /**
1322  * @brief Folder base name
1323  * @details You can use above define to set the condition of folder filter and order keyword.
1324  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1325  */
1326 #define FOLDER_NAME "FOLDER_NAME"
1327
1328 /**
1329  * @deprecated Deprecated since 4.0.
1330  * @brief Folder modified time
1331  * @details You can use above define to set the condition of folder filter and order keyword.
1332  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1333  */
1334 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"
1335
1336 /**
1337  * @brief Folder storage
1338  * @details There are 2 types:\n
1339  *               0-internal storage, 1-external storage\n
1340  *               You can use above define to set the condition of folder filter and order keyword.
1341  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1342  */
1343 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"
1344
1345 /**
1346  * @brief Folder base name pinyin
1347  * @details You can use above define to set the condition of folder filter and order keyword.
1348  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1349  */
1350 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
1351
1352 /**
1353  * @deprecated Deprecated since 4.0.
1354  * @brief Folder order info
1355  * @details You can use above define to set the condition of folder filter and order keyword.
1356  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1357  */
1358 #define FOLDER_ORDER "FOLDER_ORDER"
1359
1360 /**
1361  * @deprecated Deprecated since 4.0.
1362  * @brief Parent folder id
1363  * @details You can use above define to set the condition of folder filter and order keyword.
1364  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1365  */
1366 #define FOLDER_PARENT_FOLDER_ID "FOLDER_PARENT_FOLDER_ID"
1367
1368 /**
1369  * @brief Playlist name
1370  * @details You can use above define to set the condition of playlist filter and order keyword.
1371  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1372  */
1373 #define PLAYLIST_NAME "PLAYLIST_NAME"
1374
1375 /**
1376  * @brief Playlist id
1377  * @details You can use above define to set the condition of playlist filter and order keyword.
1378  * @since_tizen 4.0
1379  */
1380 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
1381
1382 /**
1383  * @brief Playlist name
1384  * @details You can use above define to set the condition of playlist filter and order keyword.
1385  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1386  */
1387 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
1388
1389 /**
1390  * @brief Media count in playlist
1391  * @details You can use above define to set the condition of playlist filter and order keyword.
1392  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1393  */
1394 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
1395
1396 /**
1397  * @brief Tag name
1398  * @details You can use above define to set the condition of tag filter and order keyword.
1399  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1400  */
1401 #define TAG_NAME "TAG_NAME"
1402
1403 /**
1404  * @brief Tag id
1405  * @details You can use above define to set the condition of tag filter and order keyword.
1406  * @since_tizen 4.0
1407  */
1408 #define MEDIA_TAG_ID "TAG_ID"
1409
1410 /**
1411  * @brief Media count in tag
1412  * @details You can use above define to set the condition of tag filter and order keyword.
1413  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1414  */
1415 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
1416
1417 /**
1418  * @brief Bookmark marked time
1419  * @details You can use above define to set the condition of bookmark filter and order keyword.
1420  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1421  */
1422 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
1423
1424 /**
1425  * @brief Bookmark id
1426  * @details You can use above define to set the condition of bookmark filter and order keyword.
1427  * @since_tizen 4.0
1428  */
1429 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
1430
1431 /**
1432  * @brief Bookmark name
1433  * @details You can use above define to set the condition of bookmark filter and order keyword.
1434  * @since_tizen 4.0
1435  */
1436 #define BOOKMARK_NAME "BOOKMARK_NAME"
1437
1438 /**
1439  * @brief Storage ID
1440  * @details You can use above define to set the condition of storage filter and order keyword.
1441  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1442  */
1443 #define MEDIA_STORAGE_ID                                        "STORAGE_ID"
1444
1445 /**
1446  * @brief Storage path
1447  * @details You can use above define to set the condition of storage filter and order keyword.
1448  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1449  */
1450 #define MEDIA_STORAGE_PATH                              "STORAGE_PATH"
1451
1452 /**
1453  * @brief Face tag
1454  * @details You can use above define to set the condition of face filter and order keyword.
1455  * @since_tizen 3.0
1456  */
1457 #define MEDIA_FACE_TAG  "MEDIA_FACE_TAG"
1458
1459 /**
1460  * @brief Face id
1461  * @details You can use above define to set the condition of face filter and order keyword.
1462  * @since_tizen 4.0
1463  */
1464 #define MEDIA_FACE_ID   "MEDIA_FACE_ID"
1465
1466 /**
1467  * @}
1468  */
1469
1470
1471 #ifdef __cplusplus
1472 }
1473 #endif /* __cplusplus */
1474
1475
1476 #endif /*__TIZEN_MEDIA_CONTENT_TYPE_H__*/