Skip to Content

Wiki source code of 11 - Chat

Version 44.2 by administrator BDP on 2019/04/19 16:04
Show last authors
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
6 {{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}}
7 {{toc start=2 depth="3"/}}
8 {{/box}}
9
10
11 == ReadTextMessage ==
12
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
15
16 **Parametri di Configurazione**
17
18 |=(% style="width: 200px;" %)**Parametri**|**Descrizione**
19 |**Tipo di motore di sintesi vocale**|(((
20 Selezionare il tipo di motore tra i seguenti:
21
22 * SAPI (solo con PhoneSwitch, [[PBXServer>>doc:Glossario.WebHome]], [[DialServer>>doc:Glossario.WebHome]])
23 * Integrati (solo per LightHouse)
24 )))
25 |**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.
26 |**Motore**|Selezionare il motore di riconoscimento vocale da utilizzare dal sistema. **Nota**: il suo valore dipende dai motori installati nel sistema.
27 |**Abilita Beep di avviso ad inizio riconoscimento**|Indicare se deve essere emesso un breve segnale acustico prima di ogni fase di riconoscimento vocale.
28 |**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).
29 |**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.
30 |**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.
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 |**Numero massimo tentativi**|Numero massimo di tentativi in caso di codice non valido (nessuna digitazione).
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.
35 |**Nome Transfer Property**|Selezionare la [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]] in cui viene salvati il codice acquisito.
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 |**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.
38 | |
39
40 **Messaggi Disponibili**
41
42 |=(% style="width: 200px;" %)**Nome File**|**Messaggio**
43 |**IntroMessage.wav**|Messaggio di accoglienza con istruzioni per l'inserimento del proprio codice.
44 |**CharNotRecognized.wav**|Comunica che il riconoscimento del carattere corrente non è andato a buon fine.
45 |**RecognizedCodeIs.wav**|Messaggio del tipo: //"Il codice riconosciuto è...".//
46 |**confirm.wav**|Messaggio del tipo: //"Premere 1 per confermare, 0 per riprovare..."//.
47 |**RepeatCode.wav**|Invita l'utente a riprovare il riconoscimento del codice dall'inizio.
48 | |
49
50
51 == WriteTextMessage ==
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
55 Il servizio è disponibile anche in //compatibility mode.//
56
57
58 === **Parametri di Configurazione** ===
59
60 ==== **Proprietà** ====
61
62 Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede:
63
64 //Scheda Messaggi//
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
68 L'elenco dei campi visualizzati è il seguente:
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.
73
74 Utilizzare i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre tra i seguenti:
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
86 //Scheda Motore//
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
90 Impostare i campi seguenti:
91
92 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
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.
99
100 //Scheda Messaggi errore//
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 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
138 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
139 (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
140 |**~_~_RecognizeResult~_~_**|Contiene l’esito della richiesta di riconoscimento.
141 |**_ASR_Source**|(((
142 Contiene la sorgente dell’informazione contenuta nella Transfer Property e nel Call Data definiti in configurazione. I valori possibili sono:
143
144 * **“”** (stringa vuota): nel caso in cui non sia riconosciuto l'audio e non sia rilevato alcun digit.
145 * **“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.
146 * **“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.
147 )))
148
149 == VoiceMenu (CVoiceMenu) ==
150
151 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.
152
153 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]]).
154
155
156 **Parametri di Configurazione**
157
158 |=(% style="width: 200px;" %)**Parametri**|**Descrizione**
159 |**Tipo di motore di sintesi vocale**|(((
160 Selezionare il tipo di motore tra i seguenti:
161
162 * //SAPI (solo con PhoneSwitch, [[PBXServer>>doc:Glossario.WebHome]], [[DialServer>>doc:Glossario.WebHome]])//
163 * //Integrati (solo per LightHouse)//
164 )))
165 |**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.
166 |**Lista dei messaggi**|(((
167 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:
168
169 * File WAV/AVI
170 * Numero
171 * Importo
172 * Sequenza di caratteri
173 * Lista formattata
174 * Data/Ora
175 * Data/Ora corrente
176 * Data/Ora di un file
177 * Ordinale.
178
179 Per ogni tipo, oltre alla selezione o al valore, occorre indicare ulteriori parametri specifici, come formato di data e ora, sequenze, decimali significativi, ecc.
180
181 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.
182 )))
183 |**Motore del Riconoscimento Vocale**|Selezionare dalla lista il motore di riconoscimento vocale da utilizzare.
184 |**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.
185 |**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).
186 |**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.
187 |**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).
188 |**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.
189 |**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"]].
190 |**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.
191 |**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.
192 |**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.
193 |**Digit associato**|Eventuale digit che l'utente può digitare per attivare il servizio associato.
194 |**Servizio attivato**|//Solo configurando il Servizio tramite Messenger Configurator//. Selezionare dalla lista il servizio da attivare per la particolare sequenza.
195 |**Numero massimo di tentativi**|Massimo numero di tentativi concessi all'utente per effettuare la sua scelta prima di proseguire con il servizio di default.
196 |**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.
197 |**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.
198 |**Abilitazione salvataggio scelta**|Abilitare la casella per attivare il salvataggio della scelta dell'utente in una [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]].
199 |**Nome Transfer Property**|Selezionare dall'elenco il nome della Transfer Property in cui salvare la scelta.
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 |**Eventuale separatore**|Eventuale caratteri di separazione da inserire nella transfer property tra il valore esistente e la parola riconosciuta dal servizio.
202 | |