From: Ji-hoon Lee Date: Mon, 20 Apr 2020 00:43:03 +0000 (+0900) Subject: Add missing files for multi-assistant-ap support X-Git-Tag: submit/tizen/20200528.071502~5 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=ab01698af8eccc166c37e9e344c0be712e59516c;p=platform%2Fcore%2Fuifw%2Fmulti-assistant.git Add missing files for multi-assistant-ap support Change-Id: I1e02a8d53d8a130bf78ac9e42f666a3455486421 --- diff --git a/include/multi-assistant-ap.pc.in b/include/multi-assistant-ap.pc.in new file mode 100644 index 0000000..f984e02 --- /dev/null +++ b/include/multi-assistant-ap.pc.in @@ -0,0 +1,11 @@ +prefix=@PREFIX@ +exec_prefix=@EXEC_PREFIX@ +libdir=@LIBDIR@ +includedir=@INCLUDEDIR@ + +Name: lib@PROJECT_NAME@_manager +Description: Multi assistant AP client library +Requires: glib-2.0 dbus-1 capi-base-common +Version: @VERSION@ +Libs: -L${libdir} -l@PROJECT_NAME@_ap +Cflags: -I${includedir} diff --git a/include/multi_assistant_ap.h b/include/multi_assistant_ap.h new file mode 100644 index 0000000..55449c8 --- /dev/null +++ b/include/multi_assistant_ap.h @@ -0,0 +1,146 @@ +/* + * Copyright (c) 2020 Samsung Electronics Co., Ltd All Rights Reserved + * + * Licensed under the Apache License, Version 2.0 (the License); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an AS IS BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + + +#ifndef __TIZEN_UIFW_MULTI_ASSISTANT_AP_H__ +#define __TIZEN_UIFW_MULTI_ASSISTANT_AP_H__ + +#include + +/** + * @defgroup CAPI_UIX_MULTI_ASSISTANT_AP_MODULE Multi assistant AP + * @ingroup CAPI_UIX_MULTI_ASSISTANT_MODULE + * @brief The @ref CAPI_UIX_MULTI_ASSISTANT_AP_MODULE API provides functions for showing queries and responses sent from multi assistant service. + * @{ + */ + + +#ifdef __cplusplus +extern "C" +{ +#endif + +/** + * @brief Initializes multi-assistant AP. + * @since_tizen 6.0 + * @privlevel public + * @privilege %http://tizen.org/privilege/recorder + * + * @return @c 0 on success, otherwise a negative error value + * @retval #MA_ERROR_NONE Successful + * @retval #MA_ERROR_NOT_SUPPORTED Not supported + * @retval #MA_ERROR_PERMISSION_DENIED Permission denied + * @retval #MA_ERROR_OPERATION_FAILED Operation failed + * @retval #MA_ERROR_OUT_OF_MEMORY Out of memory + * + * @see ma_ap_deinitialize() + */ +int ma_ap_initialize(void); + +/** + * @brief Deinitializes multi-assistant AP. + * @since_tizen 6.0 + * @privlevel public + * @privilege %http://tizen.org/privilege/recorder + * + * @return @c 0 on success, otherwise a negative error value + * @retval #MA_ERROR_NONE Successful + * @retval #MA_ERROR_NOT_SUPPORTED Not supported + * @retval #MA_ERROR_PERMISSION_DENIED Permission denied + * @retval #MA_ERROR_INVALID_STATE Invalid state + * + * @see ma_ap_initialize() + */ +int ma_ap_deinitialize(void); + +/** + * @brief Sets an error callback. + * @since_tizen 6.0 + * + * @param[in] callback The callback + * @param[in] user_data The user data passed to the callback function + * + * @return @c 0 on success, otherwise a negative error value + * @retval #MA_ERROR_NONE Successful + * @retval #MA_ERROR_NOT_SUPPORTED Not supported + * @retval #MA_ERROR_INVALID_STATE Invalid state + * @retval #MA_ERROR_INVALID_PARAMETER Invalid parameter + * + * @pre The state should be #MA_STATE_INITIALIZED. + * @see ma_error_cb() + * @see ma_ap_unset_error_cb() + */ +int ma_ap_set_error_cb(ma_error_cb callback, void* user_data); + +/** + * @brief Unsets an error callback. + * @since_tizen 6.0 + * + * @return @c 0 on success, otherwise a negative error value + * @retval #MA_ERROR_NONE Successful + * @retval #MA_ERROR_NOT_SUPPORTED Not supported + * @retval #MA_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #MA_STATE_INITIALIZED. + * @see ma_error_cb() + * @see ma_ap_set_error_cb() + */ +int ma_ap_unset_error_cb(void); + +/** + * @brief Sets an audio streaming callback. + * @since_tizen 6.0 + * + * @param[in] callback The callback + * @param[in] user_data The user data passed to the callback function + * + * @return @c 0 on success, otherwise a negative error value + * @retval #MA_ERROR_NONE Successful + * @retval #MA_ERROR_NOT_SUPPORTED Not supported + * @retval #MA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #MA_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #MA_STATE_INITIALIZED. + * @see ma_audio_streaming_cb() + * @see ma_ap_unset_audio_streaming_cb() + */ +int ma_ap_set_audio_streaming_cb(ma_audio_streaming_cb callback, void* user_data); + +/** + * @brief Unsets an audio streaming callback. + * @since_tizen 6.0 + * + * @return @c 0 on success, otherwise a negative error value + * @retval #MA_ERROR_NONE Successful + * @retval #MA_ERROR_NOT_SUPPORTED Not supported + * @retval #MA_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #MA_STATE_INITIALIZED. + * @see ma_audio_streaming_cb() + * @see ma_ap_set_audio_streaming_cb() + */ +int ma_ap_unset_audio_streaming_cb(void); + +#ifdef __cplusplus +} +#endif + +/** + * @} + */ + +#endif /* __TIZEN_UIFW_MULTI_ASSISTANT_UI_H__ */ +