작업 사용 SpeakAndGetDigits ACTION_SUCCESSFUL이벤트 처리 ACTION_FAILED이벤트 처리 Amazon Chime SDK Voice Connector 서비스 연결 역할 사용

SpeakAndGetDigits

텍스트를 제공하여 음성을 재생하고 사용자로부터 이중 톤 다중 주파수(DTMF) 숫자를 수집합니다. 텍스트에는 일반 텍스트를 사용하거나, 지원되는 기타 SSML 기능 중에서 일시 중지를 추가하거나 특정 단어를 강조하거나 발화 스타일을 변경하여 Amazon Chime SDK가 음성을 생성하는 방식을 보다 세부적으로 제어하는 음성 합성 마크업 언어(SSML)로 향상된 텍스트를 사용할 수 있습니다. 사용자가 올바른 개수의 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
ACTION_SUCCESSFUL이벤트 처리
ACTION_FAILED이벤트 처리
Amazon Chime SDK Voice Connector 서비스 연결 역할 사용

작업 사용 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 함수 CallDetails 호출에 참여한 CallId 참가자의 모습입니다.

허용된 값 - 유효한 callID

필수 - 예

기본값 - 아니요

InputDigitsRegex

설명 - 사용자가 올바른 숫자와 문자를 입력하는 데 도움이 되는 정규 표현식 패턴입니다.

허용된 값 - 유효한 정규 표현식 패턴

필수 - 아니요

기본값 – 없음

SpeechParameters.Engine

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

허용된 값 - standard | neural

필수 - 아니요

기본값 - Standard

SpeechParameters.LanguageCode

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

허용된 값 - Amazon Polly 언어 코드

필수 - 아니요

기본값 – 없음

SpeechParameters.Text

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

허용된 값 - 문자열

필수 - 예

기본값 – 없음

SpeechParameters.TextType

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

허용된 값 - ssml | text

필수 - 아니요

기본값 – text

SpeechParameters.VoiceId

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

허용된 값 - Amazon Polly 음성 ID

필수 - 아니요

기본값 - Joanna

FailureSpeechParameters.Engine

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

허용된 값 - standard | neural

필수 - 아니요

기본값 - SpeechParameters.Engine 값

FailureSpeechParameters.LanguageCode

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

허용된 값 - Amazon Polly 언어 코드

필수 - 아니요

기본값 - SpeechParameters.LanguageCode 값

FailureSpeechParameters.Text

설명 - 고객이 잘못된 응답을 입력하는 경우에 재생되는 입력 텍스트를 지정합니다. ssml을 FailureSpeechParameters.TextType으로 지정하는 경우 입력 텍스트의 SSML 형식을 따라야 합니다.

허용된 값 - 문자열

필수 - 예

기본값 – 없음

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 값(지정하지 않는 경우)

Repeat

설명 - 숫자를 얻기 위한 총 시도 횟수입니다. 이 파라미터를 생략하면 숫자 수집을 시도하는 기본값은 한 번입니다.

허용된 값 - 0 초과

필수 - 아니요

기본값 – 1

RepeatDurationInMilliseconds

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

허용된 값 - 0 초과

필수 - 예

기본값 – 없음

ACTION_SUCCESSFUL이벤트 처리

다음 예제는 일반적인 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 작업에서 발생한 오류 메시지를 나열하고 설명합니다.

Error	메시지	이유
`AccessDenied`	The `AWSServiceRoleForAmazonChimeVoiceConnector` role is not configured correctly.	Amazon Polly에 요청하는 데 사용된 역할이 없거나 역할에 권한이 없습니다. 문제를 해결하려면 Amazon Chime SDK Voice Connector 서비스 연결 역할 사용 섹션의 단계를 참조하세요.
`InvalidActionParameter`		작업 파라미터를 검증하는 동안 오류가 발생했습니다. 이 작업에 사용할 수 있는 파라미터와 해당 옵션을 검토하려면 Amazon Polly 개발자 안내서를 참조하십시오 SynthesizeSpeech.
`MissingRequiredActionParameter`	`Text` is a required parameter.	작업 파라미터에 `Text` 값이 있어야 합니다.
`MissingRequiredActionParameter`	`Text` is limited to 1,000 characters	텍스트가 문자 제한을 초과했습니다.
`SystemException`	System error while running action.	작업을 실행하는 동안 시스템 오류가 발생했습니다.

Amazon Chime SDK Voice Connector 서비스 연결 역할 사용

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

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

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

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

문서 규칙

Speak

StartBotConversation