From: Eunhae Choi <eunhae1.choi@samsung.com>
Date: Thu, 30 Mar 2017 08:06:16 +0000 (+0900)
Subject: [ACR-920] Deprecate the APIs for progressive download
X-Git-Tag: submit/tizen/20170420.053325~3
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=c0221d3d864e7e6e4bea0166ff4c08c09a19b52c;p=platform%2Fcore%2Fapi%2Fplayer.git

[ACR-920] Deprecate the APIs for progressive download

Change-Id: I4c916a9d99b4f1bc0da4edc5ef348d3ce2fea17a
---

diff --git a/include/player.h b/include/player.h
index f8f02a4..24659db 100644
--- a/include/player.h
+++ b/include/player.h
@@ -1815,6 +1815,7 @@ int player_set_buffering_cb(player_h player, player_buffering_cb callback, void
 int player_unset_buffering_cb(player_h player);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Sets a path to download, progressively.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @remarks Progressive download will be started when you invoke player_start().
@@ -1836,9 +1837,10 @@ int player_unset_buffering_cb(player_h player);
  * @see player_set_progressive_download_message_cb()
  * @see player_unset_progressive_download_message_cb()
  */
-int player_set_progressive_download_path(player_h player, const char *path);
+int player_set_progressive_download_path(player_h player, const char *path) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Gets the status of progressive download.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
@@ -1853,9 +1855,10 @@ int player_set_progressive_download_path(player_h player, const char *path);
  * @pre The progressive download path must be set by calling player_set_progressive_download_path().
  * @pre The player state must be set to #PLAYER_STATE_PLAYING by calling player_start() or set to #PLAYER_STATE_PAUSED by calling player_pause().
  */
-int player_get_progressive_download_status(player_h player, unsigned long *current, unsigned long *total_size);
+int player_get_progressive_download_status(player_h player, unsigned long *current, unsigned long *total_size) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Registers a callback function to be invoked when progressive download is started or completed.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player	The handle to the media player
@@ -1872,9 +1875,10 @@ int player_get_progressive_download_status(player_h player, unsigned long *curre
  * @see player_unset_progressive_download_message_cb()
  * @see player_set_progressive_download_path()
  */
-int player_set_progressive_download_message_cb(player_h player, player_pd_message_cb callback, void *user_data);
+int player_set_progressive_download_message_cb(player_h player, player_pd_message_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Unregisters the callback function.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
  * @param[in] player The handle to the media player
@@ -1885,7 +1889,7 @@ int player_set_progressive_download_message_cb(player_h player, player_pd_messag
  * @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
  * @see player_set_progressive_download_message_cb()
  */
-int player_unset_progressive_download_message_cb(player_h player);
+int player_unset_progressive_download_message_cb(player_h player) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Sets the playback rate.
diff --git a/src/player.c b/src/player.c
index 1937cf5..23c2c11 100644
--- a/src/player.c
+++ b/src/player.c
@@ -3499,6 +3499,7 @@ int player_set_progressive_download_path(player_h player, const char *path)
 	char dw_path[MAX_URL_LEN] = {0, };
 
 	LOGD("ENTER");
+	LOGW("DEPRECATION WARNING: player_set_progressive_download_path() is deprecated and will be removed from next release.");
 
 	if (!_player_check_network_availability())
 		return PLAYER_ERROR_FEATURE_NOT_SUPPORTED_ON_DEVICE;
@@ -3523,6 +3524,7 @@ int player_get_progressive_download_status(player_h player, unsigned long *pcurr
 	unsigned long current, total_size;
 
 	LOGD("ENTER");
+	LOGW("DEPRECATION WARNING: player_get_progressive_download_status() is deprecated and will be removed from next release.");
 
 	player_msg_send(api, pc, ret_buf, ret);
 	if (ret == PLAYER_ERROR_NONE) {
@@ -3722,6 +3724,7 @@ int player_set_progressive_download_message_cb(player_h player, player_pd_messag
 	int set = 1;
 
 	LOGD("ENTER");
+	LOGW("DEPRECATION WARNING: player_set_progressive_download_message_cb() is deprecated and will be removed from next release.");
 
 	if (!_player_check_network_availability())
 		return PLAYER_ERROR_FEATURE_NOT_SUPPORTED_ON_DEVICE;
@@ -3749,6 +3752,7 @@ int player_unset_progressive_download_message_cb(player_h player)
 	int set = 0;
 
 	LOGD("ENTER");
+	LOGW("DEPRECATION WARNING: player_unset_progressive_download_message_cb() is deprecated and will be removed from next release.");
 
 	set_null_user_cb_lock(pc->cb_info, type);