[ACR-441] Modify thumbnail creation policy

Change-Id: I4ef731dad3bb8a57ab3b4bc0e35d186699995b52
Signed-off-by: Minje Ahn <minje.ahn@samsung.com>

diff --git a/doc/media_content_doc.h b/doc/media_content_doc.h
index 58424c4..9c0b155 100755 (executable)
--- a/doc/media_content_doc.h
+++ b/doc/media_content_doc.h
@@ -31,9 +31,9 @@
  * The Media Content API provides functions and enumerations used in the entire Content Service.\n
  * The information about media items i.e. image, audio and video, are managed in the content database and
  * operations that involve database requires an active connection with the media content service.\n
- * During media scanning, Media Service extract media information automatically. media information include basic file info like 
- * path, size, modified time etc and some metadata like ID3tag, EXIF, thumbnail, face detection info, etc. (thumbnail extracted only in Internal and SD card storage. \n
- * Also, face detection only works when the device supports face recignition feature (i.e., http://tizen.org/feature/vision.face_recognition)). \n
+ * During media scanning, Media Service extract media information automatically. media information include basic file info like
+ * path, size, modified time etc and some metadata like ID3tag, EXIF, thumbnail, etc. (thumbnail extracted only in Internal and SD card storage.) \n
+ * Since 3.0, a thumbnail is not automatically extracted during media scanning. A thumbnail will be created only when media_info_create_thumbnail() is called by any application. \n
  * Media content services do not manage hidden files. \n
  * The API provides functions for connecting (#media_content_connect()) and disconnecting (#media_content_disconnect()) from the media content service.
  *

diff --git a/include/media_info.h b/include/media_info.h
index 1d3f1e3..ed97e86 100755 (executable)
--- a/include/media_info.h
+++ b/include/media_info.h
@@ -1569,14 +1569,17 @@ int media_info_move_to_db(media_info_h media, const char* dst_path);
 /**
  * @brief Creates a thumbnail image for the given media, asynchronously.
  * @details This function creates an thumbnail image for given media item and calls registered callback function for completion of creating the thumbnail.
- *          If a thumbnail already exists for the given media, then the path of thumbnail will be returned in callback function.
+ *          If a thumbnail already exists for the given media, then the path of thumbnail will be returned in callback function. \n
+ *          Since 3.0, a thumbnail is not automatically extracted during media scanning. \n
+ *          Therefore, if there exists no thumbnail for the given media, you MUST call this function to create a thumbnail.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
  * @privlevel public
  * @privilege %http://tizen.org/privilege/content.write
  *
- * @remarks If you want to destory media handle before callback invoked, you must cancel thumbnail request by using media_info_cancel_thumbnail()
+ * @remarks If you want to destory media handle before callback invoked, you must cancel thumbnail request by using media_info_cancel_thumbnail() \n
+ *          Since 3.0, if creation of a thumbnail is failed, empty string will be passed through media_thumbnail_completed_cb().
  *
  * @param[in] media     The media info handle
  * @param[in] callback  The callback function to be invoked