[ACR-1016] Add new APIs to set audio_only

Change-Id: I47b2d6e73ccd0a6a2ae104c6fa86c6d6e7c16a94

diff --git a/include/player.h b/include/player.h
index af89c0253cbbe90a1b8ae235f456a30856ef6e7d..5ed48e8a567d18b1b9df4febf591e65ee4163785 100644 (file)
--- a/include/player.h
+++ b/include/player.h
@@ -2181,6 +2181,39 @@ int player_set_max_adaptive_variant_limit(player_h player, int bandwidth, int wi
  */
 int player_get_max_adaptive_variant_limit(player_h player, int *bandwidth, int *width, int *height);
 
+/**
+ * @brief Sets the audio only mode.
+ * @since_tizen 4.0
+ * @details This function is used to disable or enable video rendering during playback.
+ * @param[in] player       The handle to the media player
+ * @param[in] audio_only   The new audio only status: (@c true = enable audio only, @c false = disable audio only)
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #PLAYER_ERROR_NONE                Successful
+ * @retval #PLAYER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PLAYER_ERROR_INVALID_OPERATION   Invalid operation
+ * @retval #PLAYER_ERROR_INVALID_STATE       Invalid player state
+ * @pre The player state must be one of: #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
+ * @see player_is_audio_only()
+ */
+int player_set_audio_only(player_h player, bool audio_only);
+
+/**
+ * @brief Gets the audio only mode status.
+ * @since_tizen 4.0
+ * @param[in]  player      The handle to the media player
+ * @param[out] audio_only  The current audio only status: (@c true = audio only enabled, @c false = audio only disabled)
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #PLAYER_ERROR_NONE                Successful
+ * @retval #PLAYER_ERROR_INVALID_PARAMETER   Invalid parameter
+ * @retval #PLAYER_ERROR_INVALID_OPERATION   Invalid operation
+ * @pre The player state must be one of: #PLAYER_STATE_IDLE, #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
+ * @see player_set_audio_only()
+ */
+int player_is_audio_only(player_h player, bool *audio_only);
+
+
 /**
  * @}
  */