From 2bf3adf1e4d8befb5b1067c9f49c112dbd19e08f Mon Sep 17 00:00:00 2001 From: Jaechul Lee Date: Tue, 19 Apr 2022 11:06:34 +0900 Subject: [PATCH] fixup! sound_manager_internal: Revise echo-cancellation API set [Version] 0.6.47 [Issue Type] Build Change-Id: I35559e95d8e9853d9bdab17ff9da648e9926f86e Signed-off-by: Jaechul Lee --- include/sound_manager_internal_tv.h | 51 +++++++++++++++++++++++++++++++++ packaging/capi-media-sound-manager.spec | 2 +- 2 files changed, 52 insertions(+), 1 deletion(-) 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 @@ -133,6 +133,14 @@ typedef enum { /** * @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. * @since_tizen 5.5 * @privlevel public @@ -1146,6 +1154,49 @@ 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. * @since_tizen 6.0 * @privlevel public 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 -- 2.7.4