From: sooyeon.kim Date: Thu, 3 Dec 2020 07:35:57 +0000 (+0900) Subject: Fix Native API references X-Git-Tag: submit/tizen/20201203.100557^0 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=099a6c1b091d05d5fc8bf33b63d069f3b8e3204e;p=platform%2Fcore%2Fuifw%2Fvoice-control.git Fix Native API references Change-Id: Ic5937ee1a244f02f2bee64c3a2488d258096a02f Signed-off-by: sooyeon.kim --- diff --git a/include/vce.h b/include/vce.h index 9f4d614..fab8f26 100644 --- a/include/vce.h +++ b/include/vce.h @@ -198,8 +198,8 @@ typedef struct vce_cmd_s* vce_cmd_h; * For example, "ko_KR" for Korean, "en_US" for American English. * @param[in] user_data The user data passed from the foreach function * @return @c true to continue with the next iteration of the loop \n @c false to break out of the loop - * @pre vce_foreach_supported_languages() will invoke this callback. - * @see vce_foreach_supported_languages() + * @pre vce_foreach_supported_languages_cb() will invoke this callback. + * @see vce_foreach_supported_languages_cb() */ typedef bool (*vce_supported_language_cb)(const char* language, void* user_data); @@ -297,8 +297,8 @@ typedef int (*vce_set_language_cb)(const char* language); * @retval #VCE_ERROR_INVALID_STATE Invalid state * @retval #VCE_ERROR_OPERATION_FAILED Operation failed * @retval #VCE_ERROR_NOT_SUPPORTED_FEATURE Not supported command type - * @post vce_start() is called after this function is successful. - * @see vce_start() + * @post vce_start_cb() is called after this function is successful. + * @see vce_start_cb() * @see vcd_foreach_command() * @see vce_unset_commands() * @see vce_get_command_count() @@ -334,8 +334,8 @@ typedef int (*vce_unset_commands_cb)(void); * @retval #VCE_ERROR_OPERATION_FAILED Operation failed * @pre vcd_foreach_command() is successful. * @see vce_set_recording_data_cb() - * @see vce_stop() - * @see vce_cancel() + * @see vce_stop_cb() + * @see vce_cancel_cb() */ typedef int (*vce_start_cb)(bool stop_by_silence); @@ -353,10 +353,10 @@ typedef int (*vce_start_cb)(bool stop_by_silence); * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_INVALID_STATE Invalid state * @retval #VCE_ERROR_OPERATION_FAILED Operation failed - * @pre vce_start() is successful. - * @see vce_start() - * @see vce_cancel() - * @see vce_stop() + * @pre vce_start_cb() is successful. + * @see vce_start_cb() + * @see vce_cancel_cb() + * @see vce_stop_cb() */ typedef int(*vce_set_recording_data_cb)(const void* data, unsigned int length, vce_speech_detect_e* speech_detected); @@ -368,11 +368,11 @@ typedef int(*vce_set_recording_data_cb)(const void* data, unsigned int length, v * @retval #VCE_ERROR_INVALID_STATE Invalid state * @retval #VCE_ERROR_OPERATION_FAILED Operation failed * @retval #VCE_ERROR_OUT_OF_NETWORK Out of network - * @pre vce_set_recording_data() is successful. - * @see vce_start() - * @see vce_set_recording_data() - * @see vce_result_cb() - * @see vce_cancel() + * @pre vce_set_recording_data_cb() is successful. + * @see vce_start_cb() + * @see vce_set_recording_data_cb() + * @see vce_send_result() + * @see vce_cancel_cb() */ typedef int (*vce_stop_cb)(void); @@ -382,9 +382,9 @@ typedef int (*vce_stop_cb)(void); * @return 0 on success, otherwise a negative error value. * @retval #VCE_ERROR_NONE Successful. * @retval #VCE_ERROR_INVALID_STATE Invalid state. - * @pre vce_start() is successful. - * @see vce_start() - * @see vce_stop() + * @pre vce_start_cb() is successful. + * @see vce_start_cb() + * @see vce_stop_cb() */ typedef int (*vce_cancel_cb)(void); @@ -407,8 +407,8 @@ typedef int (*vce_set_audio_type_cb)(const char* audio_type); * @param[in] credential Credential key. * @return 0 on success, otherwise a negative error value. * @retval #VCE_ERROR_NONE Successful. - * @retval #VCE_ERROR_NOT_SUPPORTED_FEATURE Not supported feature. * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied. + * @retval #VCE_ERROR_NOT_SUPPORTED_FEATURE Not supported feature. */ typedef int (*vce_set_server_dialog_cb)(const char* app_id, const char* credential); @@ -618,7 +618,7 @@ typedef int (*vce_cancel_tts_cb)(int pid, int utt_id, void* user_data); * @pre An application registers callback function using vce_set_tts_audio_format_request_cb(). * * @see vce_set_tts_audio_format_request_cb() - * @see vce_unset_tts_audio_format_request_cb() + * @see vce_unset_get_tts_audio_format_cb() */ typedef int (*vce_tts_audio_format_request_cb)(int* rate, int* channel, int* audio_type, void* user_data); @@ -629,10 +629,10 @@ typedef int (*vce_tts_audio_format_request_cb)(int* rate, int* channel, int* aud * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * @remarks You must register all callbacks except optional callbacks for operating VC engine.\n * The following callbacks are optional callbacks : \n - * - vce_private_data_set_cb \n - * - vce_private_data_requested_cb \n - * - vce_nlu_base_info_requested_cb \n - * - vce_specific_engine_request_cb \n + * - vce_private_data_set_cb() \n + * - vce_private_data_requested_cb() \n + * - vce_nlu_base_info_requested_cb() \n + * - vce_specific_engine_request_cb() \n * If you want to use the optional callbacks, you can set them using vce_set_private_data_set_cb(), vce_set_private_data_requested_cb(), vce_set_nlu_base_info_requested_cb(), and vce_set_specific_engine_request_cb() functions. * * @see vce_main() @@ -691,14 +691,13 @@ typedef struct { * @param[in] callback The structure of engine request callback function * @return This function returns @c zero on success, or negative with error code on failure * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_OUT_OF_MEMORY Out of Memory - * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied + * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VCE_ERROR_OUT_OF_MEMORY Out of Memory * @retval #VCE_ERROR_OPERATION_FAILED Operation failed - * @pre The vce_get_engine_info() should be successful. - * @see vce_get_engine_info() - * @see vce_unload_engine() + * @pre The vce_get_info_cb() should be successful. + * @see vce_get_info_cb() * @see vce_request_callback_s * @code #include @@ -900,9 +899,9 @@ int vce_send_error(vce_error_e error, const char* msg, void* user_data); * @param[in] callback_func vce_private_data_set event callback function * @return @c 0 on success, otherwise a negative error value * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied + * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_OPERATION_FAILED Operation failure * @retval #VCE_ERROR_NOT_SUPPORTED_FEATURE Not supported feature * @pre The vce_main() function should be invoked before this function is called. @@ -919,9 +918,9 @@ int vce_set_private_data_set_cb(vce_private_data_set_cb callback_func); * @param[in] callback_func vce_private_data_requested event callback function * @return @c 0 on success, otherwise a negative error value * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied + * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_OPERATION_FAILED Operation failure * @see vce_private_data_requested_cb() */ @@ -949,8 +948,8 @@ int vce_set_nlu_base_info_requested_cb(vce_nlu_base_info_requested_cb callback_f * * @return 0 on success, otherwise a negative error value * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * * @see vce_unset_specific_engine_request_cb() */ @@ -961,8 +960,8 @@ int vce_set_specific_engine_request_cb(vce_specific_engine_request_cb callback_f * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * * @return 0 on success, otherwise a negative error value - * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_NONE Successful + * @retval #VCE_ERROR_NOT_SUPPORTED Not supported * * @see vce_set_specific_engine_request_cb() */ @@ -972,7 +971,7 @@ int vce_unset_specific_engine_request_cb(void); * @brief Retrieves all commands using callback function. * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * - * @param[in] vce_command The handle to be passed to the vce_set_commands() function + * @param[in] vce_command The handle to be passed to the vce_set_commands_cb() function * @param[in] callback The callback function to invoke * @param[in] user_data The user data to be passed to the callback function * @@ -982,8 +981,8 @@ int vce_unset_specific_engine_request_cb(void); * @retval #VCE_ERROR_OPERATION_FAILED Operation failure * @retval #VCE_ERROR_INVALID_STATE Invalid state * @post This function invokes vce_command_cb() repeatedly for getting commands. - * @see vce_foreach_command_cb() - * @see vce_set_commands() + * @see vce_command_cb() + * @see vce_set_commands_cb() */ int vce_get_foreach_command(vce_cmd_h vce_command, vce_command_cb callback, void* user_data); @@ -991,14 +990,14 @@ int vce_get_foreach_command(vce_cmd_h vce_command, vce_command_cb callback, void * @brief Gets command length. * @since_tizen @if MOBILE 4.0 @elseif WEARABLE 5.0 @endif * - * @param[in] vce_command The handle to be passed to the vce_set_commands() function + * @param[in] vce_command The handle to be passed to the vce_set_commands_cb() function * @param[out] count The command count value * * @return 0 on success, otherwise a negative error value. * @retval #VCE_ERROR_NONE Successful * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_OPERATION_FAILED Operation failure - * @see vce_set_commands() + * @see vce_set_commands_cb() */ int vce_get_command_count(vce_cmd_h vce_command, int* count); @@ -1011,9 +1010,9 @@ int vce_get_command_count(vce_cmd_h vce_command, int* count); * @param[in] audio_type Current audio type (e.g. #VCE_AUDIO_ID_BLUETOOTH or #VCE_AUDIO_ID_WIFI) * @return the value greater than 0 on success, otherwise a negative error value * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied + * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter */ int vce_get_audio_type(char** audio_type); @@ -1026,11 +1025,11 @@ int vce_get_audio_type(char** audio_type); * @param[in] data Private data * @return 0 on success, otherwise a negative error value. * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_OUT_OF_MEMORY Out of Memory + * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_INVALID_STATE Invalid state - * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied - * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_OUT_OF_MEMORY Out of Memory * @retval #VCE_ERROR_OPERATION_FAILED Operation failed */ int vce_set_private_data(const char* key, const char* data); @@ -1045,11 +1044,11 @@ int vce_set_private_data(const char* key, const char* data); * @param[out] data Private data * @return 0 on success, otherwise a negative error value. * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_OUT_OF_MEMORY Out of Memory - * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_INVALID_STATE Invalid state + * @retval #VCE_ERROR_OUT_OF_MEMORY Out of Memory * @retval #VCE_ERROR_OPERATION_FAILED Operation failed */ int vce_get_private_data(const char* key, char** data); @@ -1061,8 +1060,8 @@ int vce_get_private_data(const char* key, char** data); * @privilege %http://tizen.org/privilege/recorder * @return 0 on success, otherwise a negative error value. * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_OPERATION_FAILED Operation failure * @retval #VCE_ERROR_RECORDER_BUSY Busy recorder */ @@ -1075,8 +1074,8 @@ int vce_start_recording(void); * @privilege %http://tizen.org/privilege/recorder * @return 0 on success, otherwise a negative error value. * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_PERMISSION_DENIED Permission denied * @retval #VCE_ERROR_OPERATION_FAILED Operation failure */ int vce_stop_recording(void); @@ -1124,8 +1123,8 @@ int vce_send_feedback_streaming(vce_feedback_event_e event, char* buffer, int le * * @return 0 on success, otherwise a negative error value * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * * @see vce_request_tts_cb() * @see vce_unset_request_tts_cb() @@ -1137,8 +1136,8 @@ int vce_set_request_tts_cb(vce_request_tts_cb callback_func, void* user_data); * @since_tizen 5.0 * * @return 0 on success, otherwise a negative error value - * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_NONE Successful + * @retval #VCE_ERROR_NOT_SUPPORTED Not supported * * @see vce_set_request_tts_cb() */ @@ -1153,8 +1152,8 @@ int vce_unset_request_tts_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * * @see vce_cancel_tts_cb() * @see vce_unset_cancel_tts_cb() @@ -1166,8 +1165,8 @@ int vce_set_cancel_tts_cb(vce_cancel_tts_cb callback_func, void* user_data); * @since_tizen 5.0 * * @return 0 on success, otherwise a negative error value - * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_NONE Successful + * @retval #VCE_ERROR_NOT_SUPPORTED Not supported * * @see vce_set_cancel_tts_cb() */ @@ -1182,8 +1181,8 @@ int vce_unset_cancel_tts_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VCE_ERROR_NONE Successful - * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VCE_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_INVALID_PARAMETER Invalid parameter * * @see vce_tts_audio_format_request_cb() * @see vce_unset_get_tts_audio_format_cb() @@ -1195,10 +1194,10 @@ int vce_set_tts_audio_format_request_cb(vce_tts_audio_format_request_cb callback * @since_tizen 5.0 * * @return 0 on success, otherwise a negative error value - * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_NOT_SUPPORTED Not supported + * @retval #VCE_ERROR_NONE Successful + * @retval #VCE_ERROR_NOT_SUPPORTED Not supported * - * @see vce_set_tts_audio_format_cb() + * @see vce_set_tts_audio_format_request_cb() */ int vce_unset_get_tts_audio_format_cb(void); diff --git a/include/voice_control.h b/include/voice_control.h index 5e28d19..69172d2 100644 --- a/include/voice_control.h +++ b/include/voice_control.h @@ -232,9 +232,6 @@ int vc_get_state(vc_state_e* state); * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED Not supported * @pre The state should be #VC_STATE_READY. - * @see vc_request_start() - * @see vc_request_stop() - * @see vc_request_cancel() * @see vc_set_service_state_changed_cb() * @see vc_unset_service_state_changed_cb() */ diff --git a/include/voice_control_manager.h b/include/voice_control_manager.h index c728910..f14e5f6 100644 --- a/include/voice_control_manager.h +++ b/include/voice_control_manager.h @@ -193,19 +193,19 @@ typedef bool (*vc_mgr_all_result_cb)(vc_result_event_e event, vc_cmd_list_h vc_c typedef void (*vc_mgr_pre_result_cb)(vc_pre_result_event_e event, const char *result, void *user_data); /** -* @brief Called when client gets the specific engine's result from vc-service. -* @since_tizen 5.0 -* -* @param[in] engine_app_id The specific engine's app id -* @param[in] event The specific engine event type -* @param[in] result The specific engine result -* @param[in] user_data The user data passed from the callback registration function -* -* @pre An application registers callback function using vc_mgr_set_specific_engine_result_cb(). -* -* @see vc_mgr_set_specific_engine_result_cb() -* @see vc_mgr_unset_specific_engine_result_cb() -*/ + * @brief Called when client gets the specific engine's result from vc-service. + * @since_tizen 5.0 + * + * @param[in] engine_app_id The specific engine's app id + * @param[in] event The specific engine event type + * @param[in] result The specific engine result + * @param[in] user_data The user data passed from the callback registration function + * + * @pre An application registers callback function using vc_mgr_set_specific_engine_result_cb(). + * + * @see vc_mgr_set_specific_engine_result_cb() + * @see vc_mgr_unset_specific_engine_result_cb() + */ typedef void (*vc_mgr_specific_engine_result_cb)(const char* engine_app_id, const char* event, const char* result, void *user_data); /** @@ -277,7 +277,7 @@ typedef int (*vc_mgr_private_data_requested_cb)(const char *key, char **data, vo /* for TTS feedback */ /** - * @brief Called when engine sends audio formats necessary for playing TTS feedback + * @brief Called when engine sends audio formats necessary for playing TTS feedback. * @since_tizen 5.0 * * @param[in] rate Audio sampling rate @@ -293,7 +293,7 @@ typedef int (*vc_mgr_private_data_requested_cb)(const char *key, char **data, vo typedef void (*vc_mgr_feedback_audio_format_cb)(int rate, vc_audio_channel_e channel, vc_audio_type_e audio_type, void *user_data); /** - * @brief Called when engine sends audio streaming for TTS feedback + * @brief Called when engine sends audio streaming for TTS feedback. * @since_tizen 5.0 * * @remarks The @a buffer must be released with free() by you when you no longer need it. @@ -311,7 +311,7 @@ typedef void (*vc_mgr_feedback_audio_format_cb)(int rate, vc_audio_channel_e cha typedef void (*vc_mgr_feedback_streaming_cb)(vc_feedback_event_e event, char* buffer, int len, void *user_data); /** - * @brief Called when the vc client sends audio streaming for TTS feedback + * @brief Called when the vc client sends audio streaming for TTS feedback. * @since_tizen 5.0 * * @remarks The @a buffer must be released with free() by you when you no longer need it. @@ -345,10 +345,10 @@ typedef void (*vc_mgr_vc_tts_streaming_cb)(int pid, int utt_id, vc_feedback_even * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory * @retval #VC_ERROR_OPERATION_FAILED Operation fail - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_NONE. * @post If this function is called, the state will be #VC_STATE_INITIALIZED. @@ -367,9 +367,9 @@ int vc_mgr_initialize(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @post If this function is called, the state will be #VC_STATE_NONE. * @@ -387,9 +387,9 @@ int vc_mgr_deinitialize(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @post If this function is called, the state will be #VC_STATE_READY. @@ -408,9 +408,9 @@ int vc_mgr_prepare(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_READY. * @post If this function is called, the state will be #VC_STATE_INITIALIZED. @@ -432,11 +432,11 @@ int vc_mgr_unprepare(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_OPERATION_FAILED Operation failure * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should NOT be #VC_SERVICE_STATE_NONE. * @post This function invokes vc_supported_language_cb() for each supported language. @@ -462,12 +462,12 @@ int vc_mgr_foreach_supported_languages(vc_supported_language_cb callback, void * * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory * @retval #VC_ERROR_OPERATION_FAILED Operation failure * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should NOT be #VC_SERVICE_STATE_NONE. * @@ -487,10 +487,10 @@ int vc_mgr_get_current_language(char **language); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should NOT be #VC_SERVICE_STATE_NONE. * @@ -511,11 +511,11 @@ int vc_mgr_get_state(vc_state_e *state); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval #VC_ERROR_OPERATION_FAILED Operation failure - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY. * @@ -542,10 +542,10 @@ int vc_mgr_get_service_state(vc_service_state_e *state); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY. */ @@ -566,10 +566,10 @@ int vc_mgr_is_command_format_supported(int format, bool *support); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY. * @@ -589,9 +589,9 @@ int vc_mgr_set_command_list(vc_cmd_list_h vc_cmd_list); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_READY. * @@ -614,11 +614,11 @@ int vc_mgr_unset_command_list(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval #VC_ERROR_OPERATION_FAILED Operation failure - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY. * @@ -641,11 +641,11 @@ int vc_mgr_set_command_list_from_file(const char *file_path, int type); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval #VC_ERROR_OPERATION_FAILED Operation failure - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY. * @@ -667,11 +667,11 @@ int vc_mgr_set_preloaded_commands_from_file(const char *file_path); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval #VC_ERROR_OPERATION_FAILED Operation failure - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY and the service state should be #VC_SERVICE_STATE_READY. */ @@ -689,11 +689,11 @@ int vc_mgr_get_current_commands(vc_cmd_list_h *vc_cmd_list); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval #VC_ERROR_OPERATION_FAILED Operation failure - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY and the service state should be #VC_SERVICE_STATE_READY. * @@ -715,10 +715,10 @@ int vc_mgr_set_audio_type(const char *audio_id); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY and the service state should be #VC_SERVICE_STATE_READY. * @@ -738,10 +738,10 @@ int vc_mgr_get_audio_type(char **audio_id); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY and the service state should be #VC_SERVICE_STATE_READY. * @@ -761,10 +761,10 @@ int vc_mgr_set_recognition_mode(vc_recognition_mode_e mode); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY. * @@ -787,11 +787,11 @@ int vc_mgr_get_recognition_mode(vc_recognition_mode_e *mode); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_OUT_OF_MEMORY Not enough memory + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_OUT_OF_MEMORY Not enough memory * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The service state should be #VC_SERVICE_STATE_READY. */ @@ -813,11 +813,11 @@ int vc_mgr_set_private_data(const char *key, const char *data); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_OUT_OF_MEMORY Not enough memory + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_OUT_OF_MEMORY Not enough memory * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The service state should be #VC_SERVICE_STATE_READY. */ @@ -836,37 +836,37 @@ int vc_mgr_get_private_data(const char *key, char **data); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_OUT_OF_MEMORY Not enough memory * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The service state should be #VC_SERVICE_STATE_READY. */ int vc_mgr_do_action(vc_send_event_type_e type, char *send_event); /** -* @platform -* @brief Sends the specific engine request to the vc-service. -* @since_tizen 5.0 -* -* @privlevel platform -* @privilege %http://tizen.org/privilege/voicecontrol.manager -* -* @param[in] engine_app_id A specific engine's app id -* @param[in] event A engine service user request event -* @param[in] request A engine service user request text -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_OUT_OF_MEMORY Not enough memory -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter -* @retval #VC_ERROR_OPERATION_FAILED Operation failure -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED VC not supported -*/ + * @platform + * @brief Sends the specific engine request to the vc-service. + * @since_tizen 5.0 + * + * @privlevel platform + * @privilege %http://tizen.org/privilege/voicecontrol.manager + * + * @param[in] engine_app_id A specific engine's app id + * @param[in] event A engine service user request event + * @param[in] request A engine service user request text + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_OUT_OF_MEMORY Not enough memory + * @retval #VC_ERROR_INVALID_STATE Invalid state + * @retval #VC_ERROR_OPERATION_FAILED Operation failure + */ int vc_mgr_send_specific_engine_request(const char* engine_app_id, const char* event, const char* request); /** @@ -884,12 +884,12 @@ int vc_mgr_send_specific_engine_request(const char* engine_app_id, const char* e * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter. * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval #VC_ERROR_OPERATION_FAILED Operation failure * @retval #VC_ERROR_IN_PROGRESS_TO_RECORDING In progress to recording - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_READY and the service state should be #VC_SERVICE_STATE_READY. * @post It will invoke vc_service_state_changed_cb(), if you register a callback with vc_service_state_changed_cb(). \n @@ -913,13 +913,13 @@ int vc_mgr_start(bool exclusive_command_option); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval #VC_ERROR_OPERATION_FAILED Operation failure * @retval #VC_ERROR_IN_PROGRESS_TO_READY In progress to ready * @retval #VC_ERROR_IN_PROGRESS_TO_RECORDING In progress to recording * @retval #VC_ERROR_IN_PROGRESS_TO_PROCESSING In progress to processing - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The service state should be #VC_SERVICE_STATE_RECORDING. * @post It will invoke vc_service_state_changed_cb(), if you register a callback with vc_service_state_changed_cb(). \n @@ -928,7 +928,7 @@ int vc_mgr_start(bool exclusive_command_option); * @see vc_mgr_start() * @see vc_mgr_cancel() * @see vc_service_state_changed_cb() - * @see vc_mgr_result_cb() + * @see vc_result_cb() */ int vc_mgr_stop(void); @@ -942,14 +942,14 @@ int vc_mgr_stop(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_OUT_OF_MEMORY Not enough memory * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval #VC_ERROR_OPERATION_FAILED Operation failure * @retval #VC_ERROR_IN_PROGRESS_TO_READY In progress to ready * @retval #VC_ERROR_IN_PROGRESS_TO_RECORDING In progress to recording * @retval #VC_ERROR_IN_PROGRESS_TO_PROCESSING In progress to processing - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The service state should be #VC_SERVICE_STATE_RECORDING or #VC_SERVICE_STATE_PROCESSING. * @post It will invoke vc_service_state_changed_cb(), if you register a callback with vc_service_state_changed_cb(). \n @@ -973,10 +973,10 @@ int vc_mgr_cancel(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The service state should be #VC_SERVICE_STATE_RECORDING. * @@ -998,9 +998,9 @@ int vc_mgr_get_recording_volume(float *volume); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre vc_mgr_all_result_cb() should be called * @@ -1022,10 +1022,10 @@ int vc_mgr_set_selected_results(vc_cmd_list_h vc_cmd_list); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1044,9 +1044,9 @@ int vc_mgr_set_all_result_cb(vc_mgr_all_result_cb callback, void *user_data); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1067,10 +1067,10 @@ int vc_mgr_unset_all_result_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1089,9 +1089,9 @@ int vc_mgr_set_pre_result_cb(vc_mgr_pre_result_cb callback, void *user_data); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1100,39 +1100,42 @@ int vc_mgr_set_pre_result_cb(vc_mgr_pre_result_cb callback, void *user_data); int vc_mgr_unset_pre_result_cb(void); /** -* @brief Registers a callback function for getting specific engine result. -* @since_tizen 5.0 -* -* @param[in] callback Callback function to register -* @param[in] user_data The user data to be passed to the callback function -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED Not supported -* -* @pre The state should be #VC_STATE_INITIALIZED. -* -* @see vc_mgr_unset_specific_engine_result_cb() -*/ + * @platform + * @brief Sets a callback function for getting specific engine result. + * @since_tizen 5.0 + * + * @privlevel platform + * @privilege %http://tizen.org/privilege/voicecontrol.manager + * + * @param[in] callback Callback function to register + * @param[in] user_data The user data to be passed to the callback function + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED Not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #VC_STATE_INITIALIZED. + * + * @see vc_mgr_unset_specific_engine_result_cb() + */ int vc_mgr_set_specific_engine_result_cb(vc_mgr_specific_engine_result_cb callback, void* user_data); /** -* @brief Unregisters the specific engine result callback function. -* @since_tizen 5.0 -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED Not supported -* -* @pre The state should be #VC_STATE_INITIALIZED. -* -* @see vc_mgr_set_specific_engine_result_cb() -*/ + * @brief Unsets the specific engine result callback function. + * @since_tizen 5.0 + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED Not supported + * @retval #VC_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #VC_STATE_INITIALIZED. + * + * @see vc_mgr_set_specific_engine_result_cb() + */ int vc_mgr_unset_specific_engine_result_cb(void); /** @@ -1148,10 +1151,10 @@ int vc_mgr_unset_specific_engine_result_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1170,9 +1173,9 @@ int vc_mgr_set_result_cb(vc_result_cb callback, void *user_data); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1193,10 +1196,10 @@ int vc_mgr_unset_result_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1215,9 +1218,9 @@ int vc_mgr_set_state_changed_cb(vc_state_changed_cb callback, void *user_data); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1238,10 +1241,10 @@ int vc_mgr_unset_state_changed_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1260,9 +1263,9 @@ int vc_mgr_set_service_state_changed_cb(vc_service_state_changed_cb callback, vo * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1283,10 +1286,10 @@ int vc_mgr_unset_service_state_changed_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1305,9 +1308,9 @@ int vc_mgr_set_speech_detected_cb(vc_mgr_begin_speech_detected_cb callback, void * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1328,10 +1331,10 @@ int vc_mgr_unset_speech_detected_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1350,9 +1353,9 @@ int vc_mgr_set_current_language_changed_cb(vc_current_language_changed_cb callba * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1375,12 +1378,12 @@ int vc_mgr_unset_current_language_changed_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state * @retval $VC_ERROR_OPERATION_FAILED Operation failure * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @see vc_error_cb() */ @@ -1399,10 +1402,10 @@ int vc_mgr_get_error_message(char **err_msg); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1421,9 +1424,9 @@ int vc_mgr_set_error_cb(vc_error_cb callback, void *user_data); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1445,10 +1448,10 @@ int vc_mgr_unset_error_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1466,9 +1469,9 @@ int vc_mgr_set_dialog_request_cb(vc_mgr_dialog_request_cb callback, void *user_d * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1488,10 +1491,10 @@ int vc_mgr_unset_dialog_request_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_READY. * @@ -1511,10 +1514,10 @@ int vc_mgr_enable_command_type(int cmd_type); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_READY. * @@ -1535,14 +1538,14 @@ int vc_mgr_disable_command_type(int cmd_type); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * - * @see vc_private_data_set_cb() + * @see vc_mgr_private_data_set_cb() * @see vc_mgr_unset_private_data_set_cb() */ int vc_mgr_set_private_data_set_cb(vc_mgr_private_data_set_cb callback, void *user_data); @@ -1557,9 +1560,9 @@ int vc_mgr_set_private_data_set_cb(vc_mgr_private_data_set_cb callback, void *us * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1580,14 +1583,14 @@ int vc_mgr_unset_private_data_set_cb(void); * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported * * @pre The state should be #VC_STATE_INITIALIZED. * - * @see vc_private_data_requested_cb() + * @see vc_mgr_private_data_requested_cb() * @see vc_mgr_unset_private_data_requested_cb() */ int vc_mgr_set_private_data_requested_cb(vc_mgr_private_data_requested_cb callback, void *user_data); @@ -1602,9 +1605,9 @@ int vc_mgr_set_private_data_requested_cb(vc_mgr_private_data_requested_cb callba * * @return 0 on success, otherwise a negative error value * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1614,144 +1617,144 @@ int vc_mgr_unset_private_data_requested_cb(void); /* for TTS feedback */ /** -* @platform -* @brief Sets a callback function to be called when engine sends audio formats necessary for playing TTS feedback. -* @since_tizen 5.0 -* -* @param[in] callback Callback function to set -* @param[in] user_data The user data to be passed to the callback function -* -* @privlevel platform -* @privilege %http://tizen.org/privilege/voicecontrol.manager -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED VC not supported -* -* @pre The state should be #VC_STATE_INITIALIZED. -* -* @see vc_mgr_feedback_audio_format_cb() -* @see vc_mgr_unset_feedback_audio_format_cb() -*/ + * @platform + * @brief Sets a callback function to be called when engine sends audio formats necessary for playing TTS feedback. + * @since_tizen 5.0 + * + * @privlevel platform + * @privilege %http://tizen.org/privilege/voicecontrol.manager + * + * @param[in] callback Callback function to set + * @param[in] user_data The user data to be passed to the callback function + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #VC_STATE_INITIALIZED. + * + * @see vc_mgr_feedback_audio_format_cb() + * @see vc_mgr_unset_feedback_audio_format_cb() + */ int vc_mgr_set_feedback_audio_format_cb(vc_mgr_feedback_audio_format_cb callback, void* user_data); /** -* @platform -* @brief Unsets a callback function to be called when engine sends audio formats necessary for playing TTS feedback. -* @since_tizen 5.0 -* -* @privlevel platform -* @privilege %http://tizen.org/privilege/voicecontrol.manager -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED VC not supported -* -* @pre The state should be #VC_STATE_INITIALIZED. -* -* @see vc_mgr_feedback_audio_format_cb() -* @see vc_mgr_set_feedback_audio_format_cb() -*/ + * @platform + * @brief Unsets a callback function to be called when engine sends audio formats necessary for playing TTS feedback. + * @since_tizen 5.0 + * + * @privlevel platform + * @privilege %http://tizen.org/privilege/voicecontrol.manager + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #VC_STATE_INITIALIZED. + * + * @see vc_mgr_feedback_audio_format_cb() + * @see vc_mgr_set_feedback_audio_format_cb() + */ int vc_mgr_unset_feedback_audio_format_cb(void); /** -* @platform -* @brief Sets a callback function to be called when engine sends audio streaming for TTS feedback. -* @since_tizen 5.0 -* -* @param[in] callback Callback function to set -* @param[in] user_data The user data to be passed to the callback function -* -* @privlevel platform -* @privilege %http://tizen.org/privilege/voicecontrol.manager -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED VC not supported -* -* @pre The state should be #VC_STATE_INITIALIZED. -* -* @see vc_mgr_feedback_streaming_cb() -* @see vc_mgr_unset_feedback_streaming_cb() -*/ + * @platform + * @brief Sets a callback function to be called when engine sends audio streaming for TTS feedback. + * @since_tizen 5.0 + * + * @privlevel platform + * @privilege %http://tizen.org/privilege/voicecontrol.manager + * + * @param[in] callback Callback function to set + * @param[in] user_data The user data to be passed to the callback function + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #VC_STATE_INITIALIZED. + * + * @see vc_mgr_feedback_streaming_cb() + * @see vc_mgr_unset_feedback_streaming_cb() + */ int vc_mgr_set_feedback_streaming_cb(vc_mgr_feedback_streaming_cb callback, void* user_data); /** -* @platform -* @brief Unsets a callback function to be called when engine sends audio streaming for TTS feedback. -* @since_tizen 5.0 -* -* @privlevel platform -* @privilege %http://tizen.org/privilege/voicecontrol.manager -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED VC not supported -* -* @pre The state should be #VC_STATE_INITIALIZED. -* -* @see vc_mgr_feedback_streaming_cb() -* @see vc_mgr_set_feedback_streaming_cb() -*/ + * @platform + * @brief Unsets a callback function to be called when engine sends audio streaming for TTS feedback. + * @since_tizen 5.0 + * + * @privlevel platform + * @privilege %http://tizen.org/privilege/voicecontrol.manager + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #VC_STATE_INITIALIZED. + * + * @see vc_mgr_feedback_streaming_cb() + * @see vc_mgr_set_feedback_streaming_cb() + */ int vc_mgr_unset_feedback_streaming_cb(void); /** -* @platform -* @brief Starts getting TTS feedback streaming data from the buffer. -* @since_tizen 5.0 -* -* @remarks In order to get TTS feedback streaming data, the application should set 'vc_mgr_feedback_streaming_cb()' using vc_mgr_set_feedback_streaming_cb(). -* -* @privlevel platform -* @privilege %http://tizen.org/privilege/voicecontrol.manager -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED VC not supported -* -* @pre The state should be #VC_STATE_READY. \n -* 'vc_mgr_feedback_streaming_cb()' should be registered. -* -* @see vc_mgr_feedback_streaming_cb() -* @see vc_mgr_set_feedback_streaming_cb() -* @see vc_mgr_unset_feedback_streaming_cb() -* @see vc_mgr_stop_feedback() -*/ + * @platform + * @brief Starts getting TTS feedback streaming data from the buffer. + * @since_tizen 5.0 + * + * @privlevel platform + * @privilege %http://tizen.org/privilege/voicecontrol.manager + * + * @remarks In order to get TTS feedback streaming data, the application should set 'vc_mgr_feedback_streaming_cb()' using vc_mgr_set_feedback_streaming_cb(). + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #VC_STATE_READY. \n + * 'vc_mgr_feedback_streaming_cb()' should be registered. + * + * @see vc_mgr_feedback_streaming_cb() + * @see vc_mgr_set_feedback_streaming_cb() + * @see vc_mgr_unset_feedback_streaming_cb() + * @see vc_mgr_stop_feedback() + */ int vc_mgr_start_feedback(void); /** -* @platform -* @brief Stops getting and removes TTS feedback streaming data from the buffer. -* @since_tizen 5.0 -* -* @privlevel platform -* @privilege %http://tizen.org/privilege/voicecontrol.manager -* -* @return 0 on success, otherwise a negative error value -* @retval #VC_ERROR_NONE Successful -* @retval #VC_ERROR_INVALID_STATE Invalid state -* @retval #VC_ERROR_PERMISSION_DENIED Permission denied -* @retval #VC_ERROR_NOT_SUPPORTED VC not supported -* -* @pre The state should be #VC_STATE_READY. -* -* @see vc_mgr_feedback_streaming_cb() -* @see vc_mgr_set_feedback_streaming_cb() -* @see vc_mgr_unset_feedback_streaming_cb() -* @see vc_mgr_start_feedback() -*/ + * @platform + * @brief Stops getting and removes TTS feedback streaming data from the buffer. + * @since_tizen 5.0 + * + * @privlevel platform + * @privilege %http://tizen.org/privilege/voicecontrol.manager + * + * @return 0 on success, otherwise a negative error value + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state + * + * @pre The state should be #VC_STATE_READY. + * + * @see vc_mgr_feedback_streaming_cb() + * @see vc_mgr_set_feedback_streaming_cb() + * @see vc_mgr_unset_feedback_streaming_cb() + * @see vc_mgr_start_feedback() + */ int vc_mgr_stop_feedback(void); /** @@ -1766,11 +1769,11 @@ int vc_mgr_stop_feedback(void); * @param[in] user_data The user data to be passed to the callback function * * @return 0 on success, otherwise a negative error value - * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_INVALID_STATE Invalid state - * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. * @@ -1788,10 +1791,10 @@ int vc_mgr_set_vc_tts_streaming_cb(vc_mgr_vc_tts_streaming_cb callback, void* us * @privilege %http://tizen.org/privilege/voicecontrol.manager * * @return 0 on success, otherwise a negative error value - * @retval #VC_ERROR_NONE Successful - * @retval #VC_ERROR_NOT_SUPPORTED VC not supported - * @retval #VC_ERROR_PERMISSION_DENIED Permission denied - * @retval #VC_ERROR_INVALID_STATE Invalid state + * @retval #VC_ERROR_NONE Successful + * @retval #VC_ERROR_NOT_SUPPORTED VC not supported + * @retval #VC_ERROR_PERMISSION_DENIED Permission denied + * @retval #VC_ERROR_INVALID_STATE Invalid state * * @pre The state should be #VC_STATE_INITIALIZED. *