[ACR-1129] Add feature 24/165424/1
authorMinje Ahn <minje.ahn@samsung.com>
Thu, 21 Dec 2017 02:06:43 +0000 (11:06 +0900)
committerhj kim <backto.kim@samsung.com>
Fri, 29 Dec 2017 02:39:09 +0000 (11:39 +0900)
Change-Id: I8244836284444864a619fbf2bbca9395bca235a0
Signed-off-by: Minje Ahn <minje.ahn@samsung.com>
doc/media_content_doc.h
include/media_content.h
include/media_content_type.h
include/media_info.h
include_product/media_content.h
include_product/media_content_type.h
include_product/media_info.h

index a6aff7e..3f650da 100755 (executable)
  * The Media Filter API provides functions for creating and destroying media filters.\n
  * It provide functions to set and get properties of the filter associated with a given media filter. \n
  * For creating a media filter (@ref filter_h), call #media_filter_create() function and call #media_filter_destroy() function for destroying an existing filter. \n
- * For setting filter properties call the respective set functions e.g. to set offset position, call #media_filter_set_offset() function and 
+ * For setting filter properties call the respective set functions e.g. to set offset position, call #media_filter_set_offset() function and
  * call #media_filter_set_condition() function to set the condition like an sql "where" clause. \n
  * Searchable expression can use one of the following forms:
  *
  * And the optional ESCAPE clause is supported. Both percent symbol("%") and underscore symbol("_") are used in the LIKE pattern.\n
  * If these characters are used as value of LIKE operation, then the expression following the ESCAPE caluse of sqlite will be ignored. \n
  *
- * For example, 
+ * For example,
  * - column LIKE ('#%') ESCAPE('#') - "#" is escape character, it will be ignored.
  *\n
  *
  *
