speakandGetDigits

Spielen Sie Sprache ab, indem Sie Text bereitstellen und zweifarbige Multifrequenz-Ziffern (DTMF) vom Benutzer sammeln. Der Text kann entweder Nur-Text oder Speech Synthesis Markup Language (SSML) -verbesserter Text sein, um mehr Kontrolle darüber zu geben, wie Amazon Chime Sprache generiert, indem unter anderem Pausen hinzugefügt, bestimmte Wörter hervorgehoben oder den Sprechstil geändert wird. Wenn ein Fehler auftritt, z. B. ein Benutzer, der nicht die richtige Anzahl von DTMF-Ziffern eingibt, spielt die Aktion die „Failure“ -Sprache ab und wiederholt dann die Hauptrede, bis die SIP-Medienanwendung die Anzahl der in derRepeat-Parameter.

Amazon Chime verwendet Amazon Polly, einen Cloud-Dienst, der Text in lebensechte Sprache umwandelt. Amazon Polly bietet sowohl einen Standard- als auch eine neuronale Engine für eine verbesserte Sprachqualität, mehr als 20 unterstützte Sprachen und 60 Stimmen. Amazon Polly bietet kostenlos Sprachfunktionen, aber Sie bezahlen für die Verwendung von Amazon Polly. Sehen Sie das Amazon PollyPreisseiteoder Ihr Abrechnungs-Dashboard für Preisinformationen.

Wichtig

Die Verwendung von Amazon Polly unterliegt derAWSServicebedingungen, einschließlich der spezifischen Begriffe für dieAWSMachine Learning und Künstliche Intelligenz Services.

Verwendung der SpeakAndGetDigits Aktion

Das folgende Beispiel zeigt eine typische Verwendung desSpeakAndGetDigitsAktion:

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

Beschreibung— DieCallIddes Teilnehmers der CallDetails des Aufrufs der Lambda-Funktion.

Zulässige Werte— Ein gültigescallID

Erforderlich— Ja

Standardwert— Nein

InputDigitsRegex

Beschreibung— Ein Muster für reguläre Ausdrücke, um sicherzustellen, dass Benutzer die richtigen Ziffern und Buchstaben eingeben.

Zulässige Werte— Ein gültiges Muster für reguläre Ausdrücke

Erforderlich— Nein

Standardwert – Keine

SpeechParameters.Engine

Beschreibung— Gibt die Engine — Standard oder Neural — an, die bei der Verarbeitung von Text für die Sprachsynthese verwendet werden soll.

Zulässige Werte–standard|neural

Erforderlich— Nein

Standardwert— Standard

SpeechParameters.LanguageCode

Beschreibung— Gibt den Sprachcode an. Dies ist nur notwendig, wenn Sie eine zweisprachige Stimme verwenden. Wenn eine zweisprachige Stimme verwendet wird und kein Sprachcode angegeben wird, wird die Standardsprache der zweisprachigen Stimme verwendet.

Zulässige Werte–Sprachcodes für Amazon Polly

Erforderlich— Nein

Standardwert – Keine

SpeechParameters.text

Beschreibung— Gibt den Eingabetext an. Wenn Sie angebenssmlwie derSpeechParameters.TextType, müssen Sie dem SSML-Format für den Eingabetext folgen. Weitere Informationen zu SSML finden Sie unterGenerieren von Sprachausgaben aus SSML-DokumentenimEntwicklerhandbuch für Amazon Pollyaus.

Zulässige Werte– Zeichenfolge

Erforderlich— Ja

Standardwert – Keine

SpeechParameters.textType

Beschreibung— Gibt das Textformat fürSpeechParameters.Textaus. Falls nicht angegeben,textStandardmäßig wird verwendet. Weitere Informationen zu SSML finden Sie unterGenerieren von Sprachausgaben aus SSML-DokumentenimEntwicklerhandbuch für Amazon Pollyaus.

Zulässige Werte–ssml|text

Erforderlich— Nein

Standardwert–text

SpeechParameters.voiceID

Beschreibung— Die ID der Amazon Polly-Stimme, die verwendet wurde, um den Text inSpeechParameters.Textaus.

Zulässige Werte–Amazon Polly

Erforderlich— Nein

Standardwert— Joanna

FailureSpeechParameters.Engine

Beschreibung— Gibt die Engine — Standard oder Neural — an, die bei der Verarbeitung der Fehlermeldung verwendet wird, wenn der Kunde eine ungültige Antwort für die Sprachsynthese eingibt.

Zulässige Werte–standard|neural

Erforderlich— Nein

Standardwert— DieSpeechParameters.EngineWert

FailureSpeechParameters.LanguageCode

Beschreibung— Gibt den Sprachcode an, der verwendet wird, wenn der Kunde eine ungültige Antwort eingibt. Nur notwendig, wenn Sie eine zweisprachige Stimme verwenden. Wenn Sie zweisprachige Stimme verwenden, ohne einen Sprachcode anzugeben, wird die Standardsprache der zweisprachigen Stimme verwendet.

Zulässige Werte–Sprachcodes für Amazon Polly

Erforderlich— Nein

Standardwert— DieSpeechParameters.LanguageCodeWert.

FailureSpeechParameters.Text

