SpeakAndGetDigits 액션 사용 액션_성공 이벤트 처리 ACTION_FAILED 이벤트 처리 Amazon Chime SDK 음성 커넥터 서비스 연결 역할 사용

SpeakAndGetDigits

텍스트를 입력하여 음성을 재생하고 사용자로부터 이중 톤 다중 주파수 (DTMF) 숫자를 수집할 수 있습니다. 텍스트는 일반 텍스트 또는 SSML (음성 합성 마크업 언어) 강화 텍스트일 수 있습니다. 이 텍스트는 지원되는 다른 SSML 기능 중에서 일시 중지를 추가하거나, 특정 단어를 강조하거나, 말하기 스타일을 변경하여 Amazon Chime SDK가 음성을 생성하는 방식을 보다 효과적으로 제어할 수 있도록 합니다. 사용자가 올바른 DTMF 자릿수를 입력하지 않는 등 오류가 발생하는 경우 액션은 “실패” 음성을 재생한 다음 SIP 미디어 애플리케이션이Repeat 파라미터에 정의된 시도 횟수를 모두 소진할 때까지 기본 음성을 재생합니다.

Amazon Chime SDK는 텍스트를 실제와 같은 음성으로 변환하는 클라우드 서비스인 Amazon Polly를 사용합니다. Amazon Polly는 향상된 음성 품질을 위한 표준 및 신경 엔진, 20개 이상의 지원 언어 및 60개 이상의 음성을 제공합니다. Amazon Polly는 음성 기능을 무료로 제공하지만 Amazon Polly를 사용하면 비용을 지불해야 합니다. 요금 정보는 Amazon Polly 요금 페이지 또는 결제 대시보드를 참조하십시오.

중요

Amazon Polly 사용에는AWS Machine Learning 및 인공 지능 서비스와 관련된 약관을 비롯한 서비스 약관이 적용됩니다.AWS

SpeakAndGetDigits 액션 사용

다음SpeakAndGetDigits 예제제제제제제제제제제제제제제제제제제제제제


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

설명 — Lambda 함수 호출에 참여한CallId 참가자의 수입니다. CallDetails

허용된 값 — A 유효callID

필수 — 예

기본값 — 아니요

InputDigitsRegex

설명 — 사용자가 올바른 숫자와 문자를 입력하도록 도와주는 정규 표현식 패턴입니다.

허용되는 값 — 유효한 정규 표현식 패턴

필수 — 아니요

기본값 – 없음

SpeechParameters. 엔진

설명 — 음성 합성을 위해 텍스트를 처리할 때 사용할 엔진 (표준 또는 신경 엔진) 을 지정합니다.

허용되는 값 —standard |neural

필수 — 아니요

기본값 — 표준

SpeechParameters.LanguageCode

설명 — 언어 코드를 지정합니다. 이는 이중 언어 음성을 사용하는 경우에만 필요합니다. 이중 언어 음성이 사용되고 언어 코드가 지정되지 않은 경우 이중 언어 음성의 기본 언어가 사용됩니다.

허용되는 값 — Amazon Polly 언어 코드

필수 — 아니요

기본값 – 없음

SpeechParameters. 텍스트

설명 — 입력 텍스트를 지정합니다. ssml로 지정하는 경우 입력 텍스트의 SSML 형식을 따라야 합니다.SpeechParameters.TextType SSML에 대한 자세한 내용은 Amazon Polly 개발자 안내서의 SSML 문서에서 음성 생성을 참조하십시오.

허용되는 값 — 문자열

필수 — 예

기본값 – 없음

SpeechParameters.TextType

설명 — 의 텍스트 형식을 지정합니다SpeechParameters.Text. 지정하지 않으면 기본적으로 text이(가) 사용됩니다. SSML에 대한 자세한 내용은 Amazon Polly 개발자 안내서의 SSML 문서에서 음성 생성을 참조하십시오.

허용되는 값 —ssml |text

필수 — 아니요

기본값 —text

SpeechParameters.VoiceId

설명 — 텍스트를 말하는 데 사용된 Amazon Polly 음성의SpeechParameters.Text ID입니다.

허용된 값 — Amazon Polly 음성 ID

필수 — 아니요

기본값 — 조안나

FailureSpeechParameters. 엔진

설명 — 고객이 음성 합성에 대해 잘못된 응답을 입력할 때 사용되는 실패 메시지를 처리할 때 사용할 엔진 (표준 또는 신경 엔진) 을 지정합니다.

허용되는 값 —standard |neural

필수 — 아니요

기본값 —SpeechParameters.Engine 값

FailureSpeechParameters.LanguageCode

설명 — 고객이 잘못된 응답을 입력할 때 사용되는 언어 코드를 지정합니다. 이중 언어 음성을 사용할 때만 필요합니다. 언어 코드를 지정하지 않고 이중 언어 음성을 사용하는 경우 이중 언어 음성의 기본 언어가 사용됩니다.

허용되는 값 — Amazon Polly 언어 코드

