SpeakAndGetDigits

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à.

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à.

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 di Amazon Polly o la dashboard di fatturazione.

Utilizzo di SpeakAndGetDigits action

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
            }
        }
    ]
}

Manipolazione ACTION_SUCCESSFUL 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_FAILED 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'Speakazione.

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.