SpeakAndGetDigits - Amazon Chime SDK
Die SpeakAndGetDigits Aktion verwendenUmgang mit ACTION_SUCCESSING-EreignissenBehandlung von ACTION_FAILED-EreignissenVerwenden der dienstverknüpften Amazon Chime SDK Voice Connector-Rolle

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

SpeakAndGetDigits

Spielen Sie Sprache ab, indem Sie Text eingeben, und erfassen Sie zweifarbige Mehrfrequenzziffern (DTMF) vom Benutzer. Bei dem Text kann es sich entweder um Klartext oder um Text handeln, der durch Speech Synthesis Markup Language (SSML) erweitert wurde. So haben Sie mehr Kontrolle darüber, wie das Amazon Chime SDK Sprache generiert, indem es neben anderen unterstützten SSML-Funktionen Pausen hinzufügt, bestimmte Wörter betont oder den Sprechstil ändert. Tritt ein Fehler auf, z. B. wenn ein Benutzer nicht die richtige Anzahl von DTMF-Ziffern eingibt, spielt die Aktion die „Fehler“ -Sprache und dann die Hauptsprache ab, bis die SIP-Medienanwendung die imRepeat Parameter definierte Anzahl von Versuchen ausgeschöpft hat.

Das Amazon Chime SDK verwendet Amazon Polly, einen Cloud-Dienst, der Text in lebensechte Sprache umwandelt. Amazon Polly bietet sowohl eine Standard- als auch eine neuronale Engine für eine verbesserte Sprachqualität, mehr als 20 unterstützte Sprachen und 60 Stimmen. Amazon Polly stellt Sprachfunktionen kostenlos zur Verfügung, aber Sie zahlen für die Nutzung von Amazon Polly. Preisinformationen finden Sie auf der Preisseite von Amazon Polly oder in Ihrem Abrechnungs-Dashboard.

Wichtig

Die Nutzung von Amazon Polly unterliegt den AWSServicebedingungen, einschließlich der spezifischen Bedingungen für die Dienste fürAWS Machine Learning und künstliche Intelligenz.

Die SpeakAndGetDigits Aktion verwenden

Das folgende Beispiel zeigt eine typische Verwendung derSpeakAndGetDigits Aktion:

