[ACR] Deprecate API that is paired with media_info_set_author
[platform/core/api/media-content.git] / 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*/
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*/
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*/
189         MEDIA_CONTENT_GROUP_LOCATION_TAG,        /**< Media group ID for a location tag*/
190         MEDIA_CONTENT_GROUP_AGE_RATING,          /**< Media group ID for an age rating*/
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*/
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  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
439  * @brief Called when the burst shot is inserted completely.
440  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
441  *
442  * @remarks The callback is called in a separate thread(not in the main loop).
443  *
444  * @param[in] media     The handle to the media info
445  * @param[in] user_data The user data passed from the foreach function
446  *
447  * @pre media_info_insert_burst_shot_to_db()
448  *
449  * @see media_info_insert_burst_shot_to_db()
450  *
451  */
452 typedef void (*media_insert_burst_shot_completed_cb)(media_content_error_e error, void * user_data);
453
454
455 /**
456  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
457  * @brief Called when creating a thumbnail image.
458  * @details This callback is called for completion of generating the thumbnail image.
459  *         The following error codes can be delivered. \n
460  *         #MEDIA_CONTENT_ERROR_NONE, \n
461  *         #MEDIA_CONTENT_ERROR_INVALID_PARAMETER, \n
462  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
463  *         #MEDIA_CONTENT_ERROR_PERMISSION_DENIED, \n
464  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
465  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
466  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
467  *
468  * @remarks The callback is called in a separate thread(not in the main loop).
469  *
470  * @param[in] error     The error code
471  * @param[in] path      The path of the thumbnail which is generated
472  * @param[in] user_data The user data passed from the foreach function
473  *
474  * @pre media_info_create_thumbnail()
475  *
476  * @see media_info_create_thumbnail()
477  */
478 typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data);
479
480 /**
481  * @ingroup CAPI_CONTENT_MEDIA_FACE_DETECTION_MODULE
482  * @brief Called when face detection on the image is completed.
483  *
484  * @details The following error codes can be delivered. \n
485  *         #MEDIA_CONTENT_ERROR_NONE, \n
486  *         #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, \n
487  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
488  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
489  *         #MEDIA_CONTENT_ERROR_DB_BUSY, \n
490  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
491  *
492  * @since_tizen 3.0
493  *
494  * @remarks The callback is called in a separate thread(not in the main loop).
495  *
496  * @param[in] error     The error code
497  * @param[in] face_count      The number of all detected faces
498  * @param[in] user_data The user data passed from the foreach function
499  *
500  * @pre media_info_start_face_detection()
501  *
502  * @see media_info_start_face_detection()
503  */
504 typedef void (*media_face_detection_completed_cb)(media_content_error_e error, const int face_count, void *user_data);
505
506
507 /**
508  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
509  * @brief Called for every available media folder.
510  * @details Iterates over a list of folders.
511  *
512  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
513  *
514  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function. \n
515  *                  The callback is called in the main loop.
516  *
517  * @param[in] folder    The handle to the media folder
518  * @param[in] user_data The user data passed from the foreach function
519  *
520  * @return @c true to continue with the next iteration of the loop,
521  *         otherwise @c false to break out of the loop
522  *
523  * @pre media_folder_foreach_folder_from_db() will invoke this function.
524  * @see media_folder_clone()
525  * @see media_folder_foreach_folder_from_db()
526  */
527 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
528
529 /**
530  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
531  * @brief Called for every playlist in the obtained list of playlists.
532  * @details Iterates over a playlist list.
533  *
534  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
535  *
536  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function. \n
537  *                  The callback is called in the main loop.
538  *
539  * @param[in] playlist  The handle to the media playlist
540  * @param[in] user_data The user data passed from the foreach function
541  *
542  * @return @c true to continue with the next iteration of the loop,
543  *         otherwise @c false to break out of the loop
544  *
545  * @pre media_playlist_foreach_playlist_from_db() will invoke this function.
546  *
547  * @see media_playlist_clone()
548  * @see media_playlist_foreach_playlist_from_db()
549  */
550 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
551
552 /**
553  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
554  * @brief Called for every media info with playlist member ID in the obtained list of media info.
555  * @details Iterates over playlist members.
556  *
557  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
558  *
559  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function. \n
560  *                  The callback is called in the main loop.
561  *
562  * @param[in] playlist_member_id The ID to member of the playlist
563  * @param[in] media              The handle to the media info
564  * @param[in] user_data          The user data passed from the foreach function
565  *
566  * @return @c true to continue with the next iteration of the loop,
567  *         otherwise @c false to break out of the loop
568  *
569  * @pre media_playlist_foreach_media_from_db() will invoke this function.
570  *
571  * @see media_info_clone()
572  * @see media_playlist_foreach_media_from_db()
573  */
574 typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
575
576 /**
577  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
578  * @brief Called for every tag in the obtained list of tags.
579  * @details Iterates over a list of tags.
580  *
581  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
582  *
583  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function. \n
584  *                  The callback is called in the main loop.
585  *
586  * @param[in] tag       The handle to the media tag
587  * @param[in] user_data The user data passed from the foreach function
588  *
589  * @return @c true to continue with the next iteration of the loop,
590  *         otherwise @c false to break out of the loop
591  *
592  * @pre media_tag_foreach_tag_from_db(), media_info_foreach_tag_from_db() will invoke this function.
593  *
594  * @see media_tag_clone()
595  * @see media_tag_foreach_tag_from_db()
596  * @see media_info_foreach_tag_from_db()
597  */
598 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
599
600 /**
601  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
602  * @brief Called for every bookmark in the obtained list of bookmarks.
603  * @details Iterates over a bookmark list.
604  *
605  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
606  *
607  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function. \n
608  *                  The callback is called in the main loop.
609  *
610  * @param[in] bookmark  The handle to the video bookmark
611  * @param[in] user_data The user data passed from the foreach function
612  *
613  * @return @c true to continue with the next iteration of the loop,
614  *         otherwise @c false to break out of the loop
615  *
616  * @pre media_info_foreach_bookmark_from_db() will invoke this function.
617  *
618  * @see media_info_foreach_bookmark_from_db()
619  */
620 typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
621
622 /**
623  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
624  * @brief Called for every album in the obtained list of groups.
625  * @details Iterates over an album list.
626  *
627  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
628  *
629  * @remarks To use the @a album outside this function, copy the handle with the media_album_clone() function. \n
630  *                  The callback is called in the main loop.
631  *
632  * @param[in] album     The handle to the media album
633  * @param[in] user_data The user data passed from the foreach function
634  *
635  * @return @c true to continue with the next iteration of the loop,
636  *         otherwise @c false to break out of the loop
637  *
638  * @pre media_album_foreach_album_from_db() will invoke this function.
639  *
640  * @see media_album_clone()
641  * @see media_album_foreach_album_from_db()
642  */
643 typedef bool (*media_album_cb)(media_album_h album, void *user_data);
644
645 /**
646  * @ingroup CAPI_CONTENT_MEDIA_GROUP_MODULE
647  * @brief Called for every group in the obtained list of groups.
648  * @details Iterates over a media group list.
649  *
650  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
651  *
652  * @remarks You should not free @a group_name returned by this function. \n
653  *                  The callback is called in the main loop.
654  *
655  * @param[in] group_name The name of the media group
656  * @param[in] user_data  The user data passed from the foreach function
657  *
658  * @return @c true to continue with the next iteration of the loop,
659  *         otherwise @c false to break out of the loop
660  *
661  * @pre media_group_foreach_group_from_db() will invoke this function.
662  *
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  * @brief Called for every storage in the obtained list of storages.
670  * @details Iterates over a media storage list.
671  *
672  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
673  *
674  * @remarks You should not destroy @a storage returned by this function. \n
675  *                  The callback is called in the main loop.
676  *
677  * @param[in] storage     The handle of the media storage
678  * @param[in] user_data  The user data passed from the foreach function
679  *
680  * @return @c true to continue with the next iteration of the loop,
681  *         otherwise @c false to break out of the loop
682  *
683  * @pre media_storage_foreach_storage_from_db() will invoke this function.
684  *
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  *
707  * @see media_info_foreach_face_from_db()
708  */
709 typedef bool (*media_face_cb)(media_face_h face, void *user_data);
710
711 /**
712  * @}
713  */
714
715 /**
716  * @addtogroup CAPI_CONTENT_MEDIA_FILTER_MODULE
717  * @{
718  */
719
720  /**
721  * @brief Media ID
722  * @details You can use above define to set the condition of media filter and order keyword.
723  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
724  *
725  */
726 #define MEDIA_ID "MEDIA_ID"
727
728 /**
729  * @brief Media full path
730  * @details You can use above define to set the condition of media filter and order keyword.
731  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
732  *
733  */
734 #define MEDIA_PATH "MEDIA_PATH"
735
736 /**
737  * @brief The file name including the extension
738  * @details You can use above define to set the condition of media filter and order keyword.
739  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
740  *
741  */
742 #define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
743
744 /**
745  * @brief Media type
746  * @details There are 5 media types:\n
747  *               0-image, 1-video, 2-sound, 3-music, 4-other\n
748  *               You can use above define to set the condition of media filter and order keyword.
749  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
750  *
751  */
752 #define MEDIA_TYPE "MEDIA_TYPE"
753
754 /**
755  * @brief Media MIME type
756  * @details You can use above define to set the condition of media filter and order keyword.
757  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
758  *
759  */
760 #define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"
761
762
763 /**
764  * @brief Media file size
765  * @details You can use above define to set the condition of media filter and order keyword.
766  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
767  *
768  */
769 #define MEDIA_SIZE "MEDIA_SIZE"
770
771 /**
772  * @brief The time that content file was first added to media database
773  * @details You can use above define to set the condition of media filter and order keyword.
774  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
775  *
776  */
777 #define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"
778
779 /**
780  * @brief The last modification time provided by the file system
781  * @details You can use above define to set the condition of media filter and order keyword.
782  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
783  *
784  */
785 #define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
786
787 /**
788  * @brief  Media created time
789  * @details You can use above define to set the condition of media filter and order keyword.
790  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
791  *
792  */
793 #define MEDIA_TIMELINE "MEDIA_TIMELINE"
794
795 /**
796  * @brief Media thumbnail path
797  * @details You can use above define to set the condition of media filter and order keyword.
798  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
799  *
800  */
801 #define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
802
803 /**
804  * @brief Media title get from tag or file name
805  * @details You can use above define to set the condition of media filter and order keyword.
806  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
807  *
808  */
809 #define MEDIA_TITLE "MEDIA_TITLE"
810
811 /**
812  * @brief Media album name
813  * @details You can use above define to set the condition of media filter and order keyword.
814  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
815  *
816  */
817 #define MEDIA_ALBUM "MEDIA_ALBUM"
818
819 /**
820  * @brief Media artist
821  * @details You can use above define to set the condition of media filter and order keyword.
822  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
823  *
824  */
825 #define MEDIA_ARTIST "MEDIA_ARTIST"
826
827 /**
828  * @brief Media album artist
829  * @details You can use above define to set the condition of media filter and order keyword.
830  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
831  *
832  */
833 #define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
834
835 /**
836  * @brief Media genre
837  * @details You can use above define to set the condition of media filter and order keyword.
838  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
839  *
840  */
841 #define MEDIA_GENRE "MEDIA_GENRE"
842
843 /**
844  * @brief Media composer
845  * @details You can use above define to set the condition of media filter and order keyword.
846  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
847  *
848  */
849 #define MEDIA_COMPOSER "MEDIA_COMPOSER"
850
851 /**
852  * @brief Media year
853  * @details You can use above define to set the condition of media filter and order keyword.
854  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
855  *
856  */
857 #define MEDIA_YEAR "MEDIA_YEAR"
858
859 /**
860  * @brief Media recorded date
861  * @details You can use above define to set the condition of media filter and order keyword.
862  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
863  *
864  */
865 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
866
867 /**
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  * @brief Media description
885  * @details You can use above define to set the condition of media filter and order keyword.
886  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
887  *
888  */
889 #define MEDIA_DESCRIPTION "MEDIA_DESCRIPTION"
890
891 /**
892  * @brief Media bitrate
893  * @details You can use above define to set the condition of media filter and order keyword.
894  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
895  *
896  */
897 #define MEDIA_BITRATE "MEDIA_BITRATE"
898
899 /**
900  * @brief Media bit per sample
901  * @details You can use above define to set the condition of media filter and order keyword.
902  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
903  *
904  */
905 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"
906
907 /**
908  * @brief Media sample rate
909  * @details You can use above define to set the condition of media filter and order keyword.
910  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
911  *
912  */
913 #define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"
914
915 /**
916  * @brief Media channel
917  * @details You can use above define to set the condition of media filter and order keyword.
918  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
919  *
920  */
921 #define MEDIA_CHANNEL "MEDIA_CHANNEL"
922
923 /**
924  * @brief Media duration
925  * @details You can use above define to set the condition of media filter and order keyword.
926  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
927  *
928  */
929 #define MEDIA_DURATION "MEDIA_DURATION"
930
931 /**
932  * @brief Media longitude
933  * @details You can use above define to set the condition of media filter and order keyword.
934  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
935  *
936  */
937 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
938
939 /**
940  * @brief Media latitude
941  * @details You can use above define to set the condition of media filter and order keyword.
942  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
943  *
944  */
945 #define MEDIA_LATITUDE "MEDIA_LATITUDE"
946
947 /**
948  * @brief Media altitude
949  * @details You can use above define to set the condition of media filter and order keyword.
950  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
951  *
952  */
953 #define MEDIA_ALTITUDE "MEDIA_ALTITUDE"
954
955 /**
956  * @brief Media width
957  * @details You can use above define to set the condition of media filter and order keyword.
958  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
959  *
960  */
961 #define MEDIA_WIDTH "MEDIA_WIDTH"
962
963 /**
964  * @brief Media height
965  * @details You can use above define to set the condition of media filter and order keyword.
966  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
967  *
968  */
969 #define MEDIA_HEIGHT "MEDIA_HEIGHT"
970
971 /**
972  * @brief Media datetaken
973  * @details You can use above define to set the condition of media filter and order keyword.
974  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
975  *
976  */
977 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
978
979 /**
980  * @brief Media orientation
981  * @details You can use above define to set the condition of media filter and order keyword.
982  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
983  *
984  */
985 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
986
987 /**
988  * @brief Media burst ID
989  * @details You can use above define to set the condition of media filter and order keyword.
990  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
991  *
992  */
993 #define MEDIA_BURST_ID "BURST_ID"
994
995 /**
996  * @deprecated Deprecated since 4.0.
997  * @brief Media playedcount
998  * @details You can use above define to set the condition of media filter and order keyword.
999  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1000  *
1001  */
1002 #define MEDIA_PLAYED_COUNT "MEDIA_PLAYED_COUNT"
1003
1004 /**
1005  * @deprecated Deprecated since 4.0.
1006  * @brief Media last played time
1007  * @details You can use above define to set the condition of media filter and order keyword.
1008  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1009  *
1010  */
1011 #define MEDIA_LAST_PLAYED_TIME "MEDIA_LAST_PLAYED_TIME"
1012
1013 /**
1014  * @deprecated Deprecated since 4.0.
1015  * @brief Media last played position of file
1016  * @details You can use above define to set the condition of media filter and order keyword.
1017  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1018  *
1019  */
1020 #define MEDIA_LAST_PLAYED_POSITION "MEDIA_LAST_PLAYED_POSITION"
1021
1022 /**
1023  * @brief Media rating
1024  * @details You can use above define to set the condition of media filter and order keyword.
1025  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1026  *
1027  */
1028 #define MEDIA_RATING "MEDIA_RATING"
1029
1030 /**
1031  * @brief The time to register favourite
1032  * @details You can use above define to set the condition of media filter and order keyword.
1033  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1034  *
1035  */
1036 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
1037
1038 /**
1039  * @deprecated Deprecated since 4.0.
1040  * @brief Media author
1041  * @details You can use above define to set the condition of media filter and order keyword.
1042  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1043  *
1044  */
1045 #define MEDIA_AUTHOR "MEDIA_AUTHOR"
1046
1047 /**
1048  * @brief Media provider
1049  * @details You can use above define to set the condition of media filter and order keyword.
1050  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1051  *
1052  */
1053 #define MEDIA_PROVIDER "MEDIA_PROVIDER"
1054
1055 /**
1056  * @deprecated Deprecated since 4.0.
1057  * @brief Media content name
1058  * @details You can use above define to set the condition of media filter and order keyword.
1059  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1060  *
1061  */
1062 #define MEDIA_CONTENT_NAME "MEDIA_CONTENT_NAME"
1063
1064 /**
1065  * @brief Media category
1066  * @details You can use above define to set the condition of media filter and order keyword.
1067  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1068  *
1069  */
1070 #define MEDIA_CATEGORY "MEDIA_CATEGORY"
1071
1072 /**
1073  * @brief Media location tag
1074  * @details You can use above define to set the condition of media filter and order keyword.
1075  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1076  *
1077  */
1078 #define MEDIA_LOCATION_TAG "MEDIA_LOCATION_TAG"
1079
1080 /**
1081  * @brief Media age rating
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  *
1085  */
1086 #define MEDIA_AGE_RATING "MEDIA_AGE_RATING"
1087
1088 /**
1089  * @deprecated Deprecated since 4.0.
1090  * @brief Media keyword
1091  * @details You can use above define to set the condition of media filter and order keyword.
1092  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1093  *
1094  */
1095 #define MEDIA_KEYWORD "MEDIA_KEYWORD"
1096
1097 /**
1098  * @brief Media weather
1099  * @details You can use above define to set the condition of media filter and order keyword.
1100  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1101  *
1102  */
1103 #define MEDIA_WEATHER "MEDIA_WEATHER"
1104
1105 /**
1106  * @brief Is DRM
1107  * @details There are 2 types:\n
1108  *               0-not drm, 1-drm\n
1109  *               You can use above define to set the condition of media filter and order keyword.
1110  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1111  *
1112  */
1113 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
1114
1115 /**
1116  * @brief Media storage
1117  * @details There are 2 types:\n
1118  *               0-internal storage, 1-external storage\n
1119  *               You can use above define to set the condition of media filter and order keyword.
1120  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1121  *
1122  */
1123 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
1124
1125 /**
1126  * @brief Media exposure time
1127  * @details You can use above define to set the condition of media filter and order keyword.
1128  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1129  *
1130  */
1131 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
1132
1133 /**
1134  * @brief Media fnumber
1135  * @details You can use above define to set the condition of media filter and order keyword.
1136  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1137  *
1138  */
1139 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
1140
1141 /**
1142  * @brief Media ISO
1143  * @details You can use above define to set the condition of media filter and order keyword.
1144  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1145  *
1146  */
1147 #define MEDIA_ISO "MEDIA_ISO"
1148
1149 /**
1150  * @brief Media model
1151  * @details You can use above define to set the condition of media filter and order keyword.
1152  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1153  *
1154  */
1155 #define MEDIA_MODEL "MEDIA_MODEL"
1156
1157 /**
1158  * @brief Media file name pinyin
1159  * @details You can use above define to set the condition of media filter and order keyword.
1160  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1161  *
1162  */
1163 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
1164
1165 /**
1166  * @brief Media title pinyin
1167  * @details You can use above define to set the condition of media filter and order keyword.
1168  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1169  *
1170  */
1171 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
1172
1173 /**
1174  * @brief Media album pinyin
1175  * @details You can use above define to set the condition of media filter and order keyword.
1176  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1177  *
1178  */
1179 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
1180
1181 /**
1182  * @brief Media artist pinyin
1183  * @details You can use above define to set the condition of media filter and order keyword.
1184  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1185  *
1186  */
1187 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
1188
1189 /**
1190  * @brief Media album artist pinyin
1191  * @details You can use above define to set the condition of media filter and order keyword.
1192  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1193  *
1194  */
1195 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
1196
1197 /**
1198  * @brief Media genre pinyin
1199  * @details You can use above define to set the condition of media filter and order keyword.
1200  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1201  *
1202  */
1203 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
1204
1205 /**
1206  * @brief Media composer pinyin
1207  * @details You can use above define to set the condition of media filter and order keyword.
1208  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1209  *
1210  */
1211 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
1212
1213 /**
1214  * @brief Media copyright pinyin
1215  * @details You can use above define to set the condition of media filter and order keyword.
1216  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1217  *
1218  */
1219 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
1220
1221 /**
1222  * @brief Media description pinyin
1223  * @details You can use above define to set the condition of media filter and order keyword.
1224  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1225  *
1226  */
1227 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
1228
1229 /**
1230  * @deprecated Deprecated since 4.0.
1231  * @brief Media author pinyin
1232  * @details You can use above define to set the condition of media filter and order keyword.
1233  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1234  *
1235  */
1236 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"
1237
1238 /**
1239  * @brief Media provider pinyin
1240  * @details You can use above define to set the condition of media filter and order keyword.
1241  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1242  *
1243  */
1244 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"
1245
1246 /**
1247  * @deprecated Deprecated since 4.0.
1248  * @brief Media content name pinyin
1249  * @details You can use above define to set the condition of media filter and order keyword.
1250  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1251  *
1252  */
1253 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"
1254
1255 /**
1256  * @brief Media category 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_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"
1262
1263 /**
1264  * @brief Media location tag pinyin
1265  * @details You can use above define to set the condition of media filter and order keyword.
1266  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1267  *
1268  */
1269 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"
1270
1271 /**
1272  * @brief Media age rating pinyin
1273  * @details You can use above define to set the condition of media filter and order keyword.
1274  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1275  *
1276  */
1277 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"
1278
1279 /**
1280  * @deprecated Deprecated since 4.0.
1281  * @brief Media keyword pinyin
1282  * @details You can use above define to set the condition of media filter and order keyword.
1283  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1284  *
1285  */
1286 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"
1287
1288 /**
1289  * @brief Virtual Reality content
1290  * @details You can use above define to set the condition of media filter and order keyword.
1291  * @since_tizen 3.0
1292  *
1293  */
1294 #define MEDIA_360 "MEDIA_360"
1295
1296  /**
1297  * @brief Folder ID
1298  * @details You can use above define to set the condition of folder filter and order keyword.
1299  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1300  */
1301 #define FOLDER_ID "FOLDER_ID"
1302
1303 /**
1304  * @brief Folder full path
1305  * @details You can use above define to set the condition of folder filter and order keyword.
1306  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1307  */
1308 #define FOLDER_PATH "FOLDER_PATH"
1309
1310 /**
1311  * @brief Folder base name
1312  * @details You can use above define to set the condition of folder filter and order keyword.
1313  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1314  */
1315 #define FOLDER_NAME "FOLDER_NAME"
1316
1317 /**
1318  * @deprecated Deprecated since 4.0.
1319  * @brief Folder modified time
1320  * @details You can use above define to set the condition of folder filter and order keyword.
1321  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1322  */
1323 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"
1324
1325 /**
1326  * @brief Folder storage
1327  * @details There are 2 types:\n
1328  *               0-internal storage, 1-external storage\n
1329  *               You can use above define to set the condition of folder filter and order keyword.
1330  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1331  */
1332 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"
1333
1334 /**
1335  * @brief Folder base name pinyin
1336  * @details You can use above define to set the condition of folder filter and order keyword.
1337  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1338  */
1339 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
1340
1341 /**
1342  * @deprecated Deprecated since 4.0.
1343  * @brief Folder order info
1344  * @details You can use above define to set the condition of folder filter and order keyword.
1345  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1346  */
1347 #define FOLDER_ORDER "FOLDER_ORDER"
1348
1349 /**
1350  * @deprecated Deprecated since 4.0.
1351  * @brief Parent folder id
1352  * @details You can use above define to set the condition of folder filter and order keyword.
1353  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1354  */
1355 #define FOLDER_PARENT_FOLDER_ID "FOLDER_PARENT_FOLDER_ID"
1356
1357 /**
1358  * @brief Playlist name
1359  * @details You can use above define to set the condition of playlist filter and order keyword.
1360  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1361  */
1362 #define PLAYLIST_NAME "PLAYLIST_NAME"
1363
1364 /**
1365  * @brief Playlist id
1366  * @details You can use above define to set the condition of playlist filter and order keyword.
1367  * @since_tizen 4.0
1368  */
1369 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
1370
1371 /**
1372  * @brief Playlist name
1373  * @details You can use above define to set the condition of playlist filter and order keyword.
1374  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1375  */
1376 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
1377
1378 /**
1379  * @brief Media count in playlist
1380  * @details You can use above define to set the condition of playlist filter and order keyword.
1381  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1382  */
1383 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
1384
1385 /**
1386  * @brief Tag name
1387  * @details You can use above define to set the condition of tag filter and order keyword.
1388  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1389  */
1390 #define TAG_NAME "TAG_NAME"
1391
1392 /**
1393  * @brief Tag id
1394  * @details You can use above define to set the condition of tag filter and order keyword.
1395  * @since_tizen 4.0
1396  */
1397 #define MEDIA_TAG_ID "TAG_ID"
1398
1399 /**
1400  * @brief Media count in tag
1401  * @details You can use above define to set the condition of tag filter and order keyword.
1402  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1403  */
1404 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
1405
1406 /**
1407  * @brief Bookmark marked time
1408  * @details You can use above define to set the condition of bookmark filter and order keyword.
1409  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1410  */
1411 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
1412
1413 /**
1414  * @brief Bookmark id
1415  * @details You can use above define to set the condition of bookmark filter and order keyword.
1416  * @since_tizen 4.0
1417  */
1418 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
1419
1420 /**
1421  * @brief Bookmark name
1422  * @details You can use above define to set the condition of bookmark filter and order keyword.
1423  * @since_tizen 4.0
1424  */
1425 #define BOOKMARK_NAME "BOOKMARK_NAME"
1426
1427 /**
1428  * @brief Storage ID
1429  * @details You can use above define to set the condition of storage filter and order keyword.
1430  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1431  */
1432 #define MEDIA_STORAGE_ID                                        "STORAGE_ID"
1433
1434 /**
1435  * @brief Storage path
1436  * @details You can use above define to set the condition of storage filter and order keyword.
1437  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1438  */
1439 #define MEDIA_STORAGE_PATH                              "STORAGE_PATH"
1440
1441 /**
1442  * @brief Face tag
1443  * @details You can use above define to set the condition of face filter and order keyword.
1444  * @since_tizen 3.0
1445  */
1446 #define MEDIA_FACE_TAG  "MEDIA_FACE_TAG"
1447
1448 /**
1449  * @brief Face id
1450  * @details You can use above define to set the condition of face filter and order keyword.
1451  * @since_tizen 4.0
1452  */
1453 #define MEDIA_FACE_ID   "MEDIA_FACE_ID"
1454
1455 /**
1456  * @}
1457  */
1458
1459
1460 #ifdef __cplusplus
1461 }
1462 #endif /* __cplusplus */
1463
1464
1465 #endif /*__TIZEN_MEDIA_CONTENT_TYPE_H__*/