From: Jaechul Lee <jcsing.lee@samsung.com>
Date: Tue, 19 Apr 2022 02:06:34 +0000 (+0900)
Subject: fixup! sound_manager_internal: Revise echo-cancellation API set
X-Git-Tag: submit/tizen/20220419.020933^0
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=2bf3adf1e4d8befb5b1067c9f49c112dbd19e08f;p=platform%2Fcore%2Fapi%2Fsound-manager.git

fixup! sound_manager_internal: Revise echo-cancellation API set

[Version] 0.6.47
[Issue Type] Build

Change-Id: I35559e95d8e9853d9bdab17ff9da648e9926f86e
Signed-off-by: Jaechul Lee <jcsing.lee@samsung.com>
---

diff --git a/include/sound_manager_internal_tv.h b/include/sound_manager_internal_tv.h
index d188c08..7840242 100644
--- a/include/sound_manager_internal_tv.h
+++ b/include/sound_manager_internal_tv.h
@@ -131,6 +131,14 @@ typedef enum {
 	SOUND_RPI_PLAYBACK_HDMI2,     /**< HDMI2 (only for RPI4) */
 } sound_rpi_playback_route_type;
 
+/**
+ * @internal
+ * @brief Definition for the value indicating that the reference device for the stream information was not set.
+ * @since_tizen 7.0
+ * @see sound_manager_get_echo_cancel_reference_device()
+ */
+#define SOUND_MANAGER_STREAM_NO_REFERENCE_DEVICE    0
+
 /**
  * @internal
  * @brief Sets the mute specified for a particular sound type.
@@ -1144,6 +1152,49 @@ int sound_manager_set_remote_permission(int id, bool allowed);
  */
 int sound_manager_start_discover_remote_device(void);
 
+/**
+ * @internal
+ * @brief Sets acoustic echo cancellation reference device
+ * @since_tizen 7.0
+ * @remark You can get a device handle by using sound_manager_get_device_list() and sound_manager_get_next_device()\n
+ *	If @a device is not supported by @a stream_info, #SOUND_MANAGER_ERROR_POLICY will be returned.
+ * @param[in]	stream_info	The handle of stream information
+ * @param[in]	device	The reference device of echo-cancellation
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #SOUND_MANAGER_ERROR_NONE Success
+ * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #SOUND_MANAGER_ERROR_POLICY Noncompliance with the sound system policy
+ * @retval #SOUND_MANAGER_ERROR_INTERNAL Internal error inside the sound system
+ * @see sound_manager_create_stream_information()
+ * @see sound_manager_get_device_list()
+ * @see sound_manager_get_next_device()
+ * @see sound_manager_free_device_list()
+ */
+int sound_manager_set_echo_cancel_reference_device(sound_stream_info_h stream_info, sound_device_h device);
+
+/**
+ * @internal
+ * @brief Gets acoustic echo cancellation reference device
+ * @since_tizen 7.0
+ * @remarks	If there is no reference device that has been set, the output value will be set to
+ *	#SOUND_MANAGER_STREAM_NO_REFERENCE_DEVICE.\n
+ *	You can get a device handle of the id value by using sound_manager_get_device_list(),
+ *	sound_manager_get_next_device() and sound_manager_get_device_id().
+ * @param[in]	stream_info	The handle of stream information
+ * @param[out]	device_id	The reference device id of echo-cancellation
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #SOUND_MANAGER_ERROR_NONE Success
+ * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @see sound_manager_create_stream_information()
+ * @see sound_manager_get_device_list()
+ * @see sound_manager_get_next_device()
+ * @see sound_manager_free_device_list()
+ */
+int sound_manager_get_echo_cancel_reference_device(sound_stream_info_h stream_info, int *device_id);
+
+
 /**
  * @internal
  * @brief Stops discovering of published remote devices on the local network.
diff --git a/packaging/capi-media-sound-manager.spec b/packaging/capi-media-sound-manager.spec
index 798cf30..b7a3089 100644
--- a/packaging/capi-media-sound-manager.spec
+++ b/packaging/capi-media-sound-manager.spec
@@ -1,6 +1,6 @@
 Name:       capi-media-sound-manager
 Summary:    Sound Manager library
-Version:    0.6.46
+Version:    0.6.47
 Release:    0
 Group:      Multimedia/API
 License:    Apache-2.0