[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 (file)
--- 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 (file)
--- 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);