Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# SpeakAndGetDigits
Riproduci la voce inserendo del testo e raccogli le cifre a doppia frequenza (DTMF) dall'utente. Il testo può essere testo semplice o testo migliorato con Speech Synthesis Markup Language (SSML) per fornire un maggiore controllo sul modo in cui l'SDK Amazon Chime genera il parlato aggiungendo pause, enfatizzando determinate parole o cambiando lo stile di pronuncia, tra le altre funzionalità SSML supportate. Se si verifica un errore, ad esempio se un utente non inserisce il numero corretto di cifre DTMF, l'azione riproduce il discorso di «errore» e quindi riproduce il discorso principale finché l'applicazione multimediale SIP non esaurisce il numero di tentativi definito nel `Repeat` parametro.
L'SDK Amazon Chime utilizza Amazon Polly, un servizio cloud che converte il testo in voce realistica, Amazon Polly fornisce sia un motore standard che un motore neurale per una migliore qualità vocale, più di 20 lingue supportate e 60 voci. Amazon Polly fornisce funzionalità vocali gratuitamente, ma l'utilizzo di Amazon Polly è a pagamento. Per informazioni sui prezzi, consulta la [pagina dei prezzi](https://aws.amazon.com/polly/pricing/) di Amazon Polly o la dashboard di fatturazione.
**Importante**
L'uso di Amazon Polly è soggetto ai Termini di [AWS servizio, inclusi i termini](https://aws.amazon.com/service-terms/) specifici dei Servizi di AWS Machine Learning e Intelligenza Artificiale.
**Topics**
+ [Utilizzo di SpeakAndGetDigits action](#speak-digits-action)
+ [Manipolazione ACTION\$1SUCCESSFUL events](#speak-digits-success)
+ [Manipolazione ACTION\$1FAILED events](#speak-digits-fail)
+ [Utilizzo del ruolo collegato al servizio Amazon Chime SDK Voice Connector](#speak-digits-policy)
## Utilizzo di SpeakAndGetDigits action
L'esempio seguente mostra un uso tipico dell'`SpeakAndGetDigits`azione:
```
{
"SchemaVersion": "1.0",
"Actions":[
{
"Type": "SpeakAndGetDigits",
"Parameters": {
"CallId": "call-id-1", // required
"InputDigitsRegex": "^\d{2}#$", // optional
"SpeechParameters": {
"Text": "Hello World", // required
"Engine": "neural", // optional. Defaults to standard
"LanguageCode": "en-US", // optional
"TextType": "text", // optional
"VoiceId": "Joanna" // optional. Defaults to Joanna
},
"FailureSpeechParameters": {
"Text": "Hello World", // required
"Engine": "neural", // optional. Defaults to the Engine value in SpeechParameters
"LanguageCode": "en-US", // optional. Defaults to the LanguageCode value in SpeechParameters
"TextType": "text", // optional. Defaults to the TextType value in SpeechParameters
"VoiceId": "Joanna" // optional. Defaults to the VoiceId value in SpeechParameters
},
"MinNumberOfDigits": 3, // optional
"MaxNumberOfDigits": 5, // optional
"TerminatorDigits": ["#"], // optional
"InBetweenDigitsDurationInMilliseconds": 5000, // optional
"Repeat": 3, // optional
"RepeatDurationInMilliseconds": 10000 // required
}
}
]
}
```
**CallId**
*Descrizione*: il `CallId` partecipante alla chiamata CallDetails della funzione Lambda.
*Valori consentiti*: un valore valido `callID`
*Obbligatorio*: Sì
*Valore predefinito*: No
**InputDigitsRegex**
*Descrizione*: un modello di espressione regolare che aiuta a garantire che gli utenti inseriscano le cifre e le lettere corrette.
*Valori consentiti*: un modello di espressione regolare valido
*Obbligatorio*: no
*Valore predefinito* - nessuno
**SpeechParameters.Engine**
*Descrizione*: specifica il motore, standard o neurale, da utilizzare durante l'elaborazione del testo per la sintesi vocale.
*Valori consentiti* — \$1 `standard` `neural`
*Obbligatorio*: no
*Valore predefinito*: Standard
**SpeechParameters.LanguageCode**
*Descrizione*: specifica il codice della lingua. Questa operazione è necessaria solo se si utilizza una voce bilingue. Se viene utilizzata una voce bilingue e non viene specificato alcun codice linguistico, viene utilizzata la lingua predefinita della voce bilingue.
*Valori consentiti*: [codici di lingua Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html#polly-SynthesizeSpeech-request-LanguageCode)
*Obbligatorio*: no
*Valore predefinito* - nessuno
**SpeechParameters.Text**
*Descrizione*: specifica il testo di input. Se si specifica `ssml` come`SpeechParameters.TextType`, è necessario seguire il formato SSML per il testo di input. *Per ulteriori informazioni su SSML, consulta [Generating Speech from SSML Documents](https://docs.aws.amazon.com/polly/latest/dg/ssml.html) nella Amazon Polly Developer Guide.*
*Valori consentiti: stringa*
*Obbligatorio*: sì
*Valore predefinito* - nessuno
**SpeechParameters.TextType**
*Descrizione*: specifica il formato di testo per`SpeechParameters.Text`. Se non specificato, `text` viene utilizzato per impostazione predefinita. *Per ulteriori informazioni su SSML, consulta [Generating Speech from SSML Documents](https://docs.aws.amazon.com/polly/latest/dg/ssml.html) nella Amazon Polly Developer Guide.*
*Valori consentiti — \$1* `ssml` `text`
*Obbligatorio*: no
*Valore predefinito*: `text`
**SpeechParameters.VoiceId**
*Descrizione*: l'ID della voce di Amazon Polly utilizzata per la pronuncia del testo. `SpeechParameters.Text`
*Valori consentiti* — [Amazon Polly voice IDs](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html#polly-SynthesizeSpeech-request-VoiceId)
*Obbligatorio*: no
*Valore predefinito*: Joanna
**FailureSpeechParameters.Engine**
*Descrizione*: specifica il motore, standard o neurale, da utilizzare per l'elaborazione del messaggio di errore utilizzato quando il cliente immette una risposta non valida per la sintesi vocale.
*Valori consentiti* — \$1 `standard` `neural`
*Obbligatorio*: no
*Valore predefinito*: il `SpeechParameters.Engine` valore
**FailureSpeechParameters.LanguageCode**
*Descrizione*: specifica il codice della lingua utilizzato quando il cliente inserisce una risposta non valida. Necessario solo quando si utilizza una voce bilingue. Se si utilizza la voce bilingue senza specificare un codice linguistico, viene utilizzata la lingua predefinita della voce bilingue.
*Valori consentiti*: [codici di lingua Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html#polly-SynthesizeSpeech-request-LanguageCode)
*Obbligatorio*: no
*Valore predefinito*: il `SpeechParameters.LanguageCode` valore.
**FailureSpeechParameters.Text**
*Descrizione*: specifica il testo di input pronunciato quando il cliente inserisce una risposta non valida. Se si specifica `ssml` come`FailureSpeechParameters.TextType`, è necessario seguire il formato SSML per il testo di input.
*Valori consentiti*: stringa
*Obbligatorio*: sì
*Valore predefinito* - nessuno
**FailureSpeechParameters.TextType**
*Descrizione*: specifica se il testo di input specificato in `FailureSpeechParameters.Text` è testo semplice o SSML. Il valore di default è testo normale. Per ulteriori informazioni, consulta [Generating Speech from SSML Documents](https://docs.aws.amazon.com/polly/latest/dg/ssml.html) nella *Amazon Polly Developer Guide*.
*Valori consentiti* — \$1 `ssml` `text`
*Obbligatorio*: no
*Valore predefinito*: il `SpeechParameters.Text` valore
**FailureSpeechParameters.VoiceId**
*Descrizione*: l'ID della voce usata per pronunciare la stringa`FailureSpeechParameters.Text`.
*Valori consentiti* — [Amazon Polly voice IDs](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html#polly-SynthesizeSpeech-request-VoiceId)
*Obbligatorio*: Sì
*Valore predefinito*: il `SpeechParameters.VoiceId` valore
**MinNumberOfDigits**
*Descrizione*: il numero minimo di cifre da acquisire prima del timeout o della riproduzione del messaggio «chiamata non riuscita».
*Valori consentiti*: maggiori o uguali a zero
*Obbligatorio*: no
*Valore predefinito*: 0
**MaxNumberOfDigits**
*Descrizione*: il numero massimo di cifre da acquisire prima di interrompere l'operazione senza una cifra di terminazione.
*Valori consentiti*: maggiori di `MinNumberOfDigits`
*Obbligatorio*: no
*Valore predefinito*: 128
**TerminatorDigits**
*Descrizione*: cifra utilizzata per terminare l'immissione se l'utente immette meno di MaxNumberOfDigits
*Valori consentiti*: uno qualsiasi tra: 0 1 2 3 4 5 6 7 8 9 \$1 o \$1
*Obbligatorio*: no
*Valore predefinito*: \$1
**InBetweenDigitsDurationInMilliseconds**
*Descrizione*: il tempo di attesa in millisecondi tra gli input numerici prima di riprodurre il discorso di errore.
*Valori consentiti*: maggiori di zero
*Obbligatorio*: no
*Valore predefinito*: se non specificato, il valore predefinito è il valore `RepeatDurationInMilliseconds`
**Repeat**
*Descrizione*: numero totale di tentativi di acquisizione di cifre. Se si omette questo parametro, l'impostazione predefinita è un tentativo di raccogliere cifre.
*Valori consentiti*: maggiori di zero
*Obbligatorio*: no
*Valore predefinito*: 1
**RepeatDurationInMilliseconds**
*Descrizione*: timeout in millisecondi per ogni tentativo di ottenere cifre.
*Valori consentiti*: maggiori di zero
*Obbligatorio*: Sì
*Valore predefinito* - nessuno
## Manipolazione ACTION\$1SUCCESSFUL events
L'esempio seguente mostra un `ACTION_SUCCESSFUL` evento tipico.
```
{
"SchemaVersion": "1.0",
"Sequence": 3,
"InvocationEventType": "ACTION_SUCCESSFUL",
"ActionData": {
"Type": "SpeakAndGetDigits",
"Parameters": {
"CallId": "call-id-1",
"InputDigitsRegex": "^\d{2}#$",
"SpeechParameters": {
"Engine": "neural",
"LanguageCode": "en-US",
"Text": "Hello World",
"TextType": "text",
"VoiceId": "Joanna"
},
"FailureSpeechParameters": {
"Engine": "neural",
"LanguageCode": "en-US",
"Text": "Hello World",
"TextType": "text",
"VoiceId": "Joanna"
},
"MinNumberOfDigits": 3,
"MaxNumberOfDigits": 5,
"TerminatorDigits": ["#"],
"InBetweenDigitsDurationInMilliseconds": 5000,
"Repeat": 3,
"RepeatDurationInMilliseconds": 10000
},
"ReceivedDigits": "1234"
},
"CallDetails":{
...
}
}
```
## Manipolazione ACTION\$1FAILED events
L'esempio seguente mostra un `ACTION_FAILED` evento tipico.
```
{
"SchemaVersion": "1.0",
"Sequence":2,
"InvocationEventType": "ACTION_FAILED",
"ActionData":{
"Type": "SpeakAndGetDigits",
"Parameters": {
"CallId": "call-id-1",
"InputDigitsRegex": "^\d{2}#$",
"SpeechParameters": {
"Engine": "neural",
"LanguageCode": "en-US",
"Text": "Hello World",
"TextType": "text",
"VoiceId": "Joanna"
},
"FailureSpeechParameters": {
"Engine": "neural",
"LanguageCode": "en-US",
"Text": "Hello World",
"TextType": "text",
"VoiceId": "Joanna"
},
"MinNumberOfDigits": 3,
"MaxNumberOfDigits": 5,
"TerminatorDigits": ["#"],
"InBetweenDigitsDurationInMilliseconds": 5000,
"Repeat": 3,
"RepeatDurationInMilliseconds": 10000
},
"ErrorType": "SystemException",
"ErrorMessage": "System error while running action"
},
"CallDetails":{
...
}
}
```
**Gestione degli errori**
Questa tabella elenca e descrive i messaggi di errore generati dall'`Speak`azione.
| Errore | Messaggio | Motivo |
| --- | --- | --- |
| `AccessDenied` | Il `AWSServiceRoleForAmazonChimeVoiceConnector` ruolo non è configurato correttamente. | Il ruolo utilizzato per effettuare richieste ad Amazon Polly non esiste o non dispone delle autorizzazioni. Per risolvere il problema, consulta i passaggi indicati nella sezione [Utilizzo del ruolo collegato al servizio Amazon Chime SDK Voice Connector](#speak-digits-policy) |
| `InvalidActionParameter` | | Si è verificato un errore durante la convalida dei parametri dell'azione. Per esaminare i parametri disponibili per questa azione e le relative opzioni, consulta [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html)la Amazon Polly Developer Guide. |
| `MissingRequiredActionParameter` | `Text`è un parametro obbligatorio. | I parametri di azione devono avere un `Text` valore |
| `MissingRequiredActionParameter` | `Text`è limitato a 1.000 caratteri | Il testo ha superato il limite di caratteri. |
| `SystemException` | Errore di sistema durante l'esecuzione dell'azione. | Si è verificato un errore di sistema durante l'esecuzione dell'azione. |
## Utilizzo del ruolo collegato al servizio Amazon Chime SDK Voice Connector
Non è necessario creare manualmente un ruolo collegato al servizio per le azioni o. `Speak` `SpeakAndGetDigits` Quando crei o aggiorni un'applicazione multimediale SIP nella console Amazon Chime SDK, o nell'API, AWS Command Line Interface l'SDK Amazon Chime crea AWS il ruolo collegato al servizio per te.
*Per ulteriori informazioni, consulta [Using the Amazon Chime service-linked role nella Amazon Chime](https://docs.aws.amazon.com/chime/latest/ag/using-service-linked-roles-stream.html) SDK Administrator Guide.*