* Operations include: inserting a new storage in media to the media database, removing storage from database, \n
*/
-/**
- * @ingroup CAPI_MEDIA_CONTENT_MODULE
- * @brief Enumeration for a media storage scan status.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- */
-typedef enum {
- MEDIA_STORAGE_SCAN_NONE = 0, /**< Media Scanner not detect storage yet*/
- MEDIA_STORAGE_SCAN_PREPARE, /**< Media Scanner detect storage but not scanning yet*/
- MEDIA_STORAGE_SCAN_PROCESSING, /**< Media Scanner Start Scanning storage*/
- MEDIA_STORAGE_SCAN_STOP, /**< Media Scanner Stop Scanning storage. Not scanning items can be exist*/
- MEDIA_STORAGE_SCAN_DONE, /**< Scanning Done but need to extract metadata*/
- MEDIA_STORAGE_SCAN_META_PROCESSING, /**< Scanning Done and start to extract metadata*/
- MEDIA_STORAGE_SCAN_META_STOP, /**< Stop extract metadata*/
- MEDIA_STORAGE_SCAN_COMPLETE , /**< Complete scanning*/
-} media_storage_scan_status_e;
-
-/**
-* @internal
-* @brief Insert media storage to database.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @remarks You must release @a storage using media_storage_destroy().
-*
-* @privlevel platform
-* @privilege %http://tizen.org/privilege/content.write
-*
-* @param[in] storage_name The storage name to insert to database
-* @param[in] storage_path The storage path to insert to database
-* @param[in] storage_account The storage account to insert to database
-* @param[in] storage_type The storage type to insert to database
-* @param[out] storage The media storage handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @see media_storage_delete_from_db()
-*/
-int media_storage_insert_to_db(const char *storage_name, const char *storage_path, const char *storage_account, media_content_storage_e storage_type, media_storage_h *storage);
-
-/**
-* @internal
-* @brief Deletes the database for media storage.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @privlevel platform
-* @privilege %http://tizen.org/privilege/content.write
-*
-* @param[in] storage_id The storage ID to delete from database
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @see media_storage_insert_to_db()
-*/
-int media_storage_delete_from_db(const char *storage_id);
-
-/**
- * @brief Gets the storage account of media storage.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @remarks You must release @a storage_account using free().
- *
- * @param[in] storage The media storage handle
- * @param[out] storage_account The storage account of the media storage
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- */
-int media_storage_get_storage_account(media_storage_h storage, char **storage_account);
-
-/**
-* @internal
-* @brief Sets the MIME type of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] mime_type The MIME type of the media info
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_mime_type(media_info_h media, const char *mime_type);
-
-/**
-* @internal
-* @brief Sets the thumbnail path of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] thumbnail_path The thumbnail path of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_thumbnail_path(media_info_h media, const char *thumbnail_path);
-
-/**
-* @internal
-* @brief Sets the size of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] size The size of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_size(media_info_h media, unsigned long long size);
-
-/**
-* @internal
-* @brief Sets the modified time of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] modified_time The modified time of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_modified_time(media_info_h media, time_t modified_time);
-
-/**
-* @internal
-* @brief Sets the media type of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] type The media type of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_media_type(media_info_h media, media_content_type_e type);
-
-/**
-* @internal
-* @brief Sets the duration of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] duration The duration of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_duration(media_info_h media, int duration);
-
-/**
-* @internal
-* @brief Sets the width of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] width The width of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_width(media_info_h media, int width);
-
-/**
-* @internal
-* @brief Sets the height of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] height The height of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_height(media_info_h media, int height);
-
-/**
-* @internal
-* @brief Sets the storage type of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] storage_type The storage type of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_storage_type(media_info_h media, media_content_storage_e storage_type);
-
-/**
-* @internal
-* @brief Sets the storage type of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] storage_id The storage id of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_storage_id(media_info_h media, const char *storage_id);
-
-/**
- * @brief Gets the storage scan status of media storage.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @param[in] storage The media storage handle
- * @param[out] scan_status The storage type of the media storage
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int media_storage_get_scan_status(const char *storage_uuid, media_storage_scan_status_e *scan_status);
-
-/**
- * @brief Subscribes notifications of the media DB change.
- * @details This function subscribes notifications of the media DB change which are published by the media server or other apps.
- * media_content_db_update_cb() function will be called when notification of the media DB change is subscribed.
- *
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @param[in] callback The callback to be invoked when the scanning is finished
- * @param[in] user_data The user data to be passed to the callback function
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @see media_content_db_update_cb()
- * @see media_content_unset_db_updated_cb_v2()
- */
-int media_content_set_db_updated_cb_v2(media_content_noti_h *noti_handle, media_content_db_update_cb callback, void *user_data);
-
-
-/**
- * @brief Unsubscribes notifications of the media DB change.
- * @details This function unsubscribes notifications of the media DB change which are published by the media server or other apps.
- *
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @pre media_content_set_db_updated_cb_v2()
- *
- * @see media_content_set_db_updated_cb_v2()
- */
-int media_content_unset_db_updated_cb_v2(media_content_noti_h noti_handle);
-
-
#ifdef __cplusplus
}
#endif /* __cplusplus */
*/
/**
-* @internal
-* @brief Insert media storage to database.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @remarks You must release @a storage using media_storage_destroy().
-*
-* @privlevel platform
-* @privilege %http://tizen.org/privilege/content.write
-*
-* @param[in] storage_name The storage name to insert to database
-* @param[in] storage_path The storage path to insert to database
-* @param[in] storage_account The storage account to insert to database
-* @param[in] storage_type The storage type to insert to database
-* @param[out] storage The media storage handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @see media_storage_delete_from_db()
-*/
-int media_storage_insert_to_db(const char *storage_name, const char *storage_path, const char *storage_account, media_content_storage_e storage_type, media_storage_h *storage);
-
-/**
-* @internal
-* @brief Deletes the database for media storage.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @privlevel platform
-* @privilege %http://tizen.org/privilege/content.write
-*
-* @param[in] storage_id The storage ID to delete from database
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @see media_storage_insert_to_db()
-*/
-int media_storage_delete_from_db(const char *storage_id);
-
-/**
- * @brief Gets the storage account of media storage.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @remarks You must release @a storage_account using free().
- *
- * @param[in] storage The media storage handle
- * @param[out] storage_account The storage account of the media storage
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- */
-int media_storage_get_storage_account(media_storage_h storage, char **storage_account);
-
-/**
-* @internal
-* @brief Sets the MIME type of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] mime_type The MIME type of the media info
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_mime_type(media_info_h media, const char *mime_type);
-
-/**
-* @internal
-* @brief Sets the thumbnail path of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] thumbnail_path The thumbnail path of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_thumbnail_path(media_info_h media, const char *thumbnail_path);
-
-/**
-* @internal
-* @brief Sets the size of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] size The size of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_size(media_info_h media, unsigned long long size);
-
-/**
-* @internal
-* @brief Sets the modified time of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] modified_time The modified time of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_modified_time(media_info_h media, time_t modified_time);
-
-/**
-* @internal
-* @brief Sets the media type of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] type The media type of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_media_type(media_info_h media, media_content_type_e type);
-
-/**
-* @internal
-* @brief Sets the duration of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] duration The duration of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_duration(media_info_h media, int duration);
-
-/**
-* @internal
-* @brief Sets the width of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] width The width of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_width(media_info_h media, int width);
-
-/**
-* @internal
-* @brief Sets the height of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] height The height of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_height(media_info_h media, int height);
-
-/**
-* @internal
-* @brief Sets the storage type of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] storage_type The storage type of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_storage_type(media_info_h media, media_content_storage_e storage_type);
-
-/**
-* @internal
-* @brief Sets the storage type of media info handle.
-* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-*
-* @param[in] media The media info handle
-* @param[in] storage_id The storage id of media info handle
-*
-* @return @c 0 on success,
-* otherwise a negative error value
-*
-* @retval #MEDIA_CONTENT_ERROR_NONE Successful
-* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
-* @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB operation failed
-* @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
-*
-* @post media_info_insert_to_db_with_data()
-*/
-int media_info_set_storage_id(media_info_h media, const char *storage_id);
-
-/**
* @brief Gets the storage scan status of media storage.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
*
*/
int media_storage_get_scan_status(const char *storage_uuid, media_storage_scan_status_e *scan_status);
-/**
- * @brief Subscribes notifications of the media DB change.
- * @details This function subscribes notifications of the media DB change which are published by the media server or other apps.
- * media_content_db_update_cb() function will be called when notification of the media DB change is subscribed.
- *
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @param[in] callback The callback to be invoked when the scanning is finished
- * @param[in] user_data The user data to be passed to the callback function
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @see media_content_db_update_cb()
- * @see media_content_unset_db_updated_cb_v2()
- */
-int media_content_set_db_updated_cb_v2(media_content_noti_h *noti_handle, media_content_db_update_cb callback, void *user_data);
-
-
-/**
- * @brief Unsubscribes notifications of the media DB change.
- * @details This function unsubscribes notifications of the media DB change which are published by the media server or other apps.
- *
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @pre media_content_set_db_updated_cb_v2()
- *
- * @see media_content_set_db_updated_cb_v2()
- */
-int media_content_unset_db_updated_cb_v2(media_content_noti_h noti_handle);
-
typedef enum {
MEDIA_CONTENT_SCAN_PARTIAL_COMPLETE = 2,
MEDIA_CONTENT_SCAN_COMPLETE = 3,
#define MEDIA_CONTENT_THUMB_DEFAULT_PATH tzplatform_mkpath(TZ_USER_SHARE, "media/.thumb/thumb_default.png")
#define MEDIA_CONTENT_INSERT_FILES_PATH "/tmp"
+#define MEDIA_CONTENT_EMPTY_STRING ""
#define MAX_QUERY_SIZE 4096
+#define MAX_PATH_LEN 4096
#define DEFAULT_QUERY_SIZE 1024
#define COLLATE_STR_SIZE 32
#define MEDIA_CONTENT_UUID_SIZE 36
} while (0)
#define media_content_sec_debug(fmt, arg...) do { \
- SECURE_LOGD(FONT_COLOR_RESET"[%d]"fmt"", media_content_gettid(), ##arg); \
+ SECURE_LOGD(FONT_COLOR_CYAN"[%d]"fmt""FONT_COLOR_RESET, media_content_gettid(), ##arg); \
} while (0)
#define media_content_sec_warn(fmt, arg...) do { \
- SECURE_LOGW(FONT_COLOR_GREEN"[%d]"fmt""FONT_COLOR_RESET, media_content_gettid(), ##arg); \
+ SECURE_LOGW(FONT_COLOR_RED"[%d]"fmt""FONT_COLOR_RESET, media_content_gettid(), ##arg); \
} while (0)
#define media_content_sec_error(fmt, arg...) do { \
/**
* @file media_storage.h
- * @brief This file contains API on main functional operations with storage that are related to media resources in the media database. \n
+ * @brief This file contains API on main functional operations with external storage that are related to media resources in the media database. \n
* Operations include: getting number of storages, cloning and destroying storage, getting storage`s ID, name, path and type.
*/
int video_meta_get_copyright(video_meta_h video, char **copyright);
/**
- * @brief Gets the track number of the given videoo metadata.
+ * @brief Gets the track number of the given video metadata.
* @details If the value is an empty string, the method returns "Unknown". \n
* Since 3.0, if the media content has no track info, the method returns empty string.
*
int video_meta_get_bit_rate(video_meta_h video, int *bit_rate);
/**
- * @brief Gets the track duration of the given videoo metadata.
+ * @brief Gets the track duration of the given video metadata.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*
* @param[in] video The video metadata handle
int video_meta_get_duration(video_meta_h video, int *duration);
/**
- * @brief Gets the width of the given videoo metadata.
+ * @brief Gets the width of the given video metadata.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*
* @param[in] video The video metadata handle
int video_meta_get_width(video_meta_h video, int *width);
/**
- * @brief Gets the height of the given videoo metadata.
+ * @brief Gets the height of the given video metadata.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*
* @param[in] video The video metadata handle
SAFE_FREE(genre);
SAFE_FREE(recorded_date);
- if (_media->storage_type == MEDIA_CONTENT_STORAGE_CLOUD) {
- set_sql = NULL;
- sql = NULL;
-
- if (_media->media_type == MEDIA_CONTENT_TYPE_VIDEO) {
- set_sql = sqlite3_mprintf("title=%Q, album=%Q, artist=%Q, genre=%Q, duration=%d, width=%d, height=%d", \
- _media->title, _media->video_meta->album, _media->video_meta->artist, _media->video_meta->genre, _media->video_meta->duration, _media->video_meta->width, _media->video_meta->height);
- } else if ((_media->media_type == MEDIA_CONTENT_TYPE_MUSIC) || (_media->media_type == MEDIA_CONTENT_TYPE_SOUND)) {
- set_sql = sqlite3_mprintf("title=%Q, album=%Q, artist=%Q, genre=%Q, duration=%d", \
- _media->title, _media->audio_meta->album, _media->audio_meta->artist, _media->audio_meta->genre, _media->audio_meta->duration);
- } else if (_media->media_type == MEDIA_CONTENT_TYPE_IMAGE) {
- set_sql = sqlite3_mprintf("title=%Q, width=%d, height=%d", _media->title, _media->image_meta->width, _media->image_meta->height);
- } else {
- set_sql = sqlite3_mprintf("title=%Q", _media->title);
- }
-
- sql = sqlite3_mprintf("UPDATE %Q SET %s WHERE media_uuid=%Q", _media->storage_uuid, set_sql, _media->media_id);
-
- ret = _content_query_sql(sql);
-
- SQLITE3_SAFE_FREE(set_sql);
- SQLITE3_SAFE_FREE(sql);
- }
-
if (ret == MEDIA_CONTENT_ERROR_NONE) {
/* Send notification for this update */
media_content_debug("Update is successfull. Send notification for this");
return ret;
}
- if (storage_type == MEDIA_CONTENT_STORAGE_CLOUD) {
- media_info_destroy(media);
- media_content_error("Can't refresh cloud content!!");
- return MEDIA_CONTENT_ERROR_INVALID_PARAMETER;
- }
-
ret = media_info_get_file_path(media, &file_path);
if (ret != MEDIA_CONTENT_ERROR_NONE) {
media_info_destroy(media);
svc_content_info->media_meta.genre = g_strdup(media->audio_meta->genre);
svc_content_info->media_meta.recorded_date = g_strdup(media->audio_meta->recorded_date);
- if (storage_type == MEDIA_CONTENT_STORAGE_CLOUD) {
- switch (media->media_type) {
- case MEDIA_CONTENT_TYPE_IMAGE:
- svc_content_info->media_meta.width = media->image_meta->width;
- svc_content_info->media_meta.height = media->image_meta->height;
- svc_content_info->media_meta.datetaken = g_strdup(media->image_meta->date_taken);
- svc_content_info->media_meta.orientation = media->image_meta->orientation;
- break;
- case MEDIA_CONTENT_TYPE_VIDEO:
- svc_content_info->media_meta.album_artist = g_strdup(media->audio_meta->album_artist);
- svc_content_info->media_meta.composer = g_strdup(media->audio_meta->composer);
- svc_content_info->media_meta.year = g_strdup(media->audio_meta->year);
- svc_content_info->media_meta.copyright = g_strdup(media->audio_meta->copyright);
- svc_content_info->media_meta.track_num = g_strdup(media->audio_meta->track_num);
- svc_content_info->media_meta.bitrate = media->audio_meta->bitrate;
- svc_content_info->media_meta.duration = media->audio_meta->duration;
- svc_content_info->media_meta.width = media->image_meta->width;
- svc_content_info->media_meta.height = media->image_meta->height;
- break;
- case MEDIA_CONTENT_TYPE_SOUND:
- case MEDIA_CONTENT_TYPE_MUSIC:
- svc_content_info->media_meta.album_artist = g_strdup(media->audio_meta->album_artist);
- svc_content_info->media_meta.composer = g_strdup(media->audio_meta->composer);
- svc_content_info->media_meta.year = g_strdup(media->audio_meta->year);
- svc_content_info->media_meta.copyright = g_strdup(media->audio_meta->copyright);
- svc_content_info->media_meta.track_num = g_strdup(media->audio_meta->track_num);
- svc_content_info->media_meta.bitrate = media->audio_meta->bitrate;
- svc_content_info->media_meta.duration = media->audio_meta->duration;
- svc_content_info->media_meta.channel = media->audio_meta->channel;
- svc_content_info->media_meta.samplerate = media->audio_meta->samplerate;
- break;
- case MEDIA_CONTENT_TYPE_OTHERS:
- default:
- break;
- }
- }
-
*service_content = svc_content_info;
return MEDIA_CONTENT_ERROR_NONE;
media_content_retvm_if(!STRING_VALID(_media->storage_uuid), MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid storage_uuid");
media_content_retvm_if(_media->storage_type < 0, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid storage_type [%d]", _media->storage_type);
- /* Cloud Item should be filled whole info*/
- if (_media->storage_type == MEDIA_CONTENT_STORAGE_CLOUD) {
- media_content_retvm_if(!STRING_VALID(_media->mime_type), MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid mime_type");
- media_content_retvm_if(!STRING_VALID(_media->title), MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid title");
- media_content_retvm_if(_media->size <= 0, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid size [%d]", _media->size);
- media_content_retvm_if(_media->modified_time <= 0, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid modified_time [%d]", _media->modified_time);
-
- if ((_media->media_type < MEDIA_CONTENT_TYPE_IMAGE) || (_media->media_type > MEDIA_CONTENT_TYPE_OTHERS)) {
- media_content_error("invalid media type [%d]", _media->media_type);
- return MEDIA_CONTENT_ERROR_INVALID_PARAMETER;
- }
- }
-
media_content_sec_debug("storage[%d], path[%s], media_type[%d]", _media->storage_type, _media->file_path, _media->media_type);
media_svc_content_info_s *svc_content_info = NULL;
memset(storage_id, 0x00, sizeof(storage_id));
- if (STRING_VALID(MEDIA_ROOT_PATH_CLOUD) && (strstr(repl_path, MEDIA_ROOT_PATH_CLOUD) == NULL)) {
- bool ignore_dir = FALSE;
- char *folder_path = NULL;
+ bool ignore_dir = FALSE;
+ char *folder_path = NULL;
- ret = _media_util_check_file_exist(repl_path);
- media_content_retv_if(ret != MEDIA_CONTENT_ERROR_NONE, ret);
+ ret = _media_util_check_file_exist(repl_path);
+ media_content_retv_if(ret != MEDIA_CONTENT_ERROR_NONE, ret);
- folder_path = g_path_get_dirname(repl_path);
- ret = _media_util_check_ignore_dir(folder_path, &ignore_dir);
- SAFE_FREE(folder_path);
- media_content_retvm_if(ignore_dir == TRUE, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid folder path");
+ folder_path = g_path_get_dirname(repl_path);
+ ret = _media_util_check_ignore_dir(folder_path, &ignore_dir);
+ SAFE_FREE(folder_path);
+ media_content_retvm_if(ignore_dir == TRUE, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid folder path");
- ret = media_svc_get_storage_id(_content_get_db_handle(), repl_path, storage_id, tzplatform_getuid(TZ_USER_NAME));
- if (ret != MS_MEDIA_ERR_NONE) {
- media_content_error("media_svc_get_storage_id failed : %d", ret);
- return _content_error_capi(MEDIA_CONTENT_TYPE, ret);
- }
+ ret = media_svc_get_storage_id(_content_get_db_handle(), repl_path, storage_id, tzplatform_getuid(TZ_USER_NAME));
+ if (ret != MS_MEDIA_ERR_NONE) {
+ media_content_error("media_svc_get_storage_id failed : %d", ret);
+ return _content_error_capi(MEDIA_CONTENT_TYPE, ret);
+ }
- ret = media_svc_get_storage_type(repl_path, &storage_type, tzplatform_getuid(TZ_USER_NAME));
- if (ret != MS_MEDIA_ERR_NONE) {
- media_content_sec_error("media_svc_get_storage_type failed : %d", ret);
- return _content_error_capi(MEDIA_CONTENT_TYPE, ret);
- }
+ ret = media_svc_get_storage_type(repl_path, &storage_type, tzplatform_getuid(TZ_USER_NAME));
+ if (ret != MS_MEDIA_ERR_NONE) {
+ media_content_sec_error("media_svc_get_storage_type failed : %d", ret);
+ return _content_error_capi(MEDIA_CONTENT_TYPE, ret);
}
media_info_s *_media = (media_info_s*)calloc(1, sizeof(media_info_s));
return ret;
}
-int media_info_set_mime_type(media_info_h media, const char *mime_type)
-{
- return __media_info_set_str_data(media, MEDIA_INFO_MIME_TYPE, mime_type);
-}
-
int media_info_set_title(media_info_h media, const char *title)
{
return __media_info_set_str_data(media, MEDIA_INFO_TITLE, title);
return __media_info_set_str_data(media, MEDIA_INFO_RECORDED_DATE, recorded_date);
}
-int media_info_set_thumbnail_path(media_info_h media, const char *thumbnail_path)
-{
- return __media_info_set_str_data(media, MEDIA_INFO_THUMBNAIL_PATH, thumbnail_path);
-}
-
-int media_info_set_storage_id(media_info_h media, const char *storage_id)
-{
- return __media_info_set_str_data(media, MEDIA_INFO_STORAGE_UUID, storage_id);
-}
-
-int media_info_set_size(media_info_h media, unsigned long long size)
-{
- media_info_s *_media = (media_info_s*)media;
-
- media_content_retvm_if(_media == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid media");
-
- _media->size = size;
-
- return MEDIA_CONTENT_ERROR_NONE;
-}
-
-int media_info_set_modified_time(media_info_h media, time_t modified_time)
-{
- media_info_s *_media = (media_info_s*)media;
-
- media_content_retvm_if(_media == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid media");
-
- _media->modified_time = modified_time;
-
- return MEDIA_CONTENT_ERROR_NONE;
-}
-
-int media_info_set_media_type(media_info_h media, media_content_type_e type)
-{
- media_info_s *_media = (media_info_s*)media;
-
- media_content_retvm_if(_media == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid media");
-
- _media->media_type = type;
-
- return MEDIA_CONTENT_ERROR_NONE;
-}
-
-int media_info_set_duration(media_info_h media, int duration)
-{
- media_info_s *_media = (media_info_s*)media;
-
- media_content_retvm_if(_media == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid media");
-
- if (_media->media_type == MEDIA_CONTENT_TYPE_VIDEO)
- _media->video_meta->duration = duration;
- else if ((_media->media_type == MEDIA_CONTENT_TYPE_MUSIC) || (_media->media_type == MEDIA_CONTENT_TYPE_SOUND))
- _media->audio_meta->duration = duration;
- else {
- media_content_error("Invalid media type");
- return MEDIA_CONTENT_ERROR_INVALID_PARAMETER;
- }
-
- return MEDIA_CONTENT_ERROR_NONE;
-}
-
-int media_info_set_width(media_info_h media, int width)
-{
- media_info_s *_media = (media_info_s*)media;
-
- media_content_retvm_if(_media == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid media");
-
- if (_media->media_type == MEDIA_CONTENT_TYPE_VIDEO)
- _media->video_meta->width = width;
- else if (_media->media_type == MEDIA_CONTENT_TYPE_IMAGE)
- _media->image_meta->width = width;
- else {
- media_content_error("Invalid media type");
- return MEDIA_CONTENT_ERROR_INVALID_PARAMETER;
- }
-
- return MEDIA_CONTENT_ERROR_NONE;
-}
-
-int media_info_set_height(media_info_h media, int height)
-{
- media_info_s *_media = (media_info_s*)media;
-
- media_content_retvm_if(_media == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid media");
-
- if (_media->media_type == MEDIA_CONTENT_TYPE_VIDEO)
- _media->video_meta->height = height;
- else if (_media->media_type == MEDIA_CONTENT_TYPE_IMAGE)
- _media->image_meta->height = height;
- else {
- media_content_error("Invalid media type");
- return MEDIA_CONTENT_ERROR_INVALID_PARAMETER;
- }
-
- return MEDIA_CONTENT_ERROR_NONE;
-}
-
-int media_info_set_storage_type(media_info_h media, media_content_storage_e storage_type)
-{
- media_info_s *_media = (media_info_s*)media;
-
- media_content_retvm_if(_media == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid media");
-
- _media->storage_type = storage_type;
-
- return MEDIA_CONTENT_ERROR_NONE;
-}
-
#ifdef _USE_SENIOR_MODE
int media_info_set_contact(media_info_h media, const char *contact)
{
return;
}
-int media_storage_insert_to_db(const char *storage_name, const char *storage_path, const char *storage_account, media_content_storage_e storage_type, media_storage_h *storage)
-{
- int ret = MEDIA_CONTENT_ERROR_NONE;
- char *storage_uuid = NULL;
- media_storage_s *_storage = NULL;
-
- media_content_retvm_if(!STRING_VALID(storage_name), MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "invalid storage_name");
- media_content_retvm_if(!STRING_VALID(storage_path), MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "invalid storage_path");
-
- ret = media_svc_generate_uuid(&storage_uuid);
- media_content_retvm_if(ret != MS_MEDIA_ERR_NONE, MEDIA_CONTENT_ERROR_INVALID_OPERATION, "Fail to get storage_id");
- media_content_retvm_if(storage_uuid == NULL, MEDIA_CONTENT_ERROR_INVALID_OPERATION, "Invalid storage_id");
-
- ret = media_svc_insert_storage(_content_get_db_handle(), storage_uuid, storage_name, storage_path, storage_account, storage_type, tzplatform_getuid(TZ_USER_NAME));
- if (ret != MS_MEDIA_ERR_NONE) {
- ret = _content_error_capi(MEDIA_CONTENT_TYPE, ret);
- SAFE_FREE(storage_uuid);
- return ret;
- }
-
- _storage = (media_storage_s*)calloc(1, sizeof(media_storage_s));
- media_content_retvm_if(_storage == NULL, MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, "OUT_OF_MEMORY");
-
- _storage->storage_id = strdup(storage_uuid);
- _storage->storage_path = strdup(storage_path);
- _storage->storage_name = strdup(storage_name);
- _storage->storage_type = storage_type;
-
- *storage = (media_storage_h)_storage;
-
- SAFE_FREE(storage_uuid);
-
- return ret;
-}
-
-int media_storage_delete_from_db(const char *storage_id)
-{
- int ret = MEDIA_CONTENT_ERROR_NONE;
-
- if (!STRING_VALID(storage_id)) {
- media_content_error("Invalid Storage ID");
- return MEDIA_CONTENT_ERROR_INVALID_PARAMETER;
- }
-
- ret = media_svc_delete_storage(_content_get_db_handle(), storage_id, NULL, tzplatform_getuid(TZ_USER_NAME));
-
- return _content_error_capi(MEDIA_CONTENT_TYPE, ret);
-}
-
int media_storage_get_storage_info_from_db(const char *storage_id, media_storage_h *storage)
{
int ret = MEDIA_CONTENT_ERROR_NONE;
return ret;
}
-int media_storage_get_storage_account(media_storage_h storage, char **storage_account)
-{
- int ret = MEDIA_CONTENT_ERROR_NONE;
- media_storage_s *_storage = (media_storage_s*)storage;
-
- if (_storage && storage_account) {
- if (STRING_VALID(_storage->storage_account)) {
- *storage_account = strdup(_storage->storage_account);
- media_content_retvm_if(*storage_account == NULL, MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, "OUT_OF_MEMORY");
- } else {
- *storage_account = NULL;
- }
-
- ret = MEDIA_CONTENT_ERROR_NONE;
- } else {
- media_content_error("INVALID_PARAMETER(0x%08x)", MEDIA_CONTENT_ERROR_INVALID_PARAMETER);
- ret = MEDIA_CONTENT_ERROR_INVALID_PARAMETER;
- }
-
- return ret;
-}
-
int media_storage_get_type(media_storage_h storage, media_content_storage_e *storage_type)
{
int ret = MEDIA_CONTENT_ERROR_NONE;
return ret;
}
+#ifdef _USE_TV_PROFILE
int media_storage_get_scan_status(const char *storage_uuid, media_storage_scan_status_e *scan_status)
{
int ret = MEDIA_CONTENT_ERROR_NONE;
return ret;
}
+#endif
projects / platform / core / api / media-content.git / commitdiff