X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=doc%2Fuix_tts_doc.h;h=8a66ee955ae9542ce4a130d65d39d97b4904f567;hb=60289108d257c1e6620f97663eff41cc3e789a86;hp=07ce89a4fefed0b386534b5b098292d65a9cfed4;hpb=321c0e26716c44630c993044c656f8e13958487a;p=platform%2Fcore%2Fuifw%2Ftts.git diff --git a/doc/uix_tts_doc.h b/doc/uix_tts_doc.h index 07ce89a..8a66ee9 100644 --- a/doc/uix_tts_doc.h +++ b/doc/uix_tts_doc.h @@ -18,18 +18,17 @@ #ifndef __TIZEN_UIX_TTS_DOC_H__ #define __TIZEN_UIX_TTS_DOC_H__ + /** - * @defgroup CAPI_UIX_TTS_MODULE TTS * @ingroup CAPI_UIX_FRAMEWORK + * @defgroup CAPI_UIX_TTS_MODULE TTS * @brief The @ref CAPI_UIX_TTS_MODULE API provides functions for synthesizing voice from text and playing synthesized sound data. - * * @section CAPI_UIX_TTS_MODULE_HEADER Required Header - * \#include + * \#include * * @section CAPI_UIX_TTS_MODULE_OVERVIEW Overview * You can use Text-To-Speech (TTS) API to read sound data transformed by the engine from input texts. * Applications can add input-text to queue for reading continuously and control the player that can play, pause, and stop sound data synthesized from text. - * * To use TTS, follow these steps:
* 1. Create a handle
* 2. Register callback functions for notifications
@@ -40,11 +39,10 @@ * 7. Resume the player
* 8. Stop the player
* 9. Destroy a handle
- * * The TTS API also notifies you (by callback mechanism) when the state of TTS is changed, - * utterance is started and completed, default voice is changed or an error occured. + * utterance is started and completed, default voice is changed or an error occurred. * An application should register callback functions: tts_state_changed_cb(), tts_utterance_started_cb(), - * tts_utterance_completed_cb(), tts_default_voice_changed_cb(), tts_error_cb(). + * tts_utterance_completed_cb(), tts_default_voice_changed_cb(), tts_error_cb(), tts_engine_changed_cb(). * * @section CAPI_UIX_TTS_MODULE_STATE_DIAGRAM State Diagram * The following diagram shows the life cycle and the states of the TTS. @@ -59,10 +57,9 @@ * The following table shows previous state and post state of main function. * It can be known what precondition is and which synchronous type is. * Please check both previous state and post state from the table carefully. - * In case of tts_prepare() function, state doesn't be changed at once, but acynchronously. + * In case of tts_prepare() function, state doesn't be changed at once, but asynchronously. * From the above state diagram, you can see dotted line as asynchronous api. - * In this case, the state changed callback is only way to know state transition as ready. - * + * In this case, the state changed callback is only way to know state transition as ready. * * * @@ -100,7 +97,6 @@ * The following table shows state-dependent function calls. * It is forbidden to call functions listed below in wrong states. * Violation of this rule may result in an unpredictable behavior. - * *
FUNCTION
* * @@ -163,6 +159,21 @@ * * * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * * * * @@ -193,7 +204,9 @@ * tts_set_default_voice_changed_cb()
* tts_unset_default_voice_changed_cb()
* tts_set_error_cb()
- * tts_unset_error_cb() + * tts_unset_error_cb()
+ * tts_set_engine_changed_cb()
+ * tts_unset_engine_changed_cb() * * * @@ -201,14 +214,13 @@ * * @section CAPI_UIX_TTS_MODULE_FEATURE Related Features * This API is related with the following features:
- * - http://tizen.org/feature/speech.synthesis
- * + * - http://tizen.org/feature/speech.synthesis
* It is recommended to design feature related codes in your application for reliability.
* You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.
* To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
- * More details on featuring your application can be found from Feature Element. - * + * More details on featuring your application can be found from Feature Element. */ + #endif /* __TIZEN_UIX_TTS_DOC_H__ */
FUNCTION
tts_set_credential()Created, Ready
tts_set_private_data()
tts_get_private_data()
Ready
tts_get_error_message()Created, Ready, Recording, ProcessingThis function should be called during TTS error callback.
tts_add_text()Ready, Playing, PausedCreated All callback function should be registered in Created state