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. Consulta la pagina dei prezzi di Amazon Polly o la dashboard di fatturazione per informazioni sui prezzi.

Importante

L'uso di Amazon Polly è soggetto ai Termini di AWS servizio, inclusi i termini specifici dei Servizi di AWS Machine Learning e Intelligenza Artificiale.

Utilizzo dell'azione SpeakAndGetDigits

L'esempio seguente mostra un uso tipico dell'SpeakAndGetDigitsazione:

{
    "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 per 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 — | 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

Obbligatorio: no

Valore predefinito - nessuno

SpeechParameters.Text

Descrizione: specifica il testo di input. Se si specifica ssml comeSpeechParameters.TextType, è necessario seguire il formato SSML per il testo di input. Per ulteriori informazioni su SSML, consulta Generating Speech from SSML Documents nella Amazon Polly Developer Guide.

Valori consentiti: stringa

Obbligatorio: sì

Valore predefinito - nessuno

SpeechParameters.TextType

Descrizione: specifica il formato di testo perSpeechParameters.Text. Se non specificato, text viene utilizzato per impostazione predefinita. Per ulteriori informazioni su SSML, consulta Generating Speech from SSML Documents nella Amazon Polly Developer Guide.

Valori consentiti — | 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: ID vocali Amazon Polly

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 — | 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

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 comeFailureSpeechParameters.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 nella Amazon Polly Developer Guide.

Valori consentiti — | ssml text

Obbligatorio: no

Valore predefinito: il SpeechParameters.Text valore

FailureSpeechParameters.VoiceId

Descrizione: l'ID della voce usata per pronunciare la stringaFailureSpeechParameters.Text.

Valori consentiti: ID vocali Amazon Polly

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 # o *

Obbligatorio: no

Valore predefinito: #

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 ometti 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

Gestione degli ACTION_SUCCESSFUL eventi

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":{       
       ...
    }
}

Gestione degli ACTION_FAILED eventi

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'Speakazione.

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
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 SynthesizeSpeechla 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 SDK Administrator Guide.