[ACR-1838] Deprecate all bookmark and playlist funtions

[platform/core/api/media-content.git] / include_product / media_playlist.h

diff --git a/include_product/media_playlist.h b/include_product/media_playlist.h
index a81cc77..e3e3915 100755 (executable)
--- a/include_product/media_playlist.h
+++ b/include_product/media_playlist.h
@@ -38,6 +38,7 @@ extern "C" {
 
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the number of playlists for the passed @a filter from the media database.
  * @since_tizen 2.3
  *
@@ -56,9 +57,10 @@ extern "C" {
  *
  * @see media_content_connect()
  */
-int media_playlist_get_playlist_count_from_db(filter_h filter, int *playlist_count);
+int media_playlist_get_playlist_count_from_db(filter_h filter, int *playlist_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Iterates through the media playlists with an optional @a filter from the media database.
  * @details This function gets all media playlists meeting the given filter.
  *          The callback function will be invoked for every retrieved media playlist.
@@ -86,9 +88,10 @@ int media_playlist_get_playlist_count_from_db(filter_h filter, int *playlist_cou
  * @see media_content_connect()
  * @see media_filter_create()
  */
-int media_playlist_foreach_playlist_from_db(filter_h filter, media_playlist_cb callback, void *user_data);
+int media_playlist_foreach_playlist_from_db(filter_h filter, media_playlist_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the number of the media info for the given playlist present in the media database.
  * @since_tizen 2.3
  *
@@ -108,9 +111,10 @@ int media_playlist_foreach_playlist_from_db(filter_h filter, media_playlist_cb c
  *
  * @see media_content_connect()
  */
-int media_playlist_get_media_count_from_db(int playlist_id, filter_h filter, int *media_count);
+int media_playlist_get_media_count_from_db(int playlist_id, filter_h filter, int *media_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Iterates through the media files with an optional @a filter in the given audio playlist from the media database.
  * @details This function gets all media files associated with the given media playlist and
  *          meeting desired filter option and calls @a callback for
@@ -139,9 +143,10 @@ int media_playlist_get_media_count_from_db(int playlist_id, filter_h filter, int
  * @see media_content_connect()
  * @see media_filter_create()
  */
-int media_playlist_foreach_media_from_db(int playlist_id, filter_h filter, playlist_member_cb callback, void *user_data);
+int media_playlist_foreach_media_from_db(int playlist_id, filter_h filter, playlist_member_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Inserts a new playlist with the given name into the media database.
  * @since_tizen 2.3
  *
@@ -170,9 +175,10 @@ int media_playlist_foreach_media_from_db(int playlist_id, filter_h filter, playl
  * @see media_content_connect()
  * @see media_playlist_delete_from_db()
  */
-int media_playlist_insert_to_db(const char *name, media_playlist_h *playlist);
+int media_playlist_insert_to_db(const char *name, media_playlist_h *playlist) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Deletes the given playlist from the media database.
  * @since_tizen 2.3
  *
@@ -197,9 +203,10 @@ int media_playlist_insert_to_db(const char *name, media_playlist_h *playlist);
  * @see media_content_connect()
  * @see media_playlist_insert_to_db()
  */
-int media_playlist_delete_from_db(int playlist_id);
+int media_playlist_delete_from_db(int playlist_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the media playlist from the media database.
  *
  * @details This function creates a new media playlist handle from the media database by the given @a playlist_id.
@@ -226,9 +233,10 @@ int media_playlist_delete_from_db(int playlist_id);
  * @see media_content_connect()
  * @see media_playlist_destroy()
  */
-int media_playlist_get_playlist_from_db(int playlist_id, media_playlist_h *playlist);
+int media_playlist_get_playlist_from_db(int playlist_id, media_playlist_h *playlist) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Destroys a playlist handle.
  * @details This function frees all resources related to the playlist handle. This
  *          handle no longer can be used to perform any operations. A new handle has to
@@ -248,9 +256,10 @@ int media_playlist_get_playlist_from_db(int playlist_id, media_playlist_h *playl
  *
  * @see media_playlist_clone()
  */
-int media_playlist_destroy(media_playlist_h playlist);
+int media_playlist_destroy(media_playlist_h playlist) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Clones a playlist handle.
  * @details This function copies the media playlist handle from a source to
  *          destination. There is no media_playlist_create() function. The media_playlist_h is created internally and available through
@@ -274,9 +283,10 @@ int media_playlist_destroy(media_playlist_h playlist);
  * @see media_playlist_destroy()
  * @see media_playlist_foreach_playlist_from_db()
  */
-int media_playlist_clone(media_playlist_h *dst, media_playlist_h src);
+int media_playlist_clone(media_playlist_h *dst, media_playlist_h src) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the media playlist ID.
  * @since_tizen 2.3
  *
@@ -289,9 +299,10 @@ int media_playlist_clone(media_playlist_h *dst, media_playlist_h src);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_playlist_get_playlist_id(media_playlist_h playlist, int *playlist_id);
+int media_playlist_get_playlist_id(media_playlist_h playlist, int *playlist_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets a name of the playlist.
  * @since_tizen 2.3
  *
@@ -307,9 +318,10 @@ int media_playlist_get_playlist_id(media_playlist_h playlist, int *playlist_id);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_playlist_get_name(media_playlist_h playlist, char **playlist_name);
+int media_playlist_get_name(media_playlist_h playlist, char **playlist_name) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Sets the name of the playlist.
  * @since_tizen 2.3
  *
@@ -326,9 +338,10 @@ int media_playlist_get_name(media_playlist_h playlist, char **playlist_name);
  * @post media_playlist_update_to_db()
  *
  */
-int media_playlist_set_name(media_playlist_h playlist, const char *playlist_name);
+int media_playlist_set_name(media_playlist_h playlist, const char *playlist_name) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets a thumbnail path of the playlist.
  * @since_tizen 2.3
  *
@@ -344,9 +357,10 @@ int media_playlist_set_name(media_playlist_h playlist, const char *playlist_name
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_playlist_get_thumbnail_path(media_playlist_h playlist, char **path);
+int media_playlist_get_thumbnail_path(media_playlist_h playlist, char **path) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Sets the thumbnail path of the playlist.
  * @since_tizen 2.3
  *
@@ -362,10 +376,11 @@ int media_playlist_get_thumbnail_path(media_playlist_h playlist, char **path);
  *
  * @post media_playlist_update_to_db()
  */
-int media_playlist_set_thumbnail_path(media_playlist_h playlist, const char *path);
+int media_playlist_set_thumbnail_path(media_playlist_h playlist, const char *path) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Sets the playing order in the playlist.
  * @since_tizen 2.3
  *
@@ -382,9 +397,10 @@ int media_playlist_set_thumbnail_path(media_playlist_h playlist, const char *pat
  *
  * @post media_playlist_update_to_db()
  */
-int media_playlist_set_play_order(media_playlist_h playlist, int playlist_member_id, int play_order);
+int media_playlist_set_play_order(media_playlist_h playlist, int playlist_member_id, int play_order) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Adds a new media info to the playlist.
  * @since_tizen 2.3
  *
@@ -404,9 +420,10 @@ int media_playlist_set_play_order(media_playlist_h playlist, int playlist_member
  * @see media_content_connect()
  * @see media_playlist_remove_media()
  */
-int media_playlist_add_media(media_playlist_h playlist, const char *media_id);
+int media_playlist_add_media(media_playlist_h playlist, const char *media_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Removes the playlist members related with the media from the given playlist.
  * @since_tizen 2.3
  *
@@ -426,9 +443,10 @@ int media_playlist_add_media(media_playlist_h playlist, const char *media_id);
  * @see media_content_connect()
  * @see media_playlist_add_media()
  */
-int media_playlist_remove_media(media_playlist_h playlist, int playlist_member_id);
+int media_playlist_remove_media(media_playlist_h playlist, int playlist_member_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the played order of the playlist.
  * @since_tizen 2.3
  *
@@ -442,9 +460,10 @@ int media_playlist_remove_media(media_playlist_h playlist, int playlist_member_i
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_playlist_get_play_order(media_playlist_h playlist, int playlist_member_id, int *play_order);
+int media_playlist_get_play_order(media_playlist_h playlist, int playlist_member_id, int *play_order) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Updates the media playlist to the media database.
  *
  * @details The function updates the given media playlist in the media database.
@@ -481,9 +500,10 @@ int media_playlist_get_play_order(media_playlist_h playlist, int playlist_member
  * @see media_playlist_set_name()
  * @see media_playlist_set_play_order()
  */
-int media_playlist_update_to_db(media_playlist_h playlist);
+int media_playlist_update_to_db(media_playlist_h playlist) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Imports the playlist from m3u playlist file.
  * @details This function reads a playlist from the m3u playlist file and insert into the db.
  * @since_tizen 2.4
@@ -512,9 +532,10 @@ int media_playlist_update_to_db(media_playlist_h playlist);
  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
-int media_playlist_import_from_file(const char *playlist_name, const char *path, media_playlist_h *playlist);
+int media_playlist_import_from_file(const char *playlist_name, const char *path, media_playlist_h *playlist) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Exports the playlist to m3u playlist file.
  * @since_tizen 2.4
  *
@@ -536,7 +557,7 @@ int media_playlist_import_from_file(const char *playlist_name, const char *path,
  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
-int media_playlist_export_to_file(media_playlist_h playlist, const char* path);
+int media_playlist_export_to_file(media_playlist_h playlist, const char* path) TIZEN_DEPRECATED_API;
 
 /**
  * @}