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 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 PollyPreisseite
Die Verwendung von Amazon Polly unterliegt derAWSServicebedingungen
Themen
Verwendung der SpeakAndGetDigits Aktion
Das folgende Beispiel zeigt eine typische Verwendung desSpeakAndGetDigits
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— Die
CallId
des Teilnehmers der CallDetails des Aufrufs der Lambda-Funktion.Zulässige Werte— Ein gültiges
callID
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 angeben
ssml
wie 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ür
SpeechParameters.Text
aus. Falls nicht angegeben,text
Standardmäß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 in
SpeechParameters.Text
aus.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— Die
SpeechParameters.Engine
Wert - 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— Die
SpeechParameters.LanguageCode
Wert. - FailureSpeechParameters.Text
-
Beschreibung— Gibt den Eingabetext an, der gesprochen wird, wenn der Kunde eine ungültige Antwort eingibt. Wenn Sie angeben
ssml
wie 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 in
FailureSpeechParameters.Text
ist 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— Die
SpeechParameters.Text
Wert - FailureSpeechParameters.voiceID
-
Beschreibung— Die ID für die Stimme, mit der die Zeichenfolge gesprochen wurde
FailureSpeechParameters.Text
aus.Zulässige Werte–Amazon Polly
Erforderlich— Ja
Standardwert— Die
SpeechParameters.VoiceId
Wert - 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 als
MinNumberOfDigits
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 Standardwert
RepeatDurationInMilliseconds
Wert - 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_SUCCESSFUL
event.
{ "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 beschriebenSpeak
Aktion
Fehler |
Fehlermeldung |
Grund |
---|---|---|
|
Die |
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 |
|
|
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 unter |
|
|
Die Aktionsparameter müssen eine |
|
|
Der Text hat die Zeichengrenze überschritten. |
|
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 erstellenSpeak
oderSpeakAndGetDigits
Aktionen. 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.