Skip to Content

Wiki source code of 10 - Riconoscimento vocale

Version 63.1 by administrator BDP on 2024/10/11 17:31
Hide last authors
administrator BDP 16.1 1 (% class="box infomessage" style="width:225px; padding: 5px; font-family:verdana; font-size:12px; color: #04ace3; background-color: #fafbfc;" %)
2 (((
3 [[image:acrobat-logo.png]] [[Scarica la pagina come pdf>>https://wiki.ifmgroup.it/bin/export/ifmhelpplatform/MessengerServiziBase/VoiceRecognition/?format=pdf||rel="noopener noreferrer" target="new"]]
4 )))
5
administrator BDP 59.1 6 {{box cssClass="floatinginfobox" width="300px" title="**Sommario**"}}
7 {{toc start="2" depth="3"/}}
administrator BDP 2.4 8 {{/box}}
administrator BDP 2.1 9
10
11 == GetAlfaNumCode (CGetAlfaNumCode) ==
12
administrator BDP 2.19 13 Richiede al chiamante, tramite riconoscimento vocale, il codice di identificazione alfanumerico, eseguendo un riconoscimento vocale per ogni carattere del codice. In alternativa è in grado di riconoscere anche i [[toni DTMF>>doc:Glossario.WebHome]]. E' necessario che sul sistema sia stato installato un motore di riconoscimento vocale SAPI compatibile, con relative licenze, non fornito con il Messenger oppure un motore integrato (disponibile solamente utilizzando [[LightHouse>>doc:Glossario.WebHome]]).
administrator BDP 2.1 14
administrator BDP 2.9 15
administrator BDP 2.1 16 **Parametri di Configurazione**
17
administrator BDP 50.10 18 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 59.1 19 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametri**|**Descrizione**
administrator BDP 2.11 20 |**Tipo di motore di sintesi vocale**|(((
21 Selezionare il tipo di motore tra i seguenti:
administrator BDP 2.1 22
administrator BDP 2.11 23 * SAPI (solo con PhoneSwitch, [[PBXServer>>doc:Glossario.WebHome]], [[DialServer>>doc:Glossario.WebHome]])
24 * Integrati (solo per LightHouse)
25 )))
26 |**Directory contenente i file wav/avi**|Indicare la directory, o selezionare dalla lista, tramite il pulsante //Browse//, in cui sono contenuti i messaggi che il sistema deve riprodurre al chiamante. La tabella sotto //Messaggi Disponibili //riporta l'elenco dei messaggi utilizzabili.
administrator BDP 2.12 27 |**Motore**|Selezionare il motore di riconoscimento vocale da utilizzare dal sistema. **Nota**: il suo valore dipende dai motori installati nel sistema.
28 |**Abilita Beep di avviso ad inizio riconoscimento**|Indicare se deve essere emesso un breve segnale acustico prima di ogni fase di riconoscimento vocale.
administrator BDP 2.13 29 |**Termina riconoscimento su ricezione Digit**|Indicare se la fase di riconoscimento può essere interrotta dalla pressione di un tasto dal parte dell'utente. Se abilitato, i tasti numerici entrano a far parte del codice, mentre * e # concludono l'acquisizione dei caratteri (fine del codice).
30 |**Tempo massimo di attesa (secondi)**|Se è stato selezionato un motore SAPI, specificare il tempo massimo, in secondi, di ogni fase di riconoscimento vocale. Valore predefinito: 20 secondi.
31 |**Massimo silenzio iniziale (secondi)**|Se è stato selezionato un motore integrato, specificare il periodo massimo di silenzio, in secondi, che il riconoscimento attende, prima che l'utente cominci a parlare, prima di uscire per fallimento. Valore predefinito: 20 secondi.
32 |**Soglia di affidabilità (0-100)**|Indicare un valore tra 1 e 100 che indica il grado di sicurezza con cui un carattere deve essere riconosciuto per poter essere considerato valido. Valori alti indicano maggiore precisione e, quindi, maggior probabilità di nessun riconoscimento. Valore predefinito: 70.
administrator BDP 2.14 33 |**Numero massimo tentativi**|Numero massimo di tentativi in caso di codice non valido (nessuna digitazione).
administrator BDP 2.16 34 |**Lunghezza massima dei codici**|Numero massimo di digit del codice utente. Il tasto //Assegna Valore// consente di salvare il valore indicato in una costante, oppure recuperarlo da una Transfer Property o un Call Data.
administrator BDP 12.1 35 |**File Grammatica da utilizzare**|Nome del file contenente la [[grammatica>>||anchor="HGrammatica"]] da utilizzare. Il tasto //Assegna Valore// consente di salvare il valore indicato in una costante, oppure recuperarlo da una Transfer Property o un Call Data.
administrator BDP 13.1 36 |**Nome Transfer Property**|Selezionare la [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]] in cui viene salvati il codice acquisito.
administrator BDP 2.15 37 |**Servizio successivo se riconoscimento valido**|//Solamente configurando il Servizio tramite Messenger Configurator//. Selezionare dall'elenco il servizio da attivare nel caso di codice riconosciuto e confermato dall'utente.
38 |**Servizio successivo per mancato riconoscimento**|//Solamente configurando il Servizio tramite Messenger Configurator//. Selezionare dall'elenco il servizio da attivare nel caso di codice NON riconosciuto o NON confermato dall'utente.
administrator BDP 2.7 39 | |
administrator BDP 2.1 40
administrator BDP 2.11 41 **Messaggi Disponibili**
42
administrator BDP 50.10 43 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 59.1 44 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Nome File**|**Messaggio**
administrator BDP 2.11 45 |**IntroMessage.wav**|Messaggio di accoglienza con istruzioni per l'inserimento del proprio codice.
46 |**CharNotRecognized.wav**|Comunica che il riconoscimento del carattere corrente non è andato a buon fine.
47 |**RecognizedCodeIs.wav**|Messaggio del tipo: //"Il codice riconosciuto è...".//
48 |**confirm.wav**|Messaggio del tipo: //"Premere 1 per confermare, 0 per riprovare..."//.
49 |**RepeatCode.wav**|Invita l'utente a riprovare il riconoscimento del codice dall'inizio.
50 | |
51
administrator BDP 2.4 52 ==== Grammatica ====
administrator BDP 2.1 53
administrator BDP 2.16 54 Il file contenente la definizione della grammatica utilizzata per il riconoscimento del codice dell'utente ha la struttura di un file INI con le seguenti quattro sezioni:
administrator BDP 2.1 55
administrator BDP 2.16 56 * La sezione (% style="font-family:Courier New,Courier,monospace" %)[Grammar] (%%)contiene i parametri generali della grammatica, attualmente il solo nome.
57 * La sezione (% style="font-family:Courier New,Courier,monospace" %)[List](%%) contiene le associazioni tra le parole che il sistema deve essere in grado di riconoscere ed il relativo carattere da aggiungere al codice nel caso che il sistema riconosca una certa parola.
58 * La sezione (% style="font-family:Courier New,Courier,monospace" %)[Stop](%%) indica le parole chiave che il sistema deve considerare come conclusione del codice; utili nel caso in cui i codici cliente non siano tutti della stessa lunghezza.
59 * La sezione (% style="font-family:Courier New,Courier,monospace" %)[ConfirmOptions](%%) contiene le opzioni ammesse per la conferma del codice riconosciuto dal sistema;
administrator BDP 2.1 60 ** la chiave "Confirm" indica la parola che deve essere pronunciata dal cliente per confermare il codice riconosciuto
61 ** la chiave "Cancel" indica la parola per annullare il riconoscimento e introdurre il codice dall'inizio.
62
63 **Esempio File Grammatica**
64
administrator BDP 2.17 65 (% style="background-color:#cccccc; width:600px" %)
administrator BDP 2.16 66 |(((
administrator BDP 2.19 67 (% class="small" style="font-family:Courier New,Courier,monospace" %)[Grammar](%%)
68 (% class="small" style="font-family:Courier New,Courier,monospace" %)Type=AlfaCode(%%)
69 (% class="small" style="font-family:Courier New,Courier,monospace" %)[List](%%)
70 (% class="small" style="font-family:Courier New,Courier,monospace" %)0=0(%%)
71 (% class="small" style="font-family:Courier New,Courier,monospace" %)1=1(%%)
72 (% class="small" style="font-family:Courier New,Courier,monospace" %)2=2(%%)
73 (% class="small" style="font-family:Courier New,Courier,monospace" %)3=3(%%)
74 (% class="small" style="font-family:Courier New,Courier,monospace" %)4=4(%%)
75 (% class="small" style="font-family:Courier New,Courier,monospace" %)5=5(%%)
76 (% class="small" style="font-family:Courier New,Courier,monospace" %)6=6(%%)
77 (% class="small" style="font-family:Courier New,Courier,monospace" %)7=7(%%)
78 (% class="small" style="font-family:Courier New,Courier,monospace" %)8=8(%%)
79 (% class="small" style="font-family:Courier New,Courier,monospace" %)9=9(%%)
80 (% class="small" style="font-family:Courier New,Courier,monospace" %)uno=1(%%)
81 (% class="small" style="font-family:Courier New,Courier,monospace" %)due=2(%%)
82 (% class="small" style="font-family:Courier New,Courier,monospace" %)tre=3(%%)
83 (% class="small" style="font-family:Courier New,Courier,monospace" %)quattro=4(%%)
84 (% class="small" style="font-family:Courier New,Courier,monospace" %)cinque=5(%%)
85 (% class="small" style="font-family:Courier New,Courier,monospace" %)sei=6(%%)
86 (% class="small" style="font-family:Courier New,Courier,monospace" %)sette=7(%%)
87 (% class="small" style="font-family:Courier New,Courier,monospace" %)otto=8(%%)
88 (% class="small" style="font-family:Courier New,Courier,monospace" %)nove=9(%%)
89 (% class="small" style="font-family:Courier New,Courier,monospace" %)zero=0(%%)
90 (% class="small" style="font-family:Courier New,Courier,monospace" %)a=A(%%)
91 (% class="small" style="font-family:Courier New,Courier,monospace" %)bi=B(%%)
92 (% class="small" style="font-family:Courier New,Courier,monospace" %)ci=C(%%)
93 (% class="small" style="font-family:Courier New,Courier,monospace" %)di=D(%%)
94 (% class="small" style="font-family:Courier New,Courier,monospace" %)e=E(%%)
95 (% class="small" style="font-family:Courier New,Courier,monospace" %)effe=F(%%)
96 (% class="small" style="font-family:Courier New,Courier,monospace" %)gi=G(%%)
97 (% class="small" style="font-family:Courier New,Courier,monospace" %)acca=H(%%)
98 (% class="small" style="font-family:Courier New,Courier,monospace" %)i=I(%%)
99 (% class="small" style="font-family:Courier New,Courier,monospace" %)elle=L(%%)
100 (% class="small" style="font-family:Courier New,Courier,monospace" %)emme=M(%%)
101 (% class="small" style="font-family:Courier New,Courier,monospace" %)enne=N(%%)
102 (% class="small" style="font-family:Courier New,Courier,monospace" %)o=O(%%)
103 (% class="small" style="font-family:Courier New,Courier,monospace" %)pi=P(%%)
104 (% class="small" style="font-family:Courier New,Courier,monospace" %)qu=Q(%%)
105 (% class="small" style="font-family:Courier New,Courier,monospace" %)erre=R(%%)
106 (% class="small" style="font-family:Courier New,Courier,monospace" %)esse=S(%%)
107 (% class="small" style="font-family:Courier New,Courier,monospace" %)ti=T(%%)
108 (% class="small" style="font-family:Courier New,Courier,monospace" %)u=U(%%)
109 (% class="small" style="font-family:Courier New,Courier,monospace" %)vu=V(%%)
110 (% class="small" style="font-family:Courier New,Courier,monospace" %)zeta=Z(%%)
111 (% class="small" style="font-family:Courier New,Courier,monospace" %)x=X(%%)
112 (% class="small" style="font-family:Courier New,Courier,monospace" %)y=Y(%%)
113 (% class="small" style="font-family:Courier New,Courier,monospace" %)k=K(%%)
114 (% class="small" style="font-family:Courier New,Courier,monospace" %)j=J(%%)
115 (% class="small" style="font-family:Courier New,Courier,monospace" %)w=W(%%)
116 (% class="small" style="font-family:Courier New,Courier,monospace" %)ics=X(%%)
117 (% class="small" style="font-family:Courier New,Courier,monospace" %)ipsilon=Y(%%)
118 (% class="small" style="font-family:Courier New,Courier,monospace" %)cappa=K(%%)
119 (% class="small" style="font-family:Courier New,Courier,monospace" %)vudoppia=W(%%)
120 (% class="small" style="font-family:Courier New,Courier,monospace" %)doppiavu=W(%%)
121 (% class="small" style="font-family:Courier New,Courier,monospace" %)gei=J(%%)
122 (% class="small" style="font-family:Courier New,Courier,monospace" %)ilunga=J(%%)
123 (% class="small" style="font-family:Courier New,Courier,monospace" %)igreca=Y(%%)
124 (% class="small" style="font-family:Courier New,Courier,monospace" %)Ancona=A(%%)
125 (% class="small" style="font-family:Courier New,Courier,monospace" %)Bologna=B(%%)
126 (% class="small" style="font-family:Courier New,Courier,monospace" %)Catania=C(%%)
127 (% class="small" style="font-family:Courier New,Courier,monospace" %)Domodossola=D(%%)
128 (% class="small" style="font-family:Courier New,Courier,monospace" %)Empoli=E(%%)
129 (% class="small" style="font-family:Courier New,Courier,monospace" %)Firenze=F(%%)
130 (% class="small" style="font-family:Courier New,Courier,monospace" %)Genova=G(%%)
131 (% class="small" style="font-family:Courier New,Courier,monospace" %)Hotel=H(%%)
132 (% class="small" style="font-family:Courier New,Courier,monospace" %)Imperia=I(%%)
133 (% class="small" style="font-family:Courier New,Courier,monospace" %)Livorno=L(%%)
134 (% class="small" style="font-family:Courier New,Courier,monospace" %)Milano=M(%%)
135 (% class="small" style="font-family:Courier New,Courier,monospace" %)Napoli=N(%%)
136 (% class="small" style="font-family:Courier New,Courier,monospace" %)Otranto=O(%%)
137 (% class="small" style="font-family:Courier New,Courier,monospace" %)Palermo=P(%%)
138 (% class="small" style="font-family:Courier New,Courier,monospace" %)Quadro=Q(%%)
139 (% class="small" style="font-family:Courier New,Courier,monospace" %)Roma=R(%%)
140 (% class="small" style="font-family:Courier New,Courier,monospace" %)Savona=S(%%)
141 (% class="small" style="font-family:Courier New,Courier,monospace" %)Torino=T(%%)
142 (% class="small" style="font-family:Courier New,Courier,monospace" %)Urbino=U(%%)
143 (% class="small" style="font-family:Courier New,Courier,monospace" %)Verona=V(%%)
144 (% class="small" style="font-family:Courier New,Courier,monospace" %)Zagabria=Z(%%)
145 (% class="small" style="font-family:Courier New,Courier,monospace" %)[Stop](%%)
146 (% class="small" style="font-family:Courier New,Courier,monospace" %)stop(%%)
147 (% class="small" style="font-family:Courier New,Courier,monospace" %)end(%%)
148 (% class="small" style="font-family:Courier New,Courier,monospace" %)[ConfirmOptions](%%)
149 (% class="small" style="font-family:Courier New,Courier,monospace" %)Confirm=corretto(%%)
administrator BDP 2.16 150 (% class="small" style="font-family:Courier New,Courier,monospace" %)Cancel=annulla
151 )))
administrator BDP 2.1 152
administrator BDP 17.2 153 == SpeechToText (CSpeechToText) ==
154
administrator BDP 43.2 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:
administrator BDP 17.2 156
administrator BDP 50.8 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. Nella scheda //Salvataggio scelta// è possibile salvare l'accuratezza (definita anche //confidence//) in una //transfer property// o in un //calldata.//
administrator BDP 43.2 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.
administrator BDP 50.9 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.
administrator BDP 52.2 164 * È stata aggiunta la scheda //Parametri aggiuntivi// per permettere la definizione dei parametri addizionali relativi al passaggio delle API Google dalla versione 1 alla 2.
165
administrator BDP 43.2 166
administrator BDP 50.8 167 (% class="box errormessage" %)
168 (((
administrator BDP 50.11 169 **NOTA BENE**: quando si abilita il parametro //Single Utterance// (vedere casella //Abilita riconoscimento espressione singola// nella scheda //Motore STT//), l’engine Google prevede di ricevere l’audio in un tempo relativamente breve (massimo 10/15 secondi), dopodichè termina la fase di riconoscimento. Questo può essere un problema se si abilita anche la modalità //BargeIn// (vedere casella //Abilita riconoscimento durante la play// nella scheda //Motore STT//) con un messaggio di invito con un tempo che si avvicina o supera i 10 secondi. In questo caso se l’utente aspettasse la fine del messaggio prima di pronunciare la sua scelta, l’engine Google sarebbe già uscito dalla fase di riconoscimento e non restituirebbe alcun valore. Quindi è raccomandabile di non impostare il parametro //Single Utterance// contemporaneamente al parametro //BargeIn// se il messaggio di invito dura più di due secondi.
administrator BDP 50.8 170 )))
administrator BDP 17.2 171
172
administrator BDP 36.4 173 === **Parametri di Configurazione** ===
administrator BDP 17.2 174
administrator BDP 36.4 175 ==== **Proprietà** ====
administrator BDP 26.1 176
administrator BDP 43.5 177 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//:
administrator BDP 36.4 178
administrator BDP 43.5 179 //Scheda Generale//
administrator BDP 26.1 180
administrator BDP 59.1 181 [[image:STT_skGenerale.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 20px"]]
administrator BDP 26.1 182
administrator BDP 47.2 183 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.
administrator BDP 44.3 184
administrator BDP 47.2 185 L'elenco dei campi visualizzati è il seguente:
administrator BDP 44.3 186
administrator BDP 47.2 187 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 51.1 188 (% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
administrator BDP 47.2 189 |**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.
190 |**Numero massimo di tentativi**|Indicare il numero di tentativi consentiti al chiamante, se la fase di riconoscimento non avesse successo. Valore predefinito: 2.
administrator BDP 44.3 191
administrator BDP 47.2 192 //Scheda Messaggi per TTS//
administrator BDP 44.3 193
administrator BDP 50.7 194 [[image:STT_skMess.png||height="518" 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 20px" width="400"]]
administrator BDP 47.2 195
196
administrator BDP 33.1 197 L'elenco dei campi visualizzati è il seguente:
administrator BDP 26.1 198
administrator BDP 33.1 199 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 51.1 200 (% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
administrator BDP 47.2 201 |**Testo messaggio iniziale**|Indicare nel campo il testo del messaggio introduttivo.
202 |**Testo messaggio di errore**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
administrator BDP 26.1 203
administrator BDP 47.2 204 //Scheda Messaggi per WAV//
administrator BDP 33.1 205
administrator BDP 50.7 206 [[image:WAV_skMess.png||height="518" 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 20px" width="400"]]
administrator BDP 47.2 207
administrator BDP 47.8 208 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:
administrator BDP 47.2 209
administrator BDP 33.1 210 * File
211 * Numero
212 * Importo
213 * Sequenza di caratteri
214 * Lista formattata
215 * Data/Ora
216 * Data/Ora attuale
217 * Data/Ora del file
218 * Ordinale
219
administrator BDP 47.12 220 //Scheda Motore TTS//
221
administrator BDP 50.7 222 [[image:STT_skMotoreTTS.png||height="517" 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 20px" width="400"]]
administrator BDP 47.12 223
administrator BDP 48.16 224 Impostare il campo seguente:
administrator BDP 47.12 225
226 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 51.1 227 (% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
administrator BDP 48.17 228 |**Engine Name**|Selezionare il motore di sintesi da utilizzare. L'elenco dei motori disponibili corrisponde a quelli definiti nel server TTSASR.
administrator BDP 47.12 229
administrator BDP 48.18 230 //Scheda Motore STT//
administrator BDP 33.1 231
administrator BDP 52.1 232 [[image:attach:SpeechToText.png||alt="STT_skMotoreSST.png" height="518" 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 20px" width="400"]]
administrator BDP 33.1 233
administrator BDP 35.2 234 Impostare i campi seguenti:
235
administrator BDP 17.2 236 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 51.1 237 (% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
administrator BDP 35.2 238 |**Motore di riconoscimento vocale da utilizzare**|Selezionare il motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
239 |**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//.
administrator BDP 52.1 240 |**Termina riconoscimento su ricezione digits dopo**|Selezionare per abilitare l'interruzione della play del messaggo di invito a parlare, sia riprodotto da file che tramite //TextToSpeech//. il tempo, espresso in millisecondi, indica dopo quanto deve essere terminata la fase di riconoscimento in seguito alla pressione di un digit dda parte dell'utente.
administrator BDP 49.3 241 |**Abilita beep di avviso ad inizio riconoscimento**|Selezionare per abilitare il suono di avviso nel momento di inizo del riconoscimento.
administrator BDP 49.12 242 |**Abilita riconoscimento durante la play (BargeIn)**|Selezionare se si vuole far partire il riconoscimento dell'audio già durante la riproduzione.
administrator BDP 49.6 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.
administrator BDP 49.12 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//.
administrator BDP 35.2 245 |**Tempo massimo di attesa**|Indicare il tempo massimo consentito, espresso in secondi, al chiamante per effettuare la sua scelta vocale. Valore predefinito: 30 secondi.
246 |**Soglia di affidabilità**|Indicare il livello di affidabilità, tra 0 e 100, da raggiungere per considerare il riconoscimento valido. Valore predefinito: 70.
administrator BDP 49.12 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~|//.
administrator BDP 50.5 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//.
administrator BDP 33.1 249
administrator BDP 50.5 250 //Scheda Salvataggio scelta//
administrator BDP 35.2 251
administrator BDP 50.7 252 [[image:WAV_skSalva.png||height="517" 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 20px" width="400"]]
administrator BDP 35.2 253
administrator BDP 36.2 254 Impostare i campi seguenti:
255
administrator BDP 35.2 256 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 51.1 257 (% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
administrator BDP 50.5 258 |//Salva frase riconosciuta in//|
259 |(% 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.
260 |(% style="text-align:right" %)**CallData**|Indicare il //CallData// in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
261 |//Salva confidence in//|
262 |**Nome Transfer Property**|Selezionare dall'elenco la //transfer property// in cui salvare il valore del livello di accuratezza.
263 |(% style="text-align:right" %)**CallData**|Indicare il //CallData// in cui salvare il valore del livello di accuratezza.
administrator BDP 36.2 264
administrator BDP 36.4 265 ==== Port di Uscita ====
266
administrator BDP 41.1 267 [[image:output_port.jpg||style="margin-bottom:20px; margin-top:20px"]]
administrator BDP 36.4 268
administrator BDP 41.1 269 Le funzionalità dei //Port di Uscita// del blocchetto sono le seguenti :
270
administrator BDP 36.2 271 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 51.1 272 (% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
administrator BDP 41.1 273 |**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.
274 |**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
275 |**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
administrator BDP 17.2 276
administrator BDP 37.1 277 === **Transfer Property** ===
administrator BDP 17.2 278
administrator BDP 17.3 279 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:
280
281 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
administrator BDP 51.1 282 (% style="background-color:#f0f0f0" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
administrator BDP 17.3 283 |**~_~_RecognizeResult~_~_**|Contiene l’esito della richiesta di riconoscimento.
284 |**_ASR_Source**|(((
administrator BDP 50.7 285 Contiene la sorgente dell’informazione contenuta nella Transfer Property e nel CallData definiti in configurazione. I valori possibili sono:
administrator BDP 17.3 286
administrator BDP 19.1 287 * **“”** (stringa vuota): nel caso in cui non sia riconosciuto l'audio e non sia rilevato alcun digit.
288 * **“DTMF”**: nel caso sia rilevato un digit che interrompe la fase di riconoscimento. La Transfer Property e il Call Data, eventualmente configurati come variabili di uscita, conterranno il digit ricevuto.
289 * **“STT”**: nel caso il motore di riconoscimento restituisca un qualsiasi valore. La Transfer Property e il Call Data, eventualmente configurati come variabili di uscita, conterranno il testo riconosciuto.
administrator BDP 17.3 290 )))
291
administrator BDP 2.1 292 == VoiceMenu (CVoiceMenu) ==
293
administrator BDP 3.1 294 Presenta un menu di opzioni e, in base alla scelta del chiamante, effettuata tramite il riconoscimento vocale, attiva il servizio associato. Permette di configurare la sequenza di messaggi (file wav/avi, numeri, date, ecc.) da riprodurre all'utente per invitarlo a segnalare al sistema la sua scelta.
administrator BDP 2.1 295
administrator BDP 3.1 296 E' inoltre possibile, in caso di nessuna scelta o di scelta errata, configurare un servizio predefinito. Questo servizio richiede che sul sistema sia stato installato un motore di riconoscimento vocale SAPI compatibile, con relative licenze, non fornito con il Messenger oppure un motore integrato (solo disponibile utilizzando [[LightHouse>>doc:Glossario.WebHome]]).
297
298
administrator BDP 2.1 299 **Parametri di Configurazione**
300
administrator BDP 3.2 301 |=(% style="width: 200px;" %)**Parametri**|**Descrizione**
302 |**Tipo di motore di sintesi vocale**|(((
303 Selezionare il tipo di motore tra i seguenti:
administrator BDP 2.1 304
administrator BDP 3.2 305 * //SAPI (solo con PhoneSwitch, [[PBXServer>>doc:Glossario.WebHome]], [[DialServer>>doc:Glossario.WebHome]])//
306 * //Integrati (solo per LightHouse)//
307 )))
308 |**Usa un dizionario interno al motore**|Se è stato selezionato un motore di sintesi integrato, è possibile abilitare l'uso di un dizionario interno, specificandone il folder e il nome.
309 |**Lista dei messaggi**|(((
310 Indicare la lista dei messaggi da riprodurre alla chiamante per guidarlo nella scelta. Utilizzare i tasti //Nuovo//, //Modifica//, //Cancella //e le frecce di ordine per selezionare il tipo di messaggio tra i seguenti:
administrator BDP 2.1 311
administrator BDP 3.2 312 * File WAV/AVI
313 * Numero
314 * Importo
315 * Sequenza di caratteri
316 * Lista formattata
317 * Data/Ora
318 * Data/Ora corrente
319 * Data/Ora di un file
320 * Ordinale.
administrator BDP 2.1 321
administrator BDP 3.2 322 Per ogni tipo, oltre alla selezione o al valore, occorre indicare ulteriori parametri specifici, come formato di data e ora, sequenze, decimali significativi, ecc.
323
324 Inoltre è possibile indicare eventuali parametri specifici per la lingua corrente. Questo parametro gestisce esclusivamente l'italiano e lo spagnolo. Per entrambe le lingue, se questo parametro è impostato con "F", gli ordinali sono riprodotti al femminile, in tutti gli altri casi al maschile. Solo per lo spagnolo, se questo parametro è impostato con "F", il numero 1 è riprodotto al femminile, altrimenti al maschile. Solo per l'italiano, se questo parametro è impostato con "E", l'importo è riprodotto in EURO altrimenti in Lire.
325 )))
administrator BDP 3.3 326 |**Motore del Riconoscimento Vocale**|Selezionare dalla lista il motore di riconoscimento vocale da utilizzare.
administrator BDP 4.3 327 |**Abilita Beep di avviso ad inizio riconoscimento**|Abilitato se è stato selezionato un motore integrato. Indica se deve essere emesso un breve segnale acustico prima di ogni fase di riconoscimento vocale.
328 |**Termina riconoscimento su ricezione Digits**|Abilitato se è stato selezionato un motore SAPI. Indica se la fase di riconoscimento può essere interrotta dalla pressione di un tasto dal parte dell'utente. Se abilitato, i tasti numerici entrano a far parte del codice, mentre * e # concludono l'acquisizione dei caratteri (fine del codice).
329 |**Tempo massimo di attesa (secondi)**|Abilitato se è stato selezionato un motore SAPI. Massimo periodo di silenzio, espresso in secondi, che il riconoscimento attende prima che l'utente cominci a parlare, prima di uscire per fallimento. Valore predefinito: 20 secondi.
330 |**Abilita riconoscimento durante la play (Barge ln)**|Abilitato se è stato selezionato un motore integrato. Abilita l’interruzione dei messaggi nel momento in cui l’utente pronuncia una frase, un nome o un qualsiasi comando vocale (senza attendere il “beep” di fine messaggio).
331 |**Massimo silenzio iniziale (secondi)**|Abilitato se è stato selezionato un motore integrato. Specificare il periodo massimo di silenzio, in secondi, che il riconoscimento attende, prima che l'utente cominci a parlare, prima di uscire per fallimento. Valore predefinito: 20 secondi.
administrator BDP 4.4 332 |**Look Ahead Time**|Abilitato se è stato selezionato un motore integrato. Indicare il tempo in millisecondi che l'algoritmo di riconoscimento utilizza per verificare il frame audio successivo al fine di migliorare la qualità della codifica. Valore predefinito: 800 millisecondi. Per maggiori informazioni vedere anche [[Look Ahead Time>>doc:Glossario.WebHome||anchor="HLookAheadTime" target="_blank"]].
333 |**Soglia di affidabilità (0-100)**|E' un valore tra 1 e 100 che indica il grado di sicurezza con cui un carattere deve essere riconosciuto per poter essere considerato valido. Valori alti indicano maggiore precisione e, quindi, maggior probabilità di nessun riconoscimento. Valore predefinito: 70.
334 |**Servizio da attivare a seconda della selezione**|Utilizzare i tasti //Nuovo//, //Modifica// e //Cancella// per indicare il servizio da attivare a seconda della scelta fatta dal chiamante.
335 |**Parola chiave**|Parola che l'utente deve pronunciare per attivare l'opzione. Se si indica il carattere "-", il servizio associato è quello di default attivato nel caso che nessuna delle altre condizioni sia soddisfatta al termine delle ripetizioni previste.
336 |**Digit associato**|Eventuale digit che l'utente può digitare per attivare il servizio associato.
337 |**Servizio attivato**|//Solo configurando il Servizio tramite Messenger Configurator//. Selezionare dalla lista il servizio da attivare per la particolare sequenza.
338 |**Numero massimo di tentativi**|Massimo numero di tentativi concessi all'utente per effettuare la sua scelta prima di proseguire con il servizio di default.
339 |**Messaggio di errore con invito a ripetere**|Messaggio che, in caso di mancato riconoscimento, invita l'utente a ripetere la sua scelta. Il tasto //Assegna Valore// consente di salvare il valore indicato in una costante, oppure recuperarlo da una Transfer Property o un Call Data.
340 |**Messaggio di errore su raggiungimento limite**|Messaggio di errore nel caso che si superi il numero di tentativi concessi senza aver riconosciuto con successo la scelta dell'utente. Il tasto //Assegna Valore// consente di salvare il valore indicato in una costante, oppure recuperarlo da una Transfer Property o un Call Data.
administrator BDP 13.1 341 |**Abilitazione salvataggio scelta**|Abilitare la casella per attivare il salvataggio della scelta dell'utente in una [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]].
administrator BDP 4.4 342 |**Nome Transfer Property**|Selezionare dall'elenco il nome della Transfer Property in cui salvare la scelta.
343 |**Aggiungere all'attuale valore**|Se abilitato, la scelta dell'utente viene accodata, separata da virgola, all'attuale contenuto della Transfer Property. E' possibile quindi usare una Transfer Property per memorizzare tutta la sequenza di scelta dell'utente.
344 |**Eventuale separatore**|Eventuale caratteri di separazione da inserire nella transfer property tra il valore esistente e la parola riconosciuta dal servizio.
administrator BDP 2.7 345 | |