{
    "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 — DerCallId Teilnehmer am Aufruf CallDetails der Lambda-Funktion.

Zulässige Werte — A gültigcallID

Erforderlich — Ja

Standardwert — Nein

InputDigitsRegex

Beschreibung — Ein reguläres Ausdrucksmuster, das sicherstellt, dass Benutzer die richtigen Ziffern und Buchstaben eingeben.

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

Erforderlich — Nein

Standardwert – Kein

SpeechParameters.Motor

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 erforderlich, wenn Sie eine zweisprachige Stimme verwenden. Wenn eine zweisprachige Stimme verwendet wird und kein Sprachcode angegeben ist, wird die Standardsprache der zweisprachigen Stimme verwendet.

Zulässige Werte — Amazon Polly Polly-Sprachcodes

Erforderlich — Nein

Standardwert – Kein

SpeechParameters.Text

Beschreibung — Gibt den Eingabetext an. Wenn Siessml als angebenSpeechParameters.TextType, müssen Sie das SSML-Format für den Eingabetext verwenden. Weitere Informationen zu SSML finden Sie unter Generieren von Sprache aus SSML-Dokumenten im Amazon Polly Developer Guide.

Zulässige Werte — Zeichenfolge

Erforderlich — Ja

Standardwert – Kein

SpeechParameters.TextType

Beschreibung — Gibt das Textformat für anSpeechParameters.Text. Wenn nicht angegeben,text wird standardmäßig verwendet. Weitere Informationen zu SSML finden Sie unter Generieren von Sprache aus SSML-Dokumenten im Amazon Polly Developer Guide.

Zulässige Werte —ssml |text

Erforderlich — Nein

Standardwert —text

SpeechParameters.VoiceId

Beschreibung — Die ID der Amazon Polly Polly-Stimme, mit der der Text vorgelesen wurdeSpeechParameters.Text.

Zulässige Werte — Amazon Polly Voice IDs

Erforderlich — Nein

Standardwert — Joanna

FailureSpeechParameters.Motor

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

Zulässige Werte —standard |neural

Erforderlich — Nein

Standardwert — DerSpeechParameters.Engine Wert

FailureSpeechParameters.LanguageCode

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

Zulässige Werte — Amazon Polly Polly-Sprachcodes

Erforderlich — Nein

Standardwert — DerSpeechParameters.LanguageCode Wert.

FailureSpeechParameters.Text

Beschreibung — Gibt den Eingabetext an, der gesprochen wird, wenn der Kunde eine ungültige Antwort eingibt. Wenn Siessml als angebenFailureSpeechParameters.TextType, müssen Sie das SSML-Format für den Eingabetext verwenden.

Zulässige Werte — Zeichenfolge

Erforderlich — Ja

Standardwert – Kein

FailureSpeechParameters.TextType

Beschreibung — Gibt an, ob es sich bei dem in angegebenen Eingabetext um Klartext oder SSMLFailureSpeechParameters.Text handelt. Der Standardwert ist Klartext. Weitere Informationen finden Sie unter Generieren von Sprache aus SSML-Dokumenten im Amazon-Polly-Entwicklerhandbuch.

Zulässige Werte —ssml |text

Erforderlich — Nein

Standardwert — DerSpeechParameters.Text Wert

FailureSpeechParameters.VoiceId

Beschreibung — Die ID der Stimme, mit der die Zeichenfolge vorgesprochen wurdeFailureSpeechParameters.Text.

Zulässige Werte — Amazon Polly Voice IDs

Erforderlich — Ja

Standardwert — DerSpeechParameters.VoiceId Wert

MinNumberOfDigits

Beschreibung — Die Mindestanzahl von Ziffern, die erfasst werden müssen, bevor das Timeout überschritten wird oder die Meldung „Anruf fehlgeschlagen“ abgespielt wird.

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

Erforderlich — Nein

Standardwert — 0

MaxNumberOfDigits

Beschreibung — Die maximale Anzahl von Ziffern, die erfasst werden müssen, bevor ohne abschließende Ziffer angehalten wird.

Zulässige Werte — Größer alsMinNumberOfDigits

Erforderlich — Nein

Standardwert — 128

TerminatorDigits

Beschreibung — Ziffer, mit der die Eingabe beendet wird, wenn der Benutzer weniger als MaxNumberOfDigits

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

Erforderlich — Nein

Standardwert — #

InBetweenDigitsDurationInMilliseconds

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

Zulässige Werte — Größer als Null

Erforderlich — Nein

Standardwert — Wenn nicht angegeben, wird standardmäßig derRepeatDurationInMilliseconds Wert verwendet

Wiederhole

Beschreibung — Gesamtzahl der Versuche, Ziffern abzurufen. Wenn Sie diesen Parameter nicht angeben, ist standardmäßig 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 abzurufen.

Zulässige Werte — Größer als Null

Erforderlich — Ja

Standardwert – Kein

Umgang mit ACTION_SUCCESSING-Ereignissen

Das folgende Beispiel zeigt ein typischesACTION_SUCCESSFUL Ereignis.

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

Behandlung von 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 durch dieSpeak Aktion ausgelösten Fehlermeldungen aufgeführt und beschrieben.

Fehler Fehlermeldung Grund

AccessDenied

DieAWSServiceRoleForAmazonChimeVoiceConnector Rolle ist nicht korrekt konfiguriert.

Die Rolle, die verwendet wird, um Anfragen an Amazon Polly zu stellen, ist nicht vorhanden oder Berechtigungen fehlen. Um das Problem zu lösen, folgen Sie den Schritten imVerwenden der dienstverknüpften Amazon Chime SDK Voice Connector-Rolle Abschnitt

InvalidActionParameter

 

Bei der Validierung der Aktionsparameter ist ein Fehler aufgetreten. Informationen zu den verfügbaren Parametern für diese Aktion und deren Optionen finden Sie SynthesizeSpeechim Amazon Polly Developer Guide.

MissingRequiredActionParameter

Textist ein erforderlicher Parameter.

Die Aktionsparameter müssen einenText Wert haben

MissingRequiredActionParameter

Textist auf 1.000 Zeichen begrenzt

Der Text hat das Zeichenlimit überschritten.

SystemException

Systemfehler beim Ausführen der Aktion.

Beim Ausführen der Aktion ist ein Systemfehler aufgetreten.

Verwenden der dienstverknüpften Amazon Chime SDK Voice Connector-Rolle

Sie müssen keine dienstverknüpfte Rolle manuell erstellen für dieSpeak oderSpeakAndGetDigits -Aktionen erstellen. Wenn Sie eine SIP-Medienanwendung in der Amazon-Chime-SDK-KonsoleAWS Command Line Interface, der oder derAWS -API erstellen, erstellt das Amazon Chime SDK die serviceverknüpfte Rolle für Sie.

Weitere Informationen finden Sie unter Verwenden der dienstverknüpften Amazon Chime-Rolle im Amazon Chime SDK-Administratorhandbuch.