필수 — 아니요

기본값 —SpeechParameters.LanguageCode 값입니다.

FailureSpeechParameters. 텍스트

설명 — 고객이 잘못된 응답을 입력할 때 표시되는 입력 텍스트를 지정합니다. ssml로 지정하는 경우 입력 텍스트의 SSML 형식을 따라야 합니다.FailureSpeechParameters.TextType

허용되는 값 — 문자열

필수 — 예

기본값 – 없음

FailureSpeechParameters.TextType

설명 — 에 지정된 입력FailureSpeechParameters.Text 텍스트가 일반 텍스트인지 SSML인지를 지정합니다. 기본값은 일반 텍스트입니다. 자세한 내용은 Amazon Polly 개발자 안내서의 SSML 문서에서 음성 생성을 참조하십시오.

허용되는 값 —ssml |text

필수 — 아니요

기본값 —SpeechParameters.Text 값

FailureSpeechParameters.VoiceId

설명 — 문자열을 말하는 데 사용되는 음성의FailureSpeechParameters.Text ID입니다.

허용된 값 — Amazon Polly 음성 ID

필수 — 예

기본값 —SpeechParameters.VoiceId 값

MinNumberOfDigits

설명 — 제한 시간이 초과되거나 “통화 실패” 메시지가 재생되기 전에 캡처할 최소 자릿수입니다.

허용되는 값 — 0보다 크거나 같음

필수 — 아니요

기본값 — 0

MaxNumberOfDigits

설명 — 종료 숫자 없이 중지하기 전에 캡처할 최대 자릿수입니다.

허용된 값 — 보다 큼MinNumberOfDigits

필수 — 아니요

기본값은 128입니다.

TerminatorDigits

설명 — 사용자가 입력값보다 작게 입력한 경우 입력을 종료하는 데 사용되는 숫자 MaxNumberOfDigits

허용되는 값 — 0 1 2 3 4 5 6 7 8 9 # 또는 * 중 하나

필수 — 아니요

기본값 — #

InBetweenDigitsDurationInMilliseconds

설명 — 실패 음성을 재생하기 전 숫자 입력 사이의 대기 시간 (밀리초) 입니다.

허용되는 값 — 0보다 큼

필수 — 아니요

기본값 — 지정하지 않은 경우 기본값으로 설정됩니다.RepeatDurationInMilliseconds

반복

설명 — 자릿수 가져오기를 시도한 총 횟수입니다. 이 파라미터가 누락되면 기본값은 자릿수 수집을 한 번 시도하는 것입니다.

허용되는 값 — 0보다 큼

필수 — 아니요

기본값 — 1

RepeatDurationInMilliseconds

설명 — 숫자를 얻으려는 각 시도의 제한 시간 (밀리초) 입니다.

허용되는 값 — 0보다 큼

필수 — 예

기본값 – 없음

액션_성공 이벤트 처리

다음은 일반적인ACTION_SUCCESSFUL 이벤트를 보여 줍니다.


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

ACTION_FAILED 이벤트 처리

다음은 일반적인 ACTION_FAILED 이벤트를 보여 줍니다.


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

오류 처리

이 표에는Speak 작업에서 발생하는 오류 메시지가 나열되고 설명되어 있습니다.

오류	메시지	이유
`AccessDenied`	`AWSServiceRoleForAmazonChimeVoiceConnector`역할이 올바르게 구성되지 않았습니다.	Amazon Polly에 요청을 보내는 데 사용된 역할이 없거나 역할에 권한이 없습니다. 문제를 해결하려면Amazon Chime SDK 음성 커넥터 서비스 연결 역할 사용 섹션의 단계를 참조하십시오.
`InvalidActionParameter`		작업 파라미터가 누락되었습니다. 이 작업에 사용할 수 있는 파라미터와 해당 옵션을 검토하려면 Amazon Polly 개발자 안내서를 참조하십시오 `SynthesizeSpeech`.
`MissingRequiredActionParameter`	`Text`필수 매개변수입니다.	동작 매개변수에는`Text` 값이 있어야 합니다.
`MissingRequiredActionParameter`	`Text`1,000자로 제한됩니다.	텍스트가 글자 수 제한을 초과했습니다.
`SystemException`	작업 실행 중 시스템 오류가 발생했습니다.	작업을 실행하는 동안 시스템 오류가 발생했습니다.

Amazon Chime SDK 음성 커넥터 서비스 연결 역할 사용

Speak또는SpeakAndGetDigits 작업에 대해 서비스 연결 역할을 수동으로 생성할 필요가 없습니다. Amazon Chime SDK 콘솔에서 SIP 미디어 애플리케이션을 생성하거나 업데이트하는 경우AWS Command Line Interface, Amazon Chime SDK가 사용자를 대신해 서비스에 연결된 역할을 생성합니다.AWS

자세한 내용은 Amazon Chime SDK 관리자 안내서의 Amazon Chime 서비스 연결 역할 사용을 참조하십시오.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

말하십시오

StartBotConversation