From 11293a5eb70fd3844d3a863093250dd556b59ad0 Mon Sep 17 00:00:00 2001 From: sooyeon Date: Tue, 16 Jan 2024 16:11:13 +0900 Subject: [PATCH 1/3] Update TTS guide related to completed callback Signed-off-by: sooyeon --- .../native/guides/text-input/tts.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/application/native/guides/text-input/tts.md b/docs/application/native/guides/text-input/tts.md index 3037b40331..96bcf27e0b 100644 --- a/docs/application/native/guides/text-input/tts.md +++ b/docs/application/native/guides/text-input/tts.md @@ -262,7 +262,24 @@ To set and unset callbacks, follow these steps: - Utterance started or completed - If you add text in TTS, that text is handled as an utterance and it obtains its own ID. After you request the TTS process to start, the text is synthesized by an engine and played out. To get a notification when an utterance is started or completed, set the respective callbacks: + If you add text in TTS, that text is handled as an utterance and it obtains its own ID. After you request the TTS process to start, the text is synthesized by an engine and played out. Each callback is invoked in the following cases: + + | Callback | Invoked when | TTS state | + | :--------------------------: | :---------------------------------------: | :-------: | + | Utterance started callback | playing the synthesized audio is started | `TTS_STATE_READY` > `TTS_STATE_PLAYING` | + | Utterance completed callback | playing the synthesized audio is finished | `TTS_STATE_PLAYING` (The state is NOT changed until `tts_stop()` is called.) | + + > [!NOTE] + > Utterance completed callback is NOT invoked when + > + > (1) your application calls `tts_stop()`. + > + > (2) playing the synthesized audio is stopped by other application. + > + > Although the utterance completed callback is not invoked, a state changed callback will be invoked. (The state will be changed from `TTS_STATE_PLAYING` to `TTS_STATE_READY`.) + + + To get a notification when an utterance is started or completed, set the respective callbacks: ```cpp /* Started callback */ From 0fa890fa17611929d50039b35d77adc00c93da8c Mon Sep 17 00:00:00 2001 From: sooyeon Date: Tue, 16 Jan 2024 17:08:05 +0900 Subject: [PATCH 2/3] Update TTS C# guide related to UtteranceCompleted event handler Signed-off-by: sooyeon --- docs/application/dotnet/guides/uix/tts.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/application/dotnet/guides/uix/tts.md b/docs/application/dotnet/guides/uix/tts.md index c5ea3274a5..4f93e14103 100644 --- a/docs/application/dotnet/guides/uix/tts.md +++ b/docs/application/dotnet/guides/uix/tts.md @@ -243,7 +243,24 @@ Event handlers can be set for the following events of the [Tizen.Uix.Tts.TtsClie - Utterance started or completed - If you add text in TTS, that text is handled as an utterance and it obtains its own ID. After you request the TTS process to start, the text is synthesized by an engine and played. To get a notification when an utterance is started or completed, register event handlers for the `UtteranceStarted` and `UtteranceCompleted` events, respectively: + If you add text in TTS, that text is handled as an utterance and it obtains its own ID. After you request the TTS process to start, the text is synthesized by an engine and played. Each event handler is invoked in the following cases: + + | Event handler | Invoked when | TTS state | + | :------------------: | :---------------------------------------: | :-------: | + | `UtteranceStarted` | playing the synthesized audio is started | `Ready` > `Playing` | + | `UtteranceCompleted` | playing the synthesized audio is finished | `Playing` (The state is NOT changed until `Stop()` is called.) | + + > [!NOTE] + > `UtteranceCompleted` is NOT invoked when + > + > (1) your application calls `Stop()`. + > + > (2) playing the synthesized audio is stopped by other application. + > + > Although the `UtteranceCompleted` event handler is not invoked, a `StateChanged` event handler will be invoked. (The state will be changed from `Playing` to `Ready`.) + + + To get a notification when an utterance is started or completed, register event handlers for the `UtteranceStarted` and `UtteranceCompleted` events, respectively: ```csharp /// Utterance started event handler From 497f9520ddb5e2f2fa5b7943b6b1a79ab47f339c Mon Sep 17 00:00:00 2001 From: sooyeon Date: Thu, 16 May 2024 14:12:39 +0900 Subject: [PATCH 3/3] Change capital letters and descriptions Signed-off-by: sooyeon --- docs/application/dotnet/guides/uix/tts.md | 10 +++++----- docs/application/native/guides/text-input/tts.md | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/application/dotnet/guides/uix/tts.md b/docs/application/dotnet/guides/uix/tts.md index 4f93e14103..7beb7ef82d 100644 --- a/docs/application/dotnet/guides/uix/tts.md +++ b/docs/application/dotnet/guides/uix/tts.md @@ -247,15 +247,15 @@ Event handlers can be set for the following events of the [Tizen.Uix.Tts.TtsClie | Event handler | Invoked when | TTS state | | :------------------: | :---------------------------------------: | :-------: | - | `UtteranceStarted` | playing the synthesized audio is started | `Ready` > `Playing` | - | `UtteranceCompleted` | playing the synthesized audio is finished | `Playing` (The state is NOT changed until `Stop()` is called.) | + | `UtteranceStarted` | Playing the synthesized audio is started | `Ready` > `Playing` | + | `UtteranceCompleted` | Playing the synthesized audio is finished | `Playing` (The state is NOT changed until `Stop()` is called.) | > [!NOTE] - > `UtteranceCompleted` is NOT invoked when + > `UtteranceCompleted` is NOT invoked when the following occurs: > - > (1) your application calls `Stop()`. + > (1) Your application calls `Stop()`. > - > (2) playing the synthesized audio is stopped by other application. + > (2) Playing the synthesized audio is stopped by another application. > > Although the `UtteranceCompleted` event handler is not invoked, a `StateChanged` event handler will be invoked. (The state will be changed from `Playing` to `Ready`.) diff --git a/docs/application/native/guides/text-input/tts.md b/docs/application/native/guides/text-input/tts.md index 96bcf27e0b..8f21163777 100644 --- a/docs/application/native/guides/text-input/tts.md +++ b/docs/application/native/guides/text-input/tts.md @@ -266,15 +266,15 @@ To set and unset callbacks, follow these steps: | Callback | Invoked when | TTS state | | :--------------------------: | :---------------------------------------: | :-------: | - | Utterance started callback | playing the synthesized audio is started | `TTS_STATE_READY` > `TTS_STATE_PLAYING` | - | Utterance completed callback | playing the synthesized audio is finished | `TTS_STATE_PLAYING` (The state is NOT changed until `tts_stop()` is called.) | + | Utterance started callback | Playing the synthesized audio is started | `TTS_STATE_READY` > `TTS_STATE_PLAYING` | + | Utterance completed callback | Playing the synthesized audio is finished | `TTS_STATE_PLAYING` (The state is NOT changed until `tts_stop()` is called.) | > [!NOTE] - > Utterance completed callback is NOT invoked when + > Utterance completed callback is NOT invoked when the following occurs: > - > (1) your application calls `tts_stop()`. + > (1) Your application calls `tts_stop()`. > - > (2) playing the synthesized audio is stopped by other application. + > (2) Playing the synthesized audio is stopped by another application. > > Although the utterance completed callback is not invoked, a state changed callback will be invoked. (The state will be changed from `TTS_STATE_PLAYING` to `TTS_STATE_READY`.)