SpeakAndGetDigits

Spielen Sie Sprache ab, indem Sie Text eingeben, und erfassen Sie DTMF-Ziffern (Dual Tone Multifrequency) vom Benutzer. Bei dem Text kann es sich entweder um reinen Text oder um Text handeln, der durch die Sprachsynthese Markup Language (SSML) erweitert wurde, sodass Sie mehr Kontrolle darüber haben, wie das Amazon Chime SDK Sprache generiert, indem unter anderem Pausen hinzugefügt, bestimmte Wörter hervorgehoben oder der Sprechstil geändert wird. Wenn ein Fehler auftritt, z. B. wenn ein Benutzer nicht die richtige Anzahl von DTMF-Ziffern eingibt, spielt die Aktion die „Fehler“ -Sprache und dann die Hauptsprache erneut ab, bis die SIP-Medienanwendung die im Repeat Parameter definierte Anzahl von Versuchen ausgeschöpft hat.

Das Amazon Chime SDK verwendet Amazon Polly, einen Cloud-Dienst, der Text in naturgetreue Sprache umwandelt. Amazon Polly bietet sowohl eine Standard- als auch eine neuronale Engine für 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 AWS Servicebedingungen, einschließlich der spezifischen Bedingungen für die Dienste für AWS Machine Learning und künstliche Intelligenz.

Verwendung der Aktion SpeakAndGetDigits

Das folgende Beispiel zeigt eine typische Verwendung der SpeakAndGetDigits 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 — Der CallId Teilnehmer am Aufruf CallDetails der Lambda-Funktion.

Zulässige Werte — A gültig callID

Erforderlich — Ja

Standardwert — Nein

InputDigitsRegex

Beschreibung — Ein Muster für reguläre Ausdrücke, mit dem sichergestellt werden soll, dass Benutzer die richtigen Zahlen und Buchstaben eingeben.

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

Erforderlich — Nein

Standardwert – Kein

SpeechParameters.Engine

Beschreibung — Gibt an, welche Engine (Standard oder neuronal) 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 Sie ssml als angebenSpeechParameters.TextType, müssen Sie das SSML-Format für den Eingabetext verwenden. Weitere Informationen zu SSML finden Sie unter Generating Speech from 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 es standardmäßig verwendet. Weitere Informationen zu SSML finden Sie unter Generating Speech from SSML-Dokumenten im Amazon Polly Developer Guide.

Zulässige Werte — | ssml text

Erforderlich — Nein

Standardwert — text

SpeechParameters.VoiceId

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

Zulässige Werte — Amazon Polly Voice IDs

Erforderlich — Nein

Standardwert — Joanna

FailureSpeechParameters.Engine

Beschreibung — Gibt an, welche Engine (Standard oder neuronal) zur Verarbeitung der Fehlermeldung verwendet werden soll, wenn der Kunde eine ungültige Antwort für die Sprachsynthese eingibt.

Zulässige Werte — standard | neural

Erforderlich — Nein

Standardwert — Der SpeechParameters.Engine Wert

FailureSpeechParameters.LanguageCode

Beschreibung — Gibt den Sprachcode an, der verwendet wird, wenn der Kunde eine ungültige Antwort eingibt. Nur erforderlich, 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 — Amazon Polly Polly-Sprachcodes

Erforderlich — Nein

Standardwert — Der SpeechParameters.LanguageCode Wert.

FailureSpeechParameters.Text

Beschreibung — Gibt den Eingabetext an, der gesprochen wird, wenn der Kunde eine ungültige Antwort eingibt. Wenn Sie ssml 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 SSML FailureSpeechParameters.Text handelt. Der Standardwert ist Klartext. Weitere Informationen finden Sie unter Generating Speech from SSML-Dokumenten im Amazon Polly Developer Guide.

Zulässige Werte — | ssml text

Erforderlich — Nein

Standardwert — Der SpeechParameters.Text Wert

FailureSpeechParameters.VoiceId

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

Zulässige Werte — Amazon Polly Voice IDs

Erforderlich — Ja

Standardwert — Der SpeechParameters.VoiceId Wert

MinNumberOfDigits

Beschreibung — Die Mindestanzahl an Ziffern, die erfasst werden müssen, bevor das Zeitlimit ü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 sollen, bevor ein Stopp ohne eine letzte Ziffer beendet wird.

Zulässige Werte — Größer als MinNumberOfDigits

Erforderlich — Nein

Standardwert — 128

TerminatorDigits

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

Zulässige Werte — Einer 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 der RepeatDurationInMilliseconds Wert verwendet

Repeat

Beschreibung — Gesamtzahl der Versuche, Ziffern abzurufen. Wenn Sie diesen Parameter weglassen, ist die Standardeinstellung 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_SUCCESSFUL Ereignissen

Das folgende Beispiel zeigt ein typisches ACTION_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":{       
       ...
    }
}

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 sind die von der Speak Aktion ausgelösten Fehlermeldungen aufgeführt und beschrieben.

Fehler	Fehlermeldung	Grund
AccessDenied	Die AWSServiceRoleForAmazonChimeVoiceConnector Rolle ist nicht richtig konfiguriert.	Die Rolle, mit der Anfragen an Amazon Polly gestellt wurden, ist nicht vorhanden oder es fehlen Berechtigungen. Informationen zur Problembehebung finden Sie in den Schritten im Abschnitt Verwenden der serviceverknüpften Rolle Amazon Chime SDK Voice Connector
InvalidActionParameter		Bei der Überprüfung 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 einen Text Wert haben
MissingRequiredActionParameter	Textist auf 1.000 Zeichen begrenzt	Der Text hat die Zeichenbeschränkung überschritten.
SystemException	Systemfehler beim Ausführen der Aktion.	Beim Ausführen der Aktion ist ein Systemfehler aufgetreten.

Verwenden der serviceverknüpften Rolle Amazon Chime SDK Voice Connector

Sie müssen für die oder -Aktionen keine manuell mit dem Service verknüpfte Rolle erstellen. Speak SpeakAndGetDigits Wenn Sie eine SIP-Medienanwendung in der Amazon Chime SDK-Konsole, der oder der AWS API erstellen oder aktualisieren AWS Command Line Interface, erstellt das Amazon Chime SDK die serviceverknüpfte Rolle für Sie.

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