Last modified by administrator BDP on 2024/10/21 14:52

From version 36.3
edited by administrator BDP
on 2019/03/25 15:00
Change comment: There is no comment for this version
To version 50.5
edited by administrator BDP
on 2021/02/23 16:12
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -148,29 +148,62 @@
148 148  (% class="small" style="font-family:Courier New,Courier,monospace" %)Cancel=annulla
149 149  )))
150 150  
151 +
152 +
151 151  == SpeechToText (CSpeechToText) ==
152 152  
153 -Questo blocchetto permette di convertire l'audio del chiamante (parlato) in testo tramite il motore di riconoscimento vocale di Google (Google Speech API). Il testo può essere salvato in una Transfer Property o in un CallData, per potere essere analizzato/elaborato successivamente da ulteriori blocchetti impostati nel flusso della chiamata.
155 +Questo blocchetto permette di convertire l'audio del chiamante (parlato) in testo tramite il motore di riconoscimento vocale di Google (//Google Speech API//). Le sue principali funzionalità sono le seguenti:
154 154  
157 +* Utilizzare TTS o WAV per i messaggi (sia per quelli di invito a pronunciare la propria scelta sia per quello di mancato riconoscimento)
158 +* Abilitare la funzionalità di //bargeIn//, cioè far partire il riconoscimento durante il play del messaggio (indipendentemente se si usa TTS o WAV)
159 +* Restituire l’accuratezza del riconoscimento. Il motore di STT ritorna, insieme alla stringa riconosciuta anche un valore tra 0 e 100 che rappresenta la percentuale di sicurezza con cui il testo è stato riconosciuto
160 +* Abilitare il riconoscimento di espressione singola (//single utterance//). Nel caso ci si aspetti che l’utente pronunci una singola parola breve, ad esempio un //si// o un //no//, abilitare questo parametro migliora la capacità di riconoscimento del motore stesso.
161 +* Passare al motore di STT una serie di parole attese, tramite una stringa in cui i vari vocaboli sono separati da "|" (pipe). Il motore non si limita a riconoscere solo le parole contenute nella lista, ma vengono usate per migliorare la capacità di riconoscimento. Ad esempio: //“si|no|abbastanza|poco|…..”//.
162 +* In caso di errore di riconoscimento il blocchetto salva in una Transfer Property (//~_~_RecognizeErrorCode~_~_//) il codice di errore ritornato dall’engine.
163 +* Il testo può essere salvato in una Transfer Property o in un CallData, per potere essere analizzato/elaborato successivamente da ulteriori blocchetti impostati nel flusso della chiamata.
164 +
155 155  Il servizio è disponibile anche in //compatibility mode.//
156 156  
157 157  
158 -**Parametri di Configurazione**
168 +=== **Parametri di Configurazione** ===
159 159  
160 -Dalla finestra //Proprietà// del blocchetto sono visualizzate le seguenti schede:
170 +==== **Proprietà** ====
161 161  
162 -//Scheda Messaggi//
172 +Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede, che sono differenti rispetto alla scelta di utilizzare il TTS piuttosto che il file WAV nella scheda //Generale//:
163 163  
164 -[[image:STT_skMessaggi.jpg||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
174 +//Scheda Generale//
165 165  
176 +[[image:WAV_skGenerale.png||height="517" width="400"]]
177 +
178 +
179 +Selezionare la casella **Utilizzare TTS invece che messaggi WAV** per indicare che si vuole usare il TTS. In questo caso viene visualizzata anche la scheda //Motore TTS// per l'impostazione dei parametri del relativo motore. Inoltre occorre indicare anche il numero massimo di tentativi disponibili in caso di mancato riconoscimento.
180 +
166 166  L'elenco dei campi visualizzati è il seguente:
167 167  
168 168  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
169 169  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
170 -|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
185 +|**Utilizzare TTS invece che messaggi WAV**|Selezionare la casella per indicare che si vuole usare il TTS (//Text-To-Speech//). In questo caso viene visualizzata anche la scheda //Motore TTS// per l'impostazione dei parametri del relativo motore.
186 +|**Numero massimo di tentativi**|Indicare il numero di tentativi consentiti al chiamante, se la fase di riconoscimento non avesse successo. Valore predefinito: 2.
171 171  
172 -Utilizzare i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre tra i seguenti:
188 +//Scheda Messaggi per TTS//
173 173  
190 +[[image:STT_skMess.png||height="518" width="400"]]
191 +
192 +
193 +L'elenco dei campi visualizzati è il seguente:
194 +
195 +(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
196 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
197 +|**Testo messaggio iniziale**|Indicare nel campo il testo del messaggio introduttivo.
198 +|**Testo messaggio di errore**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
199 +
200 +//Scheda Messaggi per WAV//
201 +
202 +//[[image:WAV_skMess.png||height="518" width="400"]]//
203 +
204 +
205 +Caricare e selezionare dalla lista i messaggi audio da riprodurre all'utente, utilizzando i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre all'utente tra i seguenti:
206 +
174 174  * File
175 175  * Numero
176 176  * Importo
... ... @@ -181,10 +181,23 @@
181 181  * Data/Ora del file
182 182  * Ordinale
183 183  
184 -//Scheda Motore//
185 185  
186 -[[image:STT_skMotore.jpg||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
218 +//Scheda Motore TTS//
187 187  
220 +[[image:STT_skMotoreTTS.png||height="517" width="400"]]
221 +
222 +
223 +Impostare il campo seguente:
224 +
225 +(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
226 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
227 +|**Engine Name**|Selezionare il motore di sintesi da utilizzare. L'elenco dei motori disponibili corrisponde a quelli definiti nel server TTSASR.
228 +
229 +//Scheda Motore STT//
230 +
231 +[[image:STT_skMotoreSST.png||height="518" width="400"]]
232 +
233 +
188 188  Impostare i campi seguenti:
189 189  
190 190  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
... ... @@ -192,39 +192,49 @@
192 192  |**Motore di riconoscimento vocale da utilizzare**|Selezionare il motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
193 193  |**Codice Lingua**|Indicare il codice della lingua, in formato [[BCP-47>>https://it.wikipedia.org/wiki/Codice_di_lingua_IETF||rel="noopener noreferrer" target="_blank"]], da utilizzare per il riconoscimento. Valore predefinito: //it-IT//.
194 194  |**Termina riconoscimento su ricezione digits**|Selezionare se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
241 +|**Abilita beep di avviso ad inizio riconoscimento**|Selezionare per abilitare il suono di avviso nel momento di inizo del riconoscimento.
242 +|**Abilita riconoscimento durante la play (BargeIn)**|Selezionare se si vuole far partire il riconoscimento dell'audio già durante la riproduzione.
243 +|**Restituisce l'accuratezza del riconoscimento**|Selezionare se si vuole restituire al Messenger iI punteggio di confidenza del riconoscimento per confrontare l'accuratezza relativa di più alternative.
244 +|**Abilita riconoscimento espressione singola**|Selezionare si si vuole migliorare la modalità di riconoscimento di singoli comandi o parole, oppure di frasi brevi e concise, ad esempio //sì// o //no//.
195 195  |**Tempo massimo di attesa**|Indicare il tempo massimo consentito, espresso in secondi, al chiamante per effettuare la sua scelta vocale. Valore predefinito: 30 secondi.
196 196  |**Soglia di affidabilità**|Indicare il livello di affidabilità, tra 0 e 100, da raggiungere per considerare il riconoscimento valido. Valore predefinito: 70.
247 +|**Suggerimenti**|Da utilizzare per migliorare la capacità di riconoscimento di parole attese. Indicare una serie di parole separate dal carattere "~|" (pipe), ad esempio //si~|no~|abbastanza~|poco~|//.
248 +|**Parametri avanzati**|Opzionale. È possibile indicare un valore numerico dato dalla combinazione dei valori del BargeIn (1) , accuratezza (2), espressione singola (4), che corrispondono alle caselle sopra visualizzate. Espressi in questo modo possono essere configurati tramite una //transfer property// creata da blocchetti precedenti. Il valore di questo campo e i checkbox sono combinati, quindi se come parametro avanzato si imposta, ad esempio, il valore //4// (abilita espressione singola) e poi si selezionano le caselle //Abilitazione BargeIn// e //Restituisci accuratezza,// il valore finale che verrà inviato al motore di STT sarà //7//.
249 +| |
197 197  
198 -//Scheda Messaggi errore//
199 199  
200 -[[image:STT_skMessaggiErr.jpg||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
201 201  
253 +//Scheda Salvataggio scelta//
254 +
255 +[[image:WAV_skSalva.png||height="517" width="400"]]
256 +
257 +
202 202  Impostare i campi seguenti:
203 203  
204 204  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
205 205  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
206 -|**Numero massimo di tentativi**|Indicare il numero massimo di tentativi di riconoscimento. Se la fase di riconoscimento non avesse successo, indica il numero di tentativi consentiti al chiamante. Valore predefinito: 2.
207 -|**Messaggio di errore con invito a ripetere**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
262 +|//Salva frase riconosciuta in//|
263 +|(% style="text-align:right" %)**Nome Transfer Property**|Selezionare dall'elenco la //transfer property// in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
264 +|(% style="text-align:right" %)**CallData**|Indicare il //CallData// in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
265 +|//Salva confidence in//|
266 +|**Nome Transfer Property**|Selezionare dall'elenco la //transfer property// in cui salvare il valore del livello di accuratezza.
267 +|(% style="text-align:right" %)**CallData**|Indicare il //CallData// in cui salvare il valore del livello di accuratezza.
268 +|(% style="text-align:right" %) |
208 208  
209 -//Scheda Salvataggio scelta//
270 +==== Port di Uscita ====
210 210  
211 -[[image:STT_skSalvataggio.jpg||style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px"]]
272 +[[image:output_port.jpg||style="margin-bottom:20px; margin-top:20px"]]
212 212  
213 -Impostare i campi seguenti:
274 +Le funzionalità dei //Port di Uscita// del blocchetto sono le seguenti :
214 214  
215 215  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
216 216  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
217 -|**Nome Transfer Property**|Selezionare la Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
218 -|**CallData**|Indicare il CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
278 +|**Failure**|Indicare il servizio successivo da attivare nel caso in cui il motore non riconosca l'audio e non sia premuto dal chiamante alcun digit.
279 +|**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
280 +|**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
219 219  
220 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
221 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
222 -|**NextServiceFailure**|Nome del servizio successivo da attivare nel caso in cui il motore non riconosca l'audio e non sia premuto dal chiamante alcun digit.
223 -|**NextServiceDigitDetected**|Nome del servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
224 -|**NextServiceRecognized**|Nome del servizio successivo da attivare nel caso il riconoscimento abbia successo.
282 +=== **Transfer Property** ===
225 225  
226 -**Transfer Property**
227 -
228 228  Oltre alla Transfer Property definita in fase di configurazione, il blocchetto crea le due seguenti Transfer Property di sistema che possono essere eventualmente usate dai blocchetti successivi:
229 229  
230 230  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
STT_skMess.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +58.8 KB
Content
STT_skMotoreSST.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +150.6 KB
Content
STT_skMotoreTTS.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +56.1 KB
Content
WAV_skGenerale.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +15.4 KB
Content
WAV_skMess.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +76.0 KB
Content
WAV_skSalva.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +16.7 KB
Content
output_port.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +29.1 KB
Content