fixup! sound_manager_internal: Revise echo-cancellation API set 52/273952/1 accepted/tizen/unified/20220420.135457 accepted/tizen/unified/20220421.065419 submit/tizen/20220419.020933 submit/tizen/20220420.020006
authorJaechul Lee <jcsing.lee@samsung.com>
Tue, 19 Apr 2022 02:06:34 +0000 (11:06 +0900)
committerJaechul Lee <jcsing.lee@samsung.com>
Tue, 19 Apr 2022 02:07:34 +0000 (11:07 +0900)
[Version] 0.6.47
[Issue Type] Build

Change-Id: I35559e95d8e9853d9bdab17ff9da648e9926f86e
Signed-off-by: Jaechul Lee <jcsing.lee@samsung.com>
include/sound_manager_internal_tv.h
packaging/capi-media-sound-manager.spec

index d188c08856331bd7b82f37f7ab2dc10fa2f4b6b3..784024226840960b3647229c64d76900c069971e 100644 (file)
@@ -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.
index 798cf308fcbac5aaf45cb73d8ec41ef8c8b04165..b7a30894849b8756d434b0ac7d998ed7e2073681 100644 (file)
@@ -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