X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=include%2Fmedia-svc.h;h=372e3b2904ddf6444ad671010cd620219fbcfe17;hb=9a61bb765fa184969253f34b0ccea9da2179407d;hp=ace33667a63451ee53f3868907ab7dafadfce933;hpb=1c6f7e60ed7b2ac21cb63f066406664c9b758397;p=platform%2Fcore%2Fmultimedia%2Flibmedia-service.git diff --git a/include/media-svc.h b/include/media-svc.h index ace3366..372e3b2 100755 --- a/include/media-svc.h +++ b/include/media-svc.h @@ -25,223 +25,79 @@ #define _MEDIA_SVC_H_ #include "media-svc-types.h" -#include "media-svc-error.h" +#include +#include +#include #ifdef __cplusplus extern "C" { #endif -/** - @defgroup MEDIA_SVC Media Information Service - @{ - * @file media-svc.h - * @brief This file defines API's for media service. - * @version 1.0 - */ - -/** - @defgroup MEDIA_SVC_API Media Database API - @{ - - @par - manage the service database. - */ - - -/** - * media_svc_connect: - * Connect to the media database. This is the function that an user who wants to get a handle to access the media database. - * - * @param handle [out] Handle to access database. - * @return This function returns zero(MEDIA_INFO_ERROR_NONE) on success, or negative value with error code. - * Please refer 'media-info-error.h' to know the exact meaning of the error. - * @see media_svc_disconnect - * @pre None - * @post call media_svc_disconnect to disconnect media database. - * @remark The database name is "/opt/usr/dbspace/.media.db". - * @par example - * @code - -#include - -void connect_media_db() -{ - int ret = MEDIA_INFO_ERROR_NONE; - MediaSvcHandle* my_handle = NULL; - - // connect to the media database - ret = media_svc_connect(&my_handle); - - if (ret < 0) - { - printf("Fatal error to connect DB\n"); - return; - } - - return; -} - - * @endcode - */ -int media_svc_connect(MediaSvcHandle **handle,uid_t uid); - - -/** - * media_svc_disconnect: - * Disconnect to the media database. This is the function that an user who wants to disconnect the media database. - * - * @param handle [in] Handle to access database. - * @return This function returns zero(MEDIA_INFO_ERROR_NONE) on success, or negative value with error code. - * Please refer 'media-info-error.h' to know the exact meaning of the error. - * @see media_svc_connect - * @pre call media_svc_connect to connect media database. - * @post None - * @remark The database name is "/opt/usr/dbspace/.media.db". - * @par example - * @code - -#include - -void disconnect_media_db() -{ - int ret = MEDIA_INFO_ERROR_NONE; - MediaSvcHandle* my_handle = NULL; - - // connect to the media database - ret = media_svc_connect(&my_handle); - - if (ret < 0) - { - printf("Fatal error to connect DB\n"); - return; - } - - // - // Do something using my_handle - // - - - ret = media_svc_disconnect(my_handle); - if (ret < 0) - { - printf("Fatal error to disconnect DB\n"); - } - - return; -} - - * @endcode - */ +int media_svc_connect(MediaSvcHandle **handle, uid_t uid, bool need_write); int media_svc_disconnect(MediaSvcHandle *handle); - - -/** - * media_svc_create_table: - * Create table of media database and set Index and Triggers. - * - * @param handle [in] Handle to access database. - * @return This function returns zero(MEDIA_INFO_ERROR_NONE) on success, or negative value with error code. - * Please refer 'media-info-error.h' to know the exact meaning of the error. - * @see None - * @pre call media_svc_connect to connect media database. - * @post call media_svc_disconnect to disconnect media database. - * @remark The database name is "/opt/usr/dbspace/.media.db". - * @par example - * @code - -#include - -void create_media_db_table() -{ - int ret = MEDIA_INFO_ERROR_NONE; - MediaSvcHandle* my_handle = NULL; - - // connect to the media database - ret = media_svc_connect(&my_handle); - - if (ret < 0) - { - printf("Fatal error to connect DB\n"); - return; - } - - ret = media_svc_create_table(my_handle); - if (ret < 0) - { - printf("Fatal error to create DB table\n"); - } - - ret = media_svc_disconnect(my_handle); - if (ret < 0) - { - printf("Fatal error to disconnect DB\n"); - } - - return; -} - - * @endcode - */ - int media_svc_create_table(MediaSvcHandle *handle, uid_t uid); - -int media_svc_check_item_exist_by_path(MediaSvcHandle *handle, const char *path); - -int media_svc_insert_folder(MediaSvcHandle *handle, media_svc_storage_type_e storage_type, const char *path, uid_t uid); - +int media_svc_check_item_exist_by_path(MediaSvcHandle *handle, const char *storage_id, const char *path); +int media_svc_insert_folder(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, const char *path, uid_t uid); int media_svc_insert_item_begin(MediaSvcHandle *handle, int with_noti, int data_cnt, int from_pid); - int media_svc_insert_item_end(MediaSvcHandle *handle, uid_t uid); - -int media_svc_insert_item_bulk(MediaSvcHandle *handle, media_svc_storage_type_e storage_type, const char *path, int is_burst, uid_t uid); - -int media_svc_insert_item_immediately(MediaSvcHandle *handle, media_svc_storage_type_e storage_type, const char *path, uid_t uid); - -int media_svc_move_item_begin(MediaSvcHandle *handle, int data_cnt); - -int media_svc_move_item_end(MediaSvcHandle *handle, uid_t uid); - -int media_svc_move_item(MediaSvcHandle *handle, media_svc_storage_type_e src_storage, const char *src_path, media_svc_storage_type_e dest_storage, const char *dest_path, uid_t uid); - +int media_svc_insert_item_bulk(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, const char *path, int is_burst, uid_t uid); +int media_svc_insert_item_immediately(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, const char *path, uid_t uid); +int media_svc_move_item(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e src_storage, const char *src_path, media_svc_storage_type_e dest_storage, const char *dest_path, uid_t uid); int media_svc_set_item_validity_begin(MediaSvcHandle *handle, int data_cnt); - int media_svc_set_item_validity_end(MediaSvcHandle *handle, uid_t uid); - -int media_svc_set_item_validity(MediaSvcHandle *handle, const char *path, int validity, uid_t uid); - -int media_svc_delete_item_by_path(MediaSvcHandle *handle, const char *path, uid_t uid); - -int media_svc_delete_all_items_in_storage(MediaSvcHandle *handle, media_svc_storage_type_e storage_type, uid_t uid); - -int media_svc_delete_invalid_items_in_storage(MediaSvcHandle *handle, media_svc_storage_type_e storage_type, uid_t uid); - -int media_svc_delete_invalid_items_in_folder(MediaSvcHandle *handle, const char *folder_path, uid_t uid); - -int media_svc_set_all_storage_items_validity(MediaSvcHandle *handle, media_svc_storage_type_e storage_type, int validity, uid_t uid); - -int media_svc_set_folder_items_validity(MediaSvcHandle *handle, const char *folder_path, int validity, int recursive, uid_t uid); - -int media_svc_refresh_item(MediaSvcHandle *handle, media_svc_storage_type_e storage_type, const char *path, uid_t uid); - -int media_svc_rename_folder(MediaSvcHandle *handle, const char *src_path, const char *dst_path, uid_t uid); - +int media_svc_set_item_validity(MediaSvcHandle *handle, const char *storage_id, const char *path, int validity, uid_t uid); +int media_svc_delete_item_by_path(MediaSvcHandle *handle, const char *storage_id, const char *path, uid_t uid); +int media_svc_delete_all_items_in_storage(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, uid_t uid); +int media_svc_delete_invalid_items_in_storage(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, uid_t uid); +int media_svc_delete_invalid_items_in_folder(MediaSvcHandle *handle, const char *storage_id, const char *folder_path, bool is_recursive, uid_t uid); +int media_svc_set_all_storage_items_validity(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, int validity, uid_t uid); +int media_svc_set_folder_items_validity(MediaSvcHandle *handle, const char *storage_id, const char *folder_path, int validity, int recursive, uid_t uid); +int media_svc_refresh_item(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, const char *path, uid_t uid); +int media_svc_rename_folder(MediaSvcHandle *handle, const char *storage_id, const char *src_path, const char *dst_path, uid_t uid); int media_svc_request_update_db(const char *db_query, uid_t uid); +int media_svc_get_storage_type(const char *path, media_svc_storage_type_e *storage_type, uid_t uid); +int media_svc_get_file_info(MediaSvcHandle *handle, const char *storage_id, const char *path, time_t *modified_time, unsigned long long *size); +int media_svc_send_dir_update_noti(MediaSvcHandle *handle, const char *storage_id, const char *dir_path, const char *folder_id, media_item_update_type_e update_type, int pid); +int media_svc_count_invalid_items_in_folder(MediaSvcHandle *handle, const char *storage_id, const char *folder_path, int *count); +int media_svc_check_db_upgrade(MediaSvcHandle *handle, bool *need_full_scan, uid_t uid); +int media_svc_check_db_corrupt(MediaSvcHandle *handle); +int media_svc_get_folder_list(MediaSvcHandle *handle, char *start_path, char ***folder_list, time_t **modified_time_list, int **item_num_list, int *count); +int media_svc_update_folder_time(MediaSvcHandle *handle, const char *storage_id, const char *folder_path, uid_t uid); +int media_svc_publish_noti(MediaSvcHandle *handle, media_item_type_e update_item, media_item_update_type_e update_type, const char *path, media_type_e media_type, const char *uuid, const char *mime_type); +int media_svc_get_pinyin(MediaSvcHandle *handle, const char *src_str, char **pinyin_str); +int media_svc_check_pinyin_support(bool *support); +int media_svc_update_item_begin(MediaSvcHandle *handle, int data_cnt); +int media_svc_update_item_end(MediaSvcHandle *handle, uid_t uid); +int media_svc_update_item_meta(MediaSvcHandle *handle, const char *file_path, int storage_type, uid_t uid); +int media_svc_insert_item_immediately_with_data(MediaSvcHandle *handle, media_svc_content_info_s *content_info, uid_t uid); +void media_svc_destroy_content_info(media_svc_content_info_s *content_info); + +int media_svc_generate_uuid(char **uuid); +int media_svc_get_mmc_info(MediaSvcHandle *handle, char **storage_name, char **storage_path, int *validity, bool *info_exist); +int media_svc_check_storage(MediaSvcHandle *handle, const char *storage_id, const char *storage_name, char **storage_path, int *validity); +int media_svc_insert_storage(MediaSvcHandle *handle, const char *storage_id, const char *storage_name, const char *storage_path, const char *storage_account, media_svc_storage_type_e storage_type, uid_t uid); +int media_svc_update_storage(MediaSvcHandle *handle, const char *storage_id, const char *storage_path, uid_t uid); +int media_svc_delete_storage(MediaSvcHandle *handle, const char *storage_id, const char *storage_name, uid_t uid); +int media_svc_set_storage_validity(MediaSvcHandle *handle, const char *storage_id, int validity, uid_t uid); +int media_svc_get_storage_id(MediaSvcHandle *handle, const char *path, char *storage_id); +int media_svc_get_storage_path(MediaSvcHandle *handle, const char *storage_uuid, char **storage_path); +int media_svc_get_storage_scan_status(MediaSvcHandle *handle, const char *storage_uuid, media_svc_scan_status_type_e *storage_status); +int media_svc_set_storage_scan_status(MediaSvcHandle *handle, const char *storage_uuid, media_svc_scan_status_type_e storage_status, uid_t uid); +int media_svc_get_storage_list(MediaSvcHandle *handle, char ***storage_list, char ***storage_id_list, int **scan_status_list, int *count); +int media_svc_delete_invalid_folder(MediaSvcHandle *handle, const char *storage_id, uid_t uid); +int media_svc_set_folder_validity(MediaSvcHandle *handle, const char *storage_id, const char *start_path, int validity, bool is_recursive, uid_t uid); + +int media_svc_insert_item_pass1(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, const char *path, int is_burst, uid_t uid); +int media_svc_insert_item_pass2(MediaSvcHandle *handle, const char *storage_id, media_svc_storage_type_e storage_type, int scan_type, const char* extract_path, int is_burst, uid_t uid); + +int media_svc_insert_folder_begin(MediaSvcHandle *handle, int data_cnt); +int media_svc_insert_folder_end(MediaSvcHandle *handle, uid_t uid); + +int media_svc_delete_invalid_folder_by_path(MediaSvcHandle *handle, const char *storage_id, const char *folder_path, uid_t uid, int *delete_count); +int media_svc_check_folder_exist_by_path(MediaSvcHandle *handle, const char *storage_id, const char *folder_path); +int media_svc_check_subfolder_by_path(MediaSvcHandle *handle, const char *storage_id, const char *folder_path, int *count); +int media_svc_get_folder_id(MediaSvcHandle *handle, const char *storage_id, const char *path, char *folder_id); -int media_svc_get_storage_type(const char *path, media_svc_storage_type_e *storage_type); - -int media_svc_get_mime_type(const char *path, char *mimetype); - -int media_svc_get_media_type(const char *path, const char *mime_type, media_svc_media_type_e *media_type); - -int media_svc_send_dir_update_noti(MediaSvcHandle *handle, const char *dir_path); - -int media_svc_count_invalid_items_in_folder(MediaSvcHandle *handle, const char *folder_path, int *count); - -/** @} */ - -/** - @} - */ #ifdef __cplusplus }