Beschreibung— Gibt den Eingabetext an, der gesprochen wird, wenn der Kunde eine ungültige Antwort eingibt. Wenn Sie angebenssmlwie derFailureSpeechParameters.TextType, müssen Sie dem SSML-Format für den Eingabetext folgen.

Zulässige Werte– Zeichenfolge

Erforderlich— Ja

Standardwert – Keine

FailureSpeechParameters.TextType

Beschreibung— Gibt an, ob der inFailureSpeechParameters.Textist Nur-Text oder SSML. Der Standardwert ist Nur-Text. Weitere Informationen finden Sie unterGenerieren von Sprachausgaben aus SSML-DokumentenimEntwicklerhandbuch für Amazon Pollyaus.

Zulässige Werte–ssml|text

Erforderlich— Nein

Standardwert— DieSpeechParameters.TextWert

FailureSpeechParameters.voiceID

Beschreibung— Die ID für die Stimme, mit der die Zeichenfolge gesprochen wurdeFailureSpeechParameters.Textaus.

Zulässige Werte–Amazon Polly

Erforderlich— Ja

Standardwert— DieSpeechParameters.VoiceIdWert

minNumberOfDigits

Beschreibung— Die Mindestanzahl von Ziffern, die vor dem Timing Out oder Abspielen der Meldung „Anruf fehlgeschlagen“ erfasst werden sollen.

Zulässige Werte— größer als oder gleich Null

Erforderlich— Nein

Standardwert— 0

MaxNumberOfDigits

Beschreibung— Die maximale Anzahl von Ziffern, die vor dem Anhalten ohne eine abschließende Ziffer erfasst werden sollen.

Zulässige Werte— größer alsMinNumberOfDigits

Erforderlich— Nein

Standardwert— 128

TerminatorDigits

Beschreibung— Ziffer, die verwendet wird, um die Eingabe zu beenden, wenn der Benutzer weniger als MaxNumberOfDigits eingibt

Zulässige Werte— Jeder von: 0 1 2 3 4 5 6 7 8 9 # oder *

Erforderlich— Nein

Standardwert— #

InbetweenDigitsDurationInMilliseconds

Beschreibung— Die Wartezeit in Millisekunden zwischen Zifferneingaben, bevor die Failure Speech abgespielt wird.

Zulässige Werte— größer als Null

Erforderlich— Nein

Standardwert— Wenn nicht anders festgelegt, gilt der StandardwertRepeatDurationInMillisecondsWert

REPEAT

Beschreibung- Gesamtzahl der Versuche, Ziffern zu erhalten. Wenn Sie diesen Parameter nicht angeben, ist der Standardwert ein Versuch, Ziffern zu sammeln.

Zulässige Werte— größer als Null

Erforderlich— Nein

Standardwert— 1

RepeatDurationInMilliseconds

Beschreibung- Timeout in Millisekunden für jeden Versuch, Ziffern zu erhalten.

Zulässige Werte— größer als Null

Erforderlich— Ja

Standardwert – Keine

Umgang mit ACTION_SUCCESS Ereign

Das folgende Beispiel zeigt eine typischeACTION_SUCCESSFULevent.

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

Umgang mit ACTION_FAILED Ereignissen

Das folgende Beispiel zeigt ein typisches ACTION_FAILED -Ereignis.

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

Fehlerbehandlung

In dieser Tabelle werden die Fehlermeldungen aufgelistet und beschriebenSpeakAktion

Fehler	Fehlermeldung	Grund
AccessDenied	DieAWSServiceRoleForAmazonChimeVoiceConnector-Rolle ist nicht richtig konfiguriert.	Die Rolle, die verwendet wird, um Anfragen an Amazon Polly zu stellen, existiert nicht oder es fehlen Genehmigungen. Um dies zu beheben, lesen Sie die Schritte imVerwenden der serviceverknüpften Amazon Chime Voice Connector-RolleAbschnitt
InvalidActionParameter		Bei der Validierung der Aktionsparameter ist ein Fehler aufgetreten. Informationen zur Überprüfung der verfügbaren Parameter für diese Aktion und ihre Optionen finden Sie unterSynthesizeSpeechim Amazon Polly Developer Guide.
MissingRequiredActionParameter	Textist ein erforderlicher Parameter.	Die Aktionsparameter müssen eineTextWert
MissingRequiredActionParameter	Textist auf 1.000 Zeichen beschränkt	Der Text hat die Zeichengrenze überschritten.
SystemException	Systemfehler beim Ausführen der Aktion.	Beim Ausführen der Aktion ist ein Systemfehler aufgetreten.

Verwenden der serviceverknüpften Amazon Chime Voice Connector-Rolle

Sie müssen eine serviceverknüpfte Rolle nicht manuell erstellenSpeakoderSpeakAndGetDigitsAktionen. Wenn Sie eine SIP-Medienanwendung in der Amazon Chime Chime-Konsole erstellen oder aktualisieren, wird derAWS Command Line Interfaceoder dasAWSAPI, Amazon Chime erstellt die serviceverknüpfte Rolle für Sie.

Weitere Informationen finden Sie unterVerwenden der serviceverknüpften Amazon Chime -RolleimAmazon Chime -Administratorhandbuchaus.