Skip to Content

Changes for page 11 - Chat

Last modified by administrator BDP on 2024/10/16 17:42
From version 44.2
edited by administrator BDP
on 2019/04/19 16:04
Change comment: There is no comment for this version
To version 31.1
edited by administrator BDP
on 2019/03/25 12:26
Change comment: Uploaded new attachment "STT_skMessaggi.jpg", version {1}

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -11 - Chat
1 +10 - Riconoscimento vocale
Hidden
... ... @@ -1,1 +1,1 @@
1 -true
1 +false
Content
... ... @@ -8,7 +8,7 @@
8 8  {{/box}}
9 9  
10 10  
11 -== ReadTextMessage ==
11 +== GetAlfaNumCode (CGetAlfaNumCode) ==
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>>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.
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.
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,92 +47,142 @@
47 47  |**RepeatCode.wav**|Invita l'utente a riprovare il riconoscimento del codice dall'inizio.
48 48  | |
49 49  
50 +==== Grammatica ====
50 50  
51 -== WriteTextMessage ==
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:
52 52  
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.
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.
54 54  
55 -Il servizio è disponibile anche in //compatibility mode.//
61 +**Esempio File Grammatica**
56 56  
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 +)))
57 57  
58 -=== **Parametri di Configurazione** ===
151 +
59 59  
60 -==== **Proprietà** ====
153 +== SpeechToText (CSpeechToText) ==
61 61  
62 -Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede:
155 +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.
63 63  
64 -//Scheda Messaggi//
157 +Il servizio è disponibile anche in //compatibility mode.//
65 65  
66 -[[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"]]
67 67  
68 -L'elenco dei campi visualizzati è il seguente:
160 +**Parametri di Configurazione**
69 69  
70 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
71 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
72 -|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
162 +Dalla finestra //Proprietà// del blocchetto sono visualizzate le seguenti schede:
73 73  
74 -Utilizzare i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre tra i seguenti:
75 75  
76 -* File
77 -* Numero
78 -* Importo
79 -* Sequenza di caratteri
80 -* Lista formattata
81 -* Data/Ora
82 -* Data/Ora attuale
83 -* Data/Ora del file
84 -* Ordinale
85 85  
86 -//Scheda Motore//
87 87  
88 -[[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"]]
89 89  
90 -Impostare i campi seguenti:
91 -
92 92  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
93 93  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
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.
170 +|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
171 +|**ConfidenceLevel**|Valore numerico compreso tra 0 e 100 che indica il livello di affidabilità da raggiungere per considerare il riconoscimento valido.
172 +|**RecognitionTimeout**|Tempo massimo consentito al chiamante per effettuare la sua scelta vocale.
173 +|**EngineName**|Nome del motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
174 +|**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.
175 +|**StopOnDigit**|Flag che indica se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
176 +|**NotRecognizedMessage**|Messaggio riprodotto in caso di mancato riconoscimento.
177 +|**MaxRetries**|Numero massimo dei tentativi di riconoscimento. Se la fase di riconoscimento non avesse successo, indica il numero di tentativi consentiti al chiamante.
178 +|**TransferProperty**|Nome della Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
179 +|**CallData**|Nome del CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
180 +|**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.
181 +|**NextServiceDigitDetected**|Nome del servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
182 +|**NextServiceRecognized**|Nome del servizio successivo da attivare nel caso il riconoscimento abbia successo.
99 99  
100 -//Scheda Messaggi errore//
184 +**Transfer Property**
101 101  
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"]]
103 -
104 -Impostare i campi seguenti:
105 -
106 -(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
107 -(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
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.
110 -
111 -//Scheda Salvataggio scelta//
112 -
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 -
136 136  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:
137 137  
138 138  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
... ... @@ -200,3 +200,5 @@
200 200  |**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.
201 201  |**Eventuale separatore**|Eventuale caratteri di separazione da inserire nella transfer property tra il valore esistente e la parola riconosciuta dal servizio.
202 202  | |
253 +
254 +
STT_skMotore.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -50.4 KB
Content
STT_skSalvataggio.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -37.7 KB
Content
output_port.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.administrator
Size
... ... @@ -1,1 +1,0 @@
1 -29.1 KB
Content