/*
-* Copyright (c) 2011-2014 Samsung Electronics Co., Ltd All Rights Reserved
+* Copyright (c) 2011-2016 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
extern "C" {
#endif
-/**
+/**
* @brief Enumerations of error codes.
*/
typedef enum {
STT_SETTING_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of Memory */
STT_SETTING_ERROR_IO_ERROR = TIZEN_ERROR_IO_ERROR, /**< I/O error */
STT_SETTING_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER,/**< Invalid parameter */
- STT_SETTING_ERROR_TIMED_OUT = TIZEN_ERROR_TIMED_OUT, /**< No answer from the daemon */
+ STT_SETTING_ERROR_TIMED_OUT = TIZEN_ERROR_TIMED_OUT, /**< No answer from the service */
STT_SETTING_ERROR_OUT_OF_NETWORK = TIZEN_ERROR_NETWORK_DOWN, /**< Out of network */
STT_SETTING_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED,/**< Permission denied */
STT_SETTING_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED, /**< STT is NOT supported */
STT_SETTING_ERROR_INVALID_STATE = TIZEN_ERROR_STT | 0x01, /**< Invalid state */
STT_SETTING_ERROR_INVALID_LANGUAGE = TIZEN_ERROR_STT | 0x02, /**< Invalid language */
- STT_SETTING_ERROR_ENGINE_NOT_FOUND = TIZEN_ERROR_STT | 0x03, /**< No available engine */
+ STT_SETTING_ERROR_ENGINE_NOT_FOUND = TIZEN_ERROR_STT | 0x03, /**< No available engine */
STT_SETTING_ERROR_OPERATION_FAILED = TIZEN_ERROR_STT | 0x04, /**< Operation failed */
STT_SETTING_ERROR_NOT_SUPPORTED_FEATURE = TIZEN_ERROR_STT | 0x05 /**< Not supported feature of current engine */
-}stt_setting_error_e;
+} stt_setting_error_e;
-/**
+/**
* @brief Enumerations of setting state.
*/
typedef enum {
* @param[in] user_data User data passed from the stt_setting_foreach_supported_engines().
*
* @return @c true to continue with the next iteration of the loop, \n @c false to break out of the loop.
-* @pre stt_setting_foreach_supported_engines() will invoke this callback.
+* @pre stt_setting_foreach_supported_engines() will invoke this callback.
*
* @see stt_setting_foreach_supported_engines()
*/
*
* @param[in] engine_id Engine id.
* @param[in] language A language is specified as an ISO 3166 alpha-2 two letter country-code
-* followed by ISO 639-1 for the two-letter language code.
+* followed by ISO 639-1 for the two-letter language code.
* For example, "ko_KR" for Korean, "en_US" for American English..
* @param[in] user_data User data passed from the stt_setting_foreach_supported_languages().
*
* @return @c true to continue with the next iteration of the loop, \n @c false to break out of the loop.
-* @pre stt_setting_foreach_supported_languages() will invoke this callback.
+* @pre stt_setting_foreach_supported_languages() will invoke this callback.
*
* @see stt_setting_foreach_supported_languages()
*/
*
* @return 0 on success, otherwise a negative error value.
* @retval #STT_SETTING_ERROR_NONE Success.
-* @retval #STT_SETTING_ERROR_TIMED_OUT stt daemon is blocked or stt daemon do not exist.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT setting has Already been initialized.
+* @retval #STT_SETTING_ERROR_TIMED_OUT stt service is blocked or stt service do not exist.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT setting has Already been initialized.
* @retval #STT_SETTING_ERROR_ENGINE_NOT_FOUND No available stt-engine. Engine should be installed.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
int stt_setting_initialize(void);
/**
-* @brief finalize stt setting and disconnect to stt-daemon.
+* @brief finalize stt setting and disconnect to stt-service.
*
* @return 0 on success, otherwise a negative error value.
* @retval #STT_SETTING_ERROR_NONE Success.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
-* @post This function invokes stt_setting_supported_engine_cb() repeatedly for getting engine information.
+* @post This function invokes stt_setting_supported_engine_cb() repeatedly for getting engine information.
*
* @see stt_setting_supported_engine_cb()
*/
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_OUT_OF_MEMORY Out of memory.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
* @return 0 on success, otherwise a negative error value.
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
* @return 0 on success, otherwise a negative error value.
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
-* @post This function invokes stt_setting_supported_language_cb() repeatedly for getting supported languages.
+* @post This function invokes stt_setting_supported_language_cb() repeatedly for getting supported languages.
*
* @see stt_setting_supported_language_cb()
*/
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_OUT_OF_MEMORY Out of memory.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
* @return 0 on success, otherwise a negative error value.
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
* @return 0 on success, otherwise a negative error value.
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
* @return 0 on success, otherwise a negative error value.
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
/**
* @brief Get silence detection.
*
-* @param[out] value Value.
+* @param[out] value Value.
*
* @return 0 on success, otherwise a negative error value
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*
/**
* @brief Set silence detection.
*
-* @param[in] value Value.
+* @param[in] value Value.
*
* @return 0 on success, otherwise a negative error value
* @retval #STT_SETTING_ERROR_NONE Success.
* @retval #STT_SETTING_ERROR_INVALID_PARAMETER Invalid parameter.
-* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
+* @retval #STT_SETTING_ERROR_INVALID_STATE STT Not initialized.
* @retval #STT_SETTING_ERROR_OPERATION_FAILED Operation failure.
* @retval #STT_SETTING_ERROR_NOT_SUPPORTED STT NOT supported
*