- * Similarly, call respective get function to get filter properties e.g. call #media_filter_get_condition() function 
+ * Similarly, call respective get function to get filter properties e.g. call #media_filter_get_condition() function
  * to get condition of the media filter and call #media_filter_get_order() function to get order (#media_content_order_e) of the filtered items and so on.
  *
  * @section CAPI_CONTENT_MEDIA_FILTER_MODULE_EXAMPLE Example
  *
  * <p>
  * For getting the audio handle (#audio_meta_h) from the media information (#media_info_h), call #media_info_get_audio() function.\n
- * For getting the information related to audio files stored in the device, call the respective get functions e.g. to get the artist of a audio, call #audio_meta_get_artist() function and 
+ * For getting the information related to audio files stored in the device, call the respective get functions e.g. to get the artist of a audio, call #audio_meta_get_artist() function and
  * to get bitrate of a audio, call #audio_meta_get_bit_rate() function and so on.\n
  * When the audio handle is no longer needed, it should be destroyed by calling #audio_meta_destroy() function.\n
  *
  *
  * For inserting new playlist (#media_playlist_h) in the database, call  #media_playlist_insert_to_db() function and call #media_playlist_delete_from_db() function
  * to delete a playlist from the database.\n
- * For adding a media item to the playlist, call #media_playlist_add_media() function, for removing a media item from the playlist, call 
+ * For adding a media item to the playlist, call #media_playlist_add_media() function, for removing a media item from the playlist, call
  * #media_playlist_remove_media() function.\n
  * Finally, #media_playlist_update_to_db() function should be called so as to update the given item in the media database.
  *
  * @section CAPI_CONTENT_MEDIA_GROUP_MODULE_OVERVIEW Overview
  * A Media Group represents logical grouping of media files with respect to their group name. It is also used for filtering media items.\n
  *
- * The API provides functions to get and search image, video and audio items in media group. 
+ * The API provides functions to get and search image, video and audio items in media group.
  * For getting the count of media items associated with a given group, call #media_group_get_media_count_from_db() function.
  *
  *
  *
  *<p>
  * For getting the image handle (#image_meta_h) from the media information (#media_info_h), call #media_info_get_image() function.\n
- * For getting the information related to image files stored in the device call the respective get functions e.g. to get the width of a image, call #image_meta_get_width() function and 
+ * For getting the information related to image files stored in the device call the respective get functions e.g. to get the width of a image, call #image_meta_get_width() function and
  * to get orientation (#media_content_orientation_e) of a image, call #image_meta_get_orientation() function and so on.\n
  * When the image handle is no longer needed, it should be destroyed by calling #image_meta_destroy() function.\n
  *
  * - insert new bookmarks
  * - delete bookmarks
  *
- * For inserting a bookmark to media item, call media_bookmark_insert_to_db() function and for deleting already set bookmark from a media, call 
+ * For inserting a bookmark to media item, call media_bookmark_insert_to_db() function and for deleting already set bookmark from a media, call
  * #media_bookmark_delete_from_db() function.
  * For retrieving time where the bookmark is placed on the media, call #media_bookmark_get_marked_time() function.
  *
index 5a70a1b..a69091a 100755 (executable)
@@ -103,6 +103,9 @@ int media_content_disconnect(void);
  *                   If you want to access only internal storage by using  this API, you should add privilege http://tizen.org/privilege/mediastorage. \n
  *                   Or if you want to access only external storage by using  this API, you should add privilege http://tizen.org/privilege/externalstorage. \n
  *                   If you can access both storage, you must add all privilege.
+ * @remarks Since 4.0, this function is related to the following feature:\n
+ *              %http://tizen.org/feature/content.scanning.others\n
+ *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  *
  * @param[in] path The file path
  *
@@ -115,6 +118,7 @@ int media_content_disconnect(void);
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED    DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY    DB Operation busy
+ * @retval #MEDIA_CONTENT_ERROR_NOT_SUPPORTED     Not supported
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  * @see media_content_connect()
index d98562d..43203cd 100755 (executable)
@@ -42,6 +42,9 @@ extern "C" {
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for the media file format.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, #MEDIA_CONTENT_TYPE_OTHERS is related to the following feature:\n
+ *              %http://tizen.org/feature/content.scanning.others\n
+ *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  */
 typedef enum {
        MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
@@ -1089,6 +1092,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media file name pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *             If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
@@ -1097,6 +1103,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media title pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *             If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
@@ -1105,6 +1114,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media album pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
@@ -1113,6 +1125,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media artist pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *             If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
@@ -1121,6 +1136,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media album artist pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
@@ -1129,6 +1147,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media genre pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
@@ -1137,6 +1158,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media composer pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
@@ -1145,6 +1169,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media copyright pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
@@ -1153,6 +1180,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media description pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
@@ -1162,6 +1192,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media author pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"
@@ -1171,6 +1204,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media provider pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"
@@ -1180,6 +1216,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media content name pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"
@@ -1189,6 +1228,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media category pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"
@@ -1198,6 +1240,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media location tag pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"
@@ -1207,6 +1252,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media age rating pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"
@@ -1216,6 +1264,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media keyword pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"
@@ -1270,6 +1321,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Folder base name pinyin
  * @details You can use above define to set the condition of folder filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  */
 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
 
index 2b1d66a..22b2e39 100755 (executable)
@@ -57,6 +57,9 @@ extern "C" {
  *                   If you want to access only internal storage by using  this API, you should add privilege http://tizen.org/privilege/mediastorage. \n
  *                   Or if you want to access only external storage by using  this API, you should add privilege http://tizen.org/privilege/externalstorage. \n
  *                   If you can access both storage, you must add all privilege.
+ * @remarks Since 4.0, this function is related to the following feature:\n
+ *              %http://tizen.org/feature/content.scanning.others\n
+ *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  *
  * @param[in]  path The path of the content file to add
  * @param[out] info The handle of the inserted content file
@@ -72,6 +75,7 @@ extern "C" {
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #MEDIA_CONTENT_ERROR_NOT_SUPPORTED     Not supported
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *
@@ -96,6 +100,9 @@ int media_info_insert_to_db(const char *path, media_info_h *info);
  *                   If you want to access only internal storage by using  this API, you should add privilege http://tizen.org/privilege/mediastorage. \n
  *                   Or if you want to access only external storage by using  this API, you should add privilege http://tizen.org/privilege/externalstorage. \n
  *                   If you can access both storage, you must add all privilege.
+ * @remarks Since 4.0, this function is related to the following feature:\n
+ *              %http://tizen.org/feature/content.scanning.others\n
+ *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  *
  * @param[in] path_array   The path array of the content files to add
  * @param[in] array_length The length of the array
@@ -113,6 +120,7 @@ int media_info_insert_to_db(const char *path, media_info_h *info);
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #MEDIA_CONTENT_ERROR_NOT_SUPPORTED     Not supported
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *
index 0df8db7..65519e7 100755 (executable)
@@ -104,6 +104,9 @@ int media_content_disconnect(void);
  *                   If you want to access only internal storage by using  this API, you should add privilege http://tizen.org/privilege/mediastorage. \n
  *                   Or if you want to access only external storage by using  this API, you should add privilege http://tizen.org/privilege/externalstorage. \n
  *                   If you can access both storage, you must add all privilege.
+ * @remarks Since 4.0, this function is related to the following feature:\n
+ *              %http://tizen.org/feature/content.scanning.others\n
+ *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  *
  * @param[in] path The file path
  *
@@ -116,6 +119,7 @@ int media_content_disconnect(void);
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED    DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY    DB Operation busy
+ * @retval #MEDIA_CONTENT_ERROR_NOT_SUPPORTED     Not supported
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  * @see media_content_connect()
index 8260902..cbee1ab 100755 (executable)
@@ -48,6 +48,9 @@ extern "C" {
  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief Enumeration for the media file format.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, #MEDIA_CONTENT_TYPE_OTHERS is related to the following feature:\n
+ *              %http://tizen.org/feature/content.scanning.others
+ *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  */
 typedef enum {
        MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
@@ -1155,6 +1158,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media file name pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
@@ -1163,6 +1169,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media title pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
@@ -1171,6 +1180,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media album pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
@@ -1179,6 +1191,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media artist pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
@@ -1187,6 +1202,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media album artist pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
@@ -1195,6 +1213,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media genre pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
@@ -1203,6 +1224,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media composer pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
@@ -1211,6 +1235,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media copyright pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
@@ -1219,6 +1246,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media description pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
@@ -1228,6 +1258,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media author pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"
@@ -1237,6 +1270,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media provider pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"
@@ -1246,6 +1282,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media content name pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"
@@ -1255,6 +1294,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media category pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"
@@ -1264,6 +1306,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media location tag pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"
@@ -1273,6 +1318,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media age rating pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"
@@ -1282,6 +1330,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Media keyword pinyin
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  *
  */
 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"
@@ -1336,6 +1387,9 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
  * @brief Folder base name pinyin
  * @details You can use above define to set the condition of folder filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @remarks Since 4.0, this keyword is related to the following feature:\n
+ *          - %http://tizen.org/feature/content.filter.pinyin\n
+ *            If this feature is not supported on the device, PINYIN search does not work.
  */
 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
 
index 2b1d66a..22b2e39 100755 (executable)
@@ -57,6 +57,9 @@ extern "C" {
  *                   If you want to access only internal storage by using  this API, you should add privilege http://tizen.org/privilege/mediastorage. \n
  *                   Or if you want to access only external storage by using  this API, you should add privilege http://tizen.org/privilege/externalstorage. \n
  *                   If you can access both storage, you must add all privilege.
+ * @remarks Since 4.0, this function is related to the following feature:\n
+ *              %http://tizen.org/feature/content.scanning.others\n
+ *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  *
  * @param[in]  path The path of the content file to add
  * @param[out] info The handle of the inserted content file
@@ -72,6 +75,7 @@ extern "C" {
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #MEDIA_CONTENT_ERROR_NOT_SUPPORTED     Not supported
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *
@@ -96,6 +100,9 @@ int media_info_insert_to_db(const char *path, media_info_h *info);
  *                   If you want to access only internal storage by using  this API, you should add privilege http://tizen.org/privilege/mediastorage. \n
  *                   Or if you want to access only external storage by using  this API, you should add privilege http://tizen.org/privilege/externalstorage. \n
  *                   If you can access both storage, you must add all privilege.
+ * @remarks Since 4.0, this function is related to the following feature:\n
+ *              %http://tizen.org/feature/content.scanning.others\n
+ *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  *
  * @param[in] path_array   The path array of the content files to add
  * @param[in] array_length The length of the array
@@ -113,6 +120,7 @@ int media_info_insert_to_db(const char *path, media_info_h *info);
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #MEDIA_CONTENT_ERROR_NOT_SUPPORTED     Not supported
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *