[ACR] modify pre-condition and add error code of push api

Change-Id: Ieac531000d15cf393e932ddc89a78bc7c548600a

diff --git a/include/common/player.h b/include/common/player.h
index 3651629cd5086f7b3abdc19a1d2fbaedf80f67c4..6a44f3c8b57845790be2bee4deb49f5e2ee438e8 100644 (file)
--- a/include/common/player.h
+++ b/include/common/player.h
@@ -943,7 +943,8 @@ int player_unset_media_packet_video_frame_decoded_cb(player_h player);
  * @retval #PLAYER_ERROR_INVALID_STATE Invalid state
  * @retval #PLAYER_ERROR_NOT_SUPPORTED_FILE File not supported
  * @retval #PLAYER_ERROR_BUFFER_SPACE No buffer space available (since 3.0)
- * @pre The player state must be set to #PLAYER_STATE_IDLE at least.
+ * @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation (since 3.0)
+ * @pre The player state must be one of #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING or #PLAYER_STATE_PAUSED.
  * @see player_set_media_stream_info()
  * @see player_set_media_stream_buffer_max_size()
  */

diff --git a/include/wearable/player.h b/include/wearable/player.h
index 6b58f240941a165c2816f6fa87f766db0df92dcf..1f4a75048b82b52d64549bf4604f2f8cf78fbfd5 100644 (file)
--- a/include/wearable/player.h
+++ b/include/wearable/player.h
@@ -944,7 +944,8 @@ int player_unset_media_packet_video_frame_decoded_cb(player_h player);
  * @retval #PLAYER_ERROR_INVALID_STATE Invalid state
  * @retval #PLAYER_ERROR_NOT_SUPPORTED_FILE File not supported
  * @retval #PLAYER_ERROR_BUFFER_SPACE No buffer space available (since 3.0)
- * @pre The player state must be set to #PLAYER_STATE_IDLE at least.
+ * @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation (since 3.0)
+ * @pre The player state must be one of #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING or #PLAYER_STATE_PAUSED.
  * @see player_set_media_stream_info()
  * @see player_set_media_stream_buffer_max_size()
  */