Skip to Content

Changes for page 11 - Chat

Last modified by administrator BDP on 2024/10/16 17:42
From version 33.1
edited by administrator BDP
on 2019/03/25 12:46
Change comment: There is no comment for this version
To version 44.2
edited by administrator BDP
on 2019/04/19 16:04
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -10 - Riconoscimento vocale
1 +11 - Chat
Hidden
... ... @@ -1,1 +1,1 @@
1 -false
1 +true
Content
... ... @@ -8,7 +8,7 @@
8 8  {{/box}}
9 9  
10 10  
11 -== GetAlfaNumCode (CGetAlfaNumCode) ==
11 +== ReadTextMessage ==
12 12  
13 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]]).
14 14  
... ... @@ -31,7 +31,7 @@
31 31  |**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.
32 32  |**Numero massimo tentativi**|Numero massimo di tentativi in caso di codice non valido (nessuna digitazione).
33 33  |**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.
34 -|**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.
34 +|**File Grammatica da utilizzare**|Nome del file contenente la [[grammatica>>ifmhelpplatform.MessengerServiziBase.VoiceRecognition.WebHome||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.
35 35  |**Nome Transfer Property**|Selezionare la [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]] in cui viene salvati il codice acquisito.
36 36  |**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.
37 37  |**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.
... ... @@ -47,118 +47,20 @@
47 47  |**RepeatCode.wav**|Invita l'utente a riprovare il riconoscimento del codice dall'inizio.
48 48  | |
49 49  
50 -==== Grammatica ====
51 51  
52 -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:
51 +== WriteTextMessage ==
53 53  
54 -* La sezione (% style="font-family:Courier New,Courier,monospace" %)[Grammar] (%%)contiene i parametri generali della grammatica, attualmente il solo nome.
55 -* 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.
56 -* 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.
57 -* La sezione (% style="font-family:Courier New,Courier,monospace" %)[ConfirmOptions](%%) contiene le opzioni ammesse per la conferma del codice riconosciuto dal sistema;
58 -** la chiave "Confirm" indica la parola che deve essere pronunciata dal cliente per confermare il codice riconosciuto
59 -** la chiave "Cancel" indica la parola per annullare il riconoscimento e introdurre il codice dall'inizio.
53 +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.
60 60  
61 -**Esempio File Grammatica**
62 -
63 -(% style="background-color:#cccccc; width:600px" %)
64 -|(((
65 -(% class="small" style="font-family:Courier New,Courier,monospace" %)[Grammar](%%)
66 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Type=AlfaCode(%%)
67 -(% class="small" style="font-family:Courier New,Courier,monospace" %)[List](%%)
68 -(% class="small" style="font-family:Courier New,Courier,monospace" %)0=0(%%)
69 -(% class="small" style="font-family:Courier New,Courier,monospace" %)1=1(%%)
70 -(% class="small" style="font-family:Courier New,Courier,monospace" %)2=2(%%)
71 -(% class="small" style="font-family:Courier New,Courier,monospace" %)3=3(%%)
72 -(% class="small" style="font-family:Courier New,Courier,monospace" %)4=4(%%)
73 -(% class="small" style="font-family:Courier New,Courier,monospace" %)5=5(%%)
74 -(% class="small" style="font-family:Courier New,Courier,monospace" %)6=6(%%)
75 -(% class="small" style="font-family:Courier New,Courier,monospace" %)7=7(%%)
76 -(% class="small" style="font-family:Courier New,Courier,monospace" %)8=8(%%)
77 -(% class="small" style="font-family:Courier New,Courier,monospace" %)9=9(%%)
78 -(% class="small" style="font-family:Courier New,Courier,monospace" %)uno=1(%%)
79 -(% class="small" style="font-family:Courier New,Courier,monospace" %)due=2(%%)
80 -(% class="small" style="font-family:Courier New,Courier,monospace" %)tre=3(%%)
81 -(% class="small" style="font-family:Courier New,Courier,monospace" %)quattro=4(%%)
82 -(% class="small" style="font-family:Courier New,Courier,monospace" %)cinque=5(%%)
83 -(% class="small" style="font-family:Courier New,Courier,monospace" %)sei=6(%%)
84 -(% class="small" style="font-family:Courier New,Courier,monospace" %)sette=7(%%)
85 -(% class="small" style="font-family:Courier New,Courier,monospace" %)otto=8(%%)
86 -(% class="small" style="font-family:Courier New,Courier,monospace" %)nove=9(%%)
87 -(% class="small" style="font-family:Courier New,Courier,monospace" %)zero=0(%%)
88 -(% class="small" style="font-family:Courier New,Courier,monospace" %)a=A(%%)
89 -(% class="small" style="font-family:Courier New,Courier,monospace" %)bi=B(%%)
90 -(% class="small" style="font-family:Courier New,Courier,monospace" %)ci=C(%%)
91 -(% class="small" style="font-family:Courier New,Courier,monospace" %)di=D(%%)
92 -(% class="small" style="font-family:Courier New,Courier,monospace" %)e=E(%%)
93 -(% class="small" style="font-family:Courier New,Courier,monospace" %)effe=F(%%)
94 -(% class="small" style="font-family:Courier New,Courier,monospace" %)gi=G(%%)
95 -(% class="small" style="font-family:Courier New,Courier,monospace" %)acca=H(%%)
96 -(% class="small" style="font-family:Courier New,Courier,monospace" %)i=I(%%)
97 -(% class="small" style="font-family:Courier New,Courier,monospace" %)elle=L(%%)
98 -(% class="small" style="font-family:Courier New,Courier,monospace" %)emme=M(%%)
99 -(% class="small" style="font-family:Courier New,Courier,monospace" %)enne=N(%%)
100 -(% class="small" style="font-family:Courier New,Courier,monospace" %)o=O(%%)
101 -(% class="small" style="font-family:Courier New,Courier,monospace" %)pi=P(%%)
102 -(% class="small" style="font-family:Courier New,Courier,monospace" %)qu=Q(%%)
103 -(% class="small" style="font-family:Courier New,Courier,monospace" %)erre=R(%%)
104 -(% class="small" style="font-family:Courier New,Courier,monospace" %)esse=S(%%)
105 -(% class="small" style="font-family:Courier New,Courier,monospace" %)ti=T(%%)
106 -(% class="small" style="font-family:Courier New,Courier,monospace" %)u=U(%%)
107 -(% class="small" style="font-family:Courier New,Courier,monospace" %)vu=V(%%)
108 -(% class="small" style="font-family:Courier New,Courier,monospace" %)zeta=Z(%%)
109 -(% class="small" style="font-family:Courier New,Courier,monospace" %)x=X(%%)
110 -(% class="small" style="font-family:Courier New,Courier,monospace" %)y=Y(%%)
111 -(% class="small" style="font-family:Courier New,Courier,monospace" %)k=K(%%)
112 -(% class="small" style="font-family:Courier New,Courier,monospace" %)j=J(%%)
113 -(% class="small" style="font-family:Courier New,Courier,monospace" %)w=W(%%)
114 -(% class="small" style="font-family:Courier New,Courier,monospace" %)ics=X(%%)
115 -(% class="small" style="font-family:Courier New,Courier,monospace" %)ipsilon=Y(%%)
116 -(% class="small" style="font-family:Courier New,Courier,monospace" %)cappa=K(%%)
117 -(% class="small" style="font-family:Courier New,Courier,monospace" %)vudoppia=W(%%)
118 -(% class="small" style="font-family:Courier New,Courier,monospace" %)doppiavu=W(%%)
119 -(% class="small" style="font-family:Courier New,Courier,monospace" %)gei=J(%%)
120 -(% class="small" style="font-family:Courier New,Courier,monospace" %)ilunga=J(%%)
121 -(% class="small" style="font-family:Courier New,Courier,monospace" %)igreca=Y(%%)
122 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Ancona=A(%%)
123 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Bologna=B(%%)
124 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Catania=C(%%)
125 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Domodossola=D(%%)
126 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Empoli=E(%%)
127 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Firenze=F(%%)
128 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Genova=G(%%)
129 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Hotel=H(%%)
130 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Imperia=I(%%)
131 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Livorno=L(%%)
132 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Milano=M(%%)
133 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Napoli=N(%%)
134 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Otranto=O(%%)
135 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Palermo=P(%%)
136 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Quadro=Q(%%)
137 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Roma=R(%%)
138 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Savona=S(%%)
139 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Torino=T(%%)
140 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Urbino=U(%%)
141 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Verona=V(%%)
142 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Zagabria=Z(%%)
143 -(% class="small" style="font-family:Courier New,Courier,monospace" %)[Stop](%%)
144 -(% class="small" style="font-family:Courier New,Courier,monospace" %)stop(%%)
145 -(% class="small" style="font-family:Courier New,Courier,monospace" %)end(%%)
146 -(% class="small" style="font-family:Courier New,Courier,monospace" %)[ConfirmOptions](%%)
147 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Confirm=corretto(%%)
148 -(% class="small" style="font-family:Courier New,Courier,monospace" %)Cancel=annulla
149 -)))
150 -
151 -== SpeechToText (CSpeechToText) ==
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.
154 -
155 155  Il servizio è disponibile anche in //compatibility mode.//
156 156  
157 157  
158 -**Parametri di Configurazione**
58 +=== **Parametri di Configurazione** ===
159 159  
160 -Dalla finestra //Proprietà// del blocchetto sono visualizzate le seguenti schede:
60 +==== **Proprietà** ====
161 161  
62 +Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede:
63 +
162 162  //Scheda Messaggi//
163 163  
164 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"]]
... ... @@ -185,37 +185,52 @@
185 185  
186 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"]]
187 187  
90 +Impostare i campi seguenti:
91 +
188 188  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
189 189  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
190 -|**ConfidenceLevel**|Valore numerico compreso tra 0 e 100 che indica il livello di affidabilità da raggiungere per considerare il riconoscimento valido.
191 -|**RecognitionTimeout**|Tempo massimo consentito al chiamante per effettuare la sua scelta vocale.
192 -|**EngineName**|Nome del motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
193 -|**EngineLanguage**|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.
194 -|**StopOnDigit**|Flag che indica se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
195 -|**TransferProperty**|Nome della Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
196 -|**CallData**|Nome del CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
197 -|**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.
94 +|**Motore di riconoscimento vocale da utilizzare**|Selezionare il motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
95 +|**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//.
96 +|**Termina riconoscimento su ricezione digits**|Selezionare se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
97 +|**Tempo massimo di attesa**|Indicare il tempo massimo consentito, espresso in secondi, al chiamante per effettuare la sua scelta vocale. Valore predefinito: 30 secondi.
98 +|**Soglia di affidabilità**|Indicare il livello di affidabilità, tra 0 e 100, da raggiungere per considerare il riconoscimento valido. Valore predefinito: 70.
198 198  
100 +//Scheda Messaggi errore//
199 199  
102 +[[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"]]
200 200  
104 +Impostare i campi seguenti:
105 +
201 201  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
202 202  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
203 -|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
204 -|**ConfidenceLevel**|Valore numerico compreso tra 0 e 100 che indica il livello di affidabilità da raggiungere per considerare il riconoscimento valido.
205 -|**RecognitionTimeout**|Tempo massimo consentito al chiamante per effettuare la sua scelta vocale.
206 -|**EngineName**|Nome del motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
207 -|**EngineLanguage**|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.
208 -|**StopOnDigit**|Flag che indica se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
209 -|**NotRecognizedMessage**|Messaggio riprodotto in caso di mancato riconoscimento.
210 -|**MaxRetries**|Numero massimo dei tentativi di riconoscimento. Se la fase di riconoscimento non avesse successo, indica il numero di tentativi consentiti al chiamante.
211 -|**TransferProperty**|Nome della Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
212 -|**CallData**|Nome del CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
213 -|**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.
214 -|**NextServiceDigitDetected**|Nome del servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
215 -|**NextServiceRecognized**|Nome del servizio successivo da attivare nel caso il riconoscimento abbia successo.
108 +|**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.
109 +|**Messaggio di errore con invito a ripetere**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
216 216  
217 -**Transfer Property**
111 +//Scheda Salvataggio scelta//
218 218  
113 +[[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"]]
114 +
115 +Impostare i campi seguenti:
116 +
117 +(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
118 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
119 +|**Nome Transfer Property**|Selezionare la Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
120 +|**CallData**|Indicare il CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
121 +
122 +==== Port di Uscita ====
123 +
124 +[[image:output_port.jpg||style="margin-bottom:20px; margin-top:20px"]]
125 +
126 +Le funzionalità dei //Port di Uscita// del blocchetto sono le seguenti :
127 +
128 +(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
129 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
130 +|**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.
131 +|**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
132 +|**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
133 +
134 +=== **Transfer Property** ===
135 +
219 219  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:
220 220  
221 221  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
STT_skSalvataggio.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +37.7 KB
Content
output_port.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +29.1 KB
Content