RecordAudio - Amazon Chime SDK
액션_성공 이벤트 처리ACTION_FAILED 이벤트 처리

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

RecordAudio

SIP 미디어 애플리케이션이 지정된 통화 ID에서 미디어를 녹화할 수 있습니다. 예: 음성 메일 응용 프로그램 및 회의 참가자 알림. 애플리케이션은 설정한 지속 시간에 도달하거나, 사용자가 다음 중 하나를 누르거나RecordingTerminators, 애플리케이션이 무음을 감지할 때까지 녹화합니다. 이러한 경우 작업은 결과 미디어 파일을 지정된 S3 버킷에 넣으라고 애플리케이션에 지시합니다. S3 버킷은 SIP 미디어 애플리케이션과 동일한AWS 계정에 속해야 합니다. 또한 작업을 수행하려면 Amazon Chime SDK 음성 커넥터 서비스 주체인 Amazon Chime SDK 음성 커넥터 서비스 주체에게s3:PutObjectAcl 권한을s3:PutObject 부여하고 권한을 부여해야voiceconnector.chime.amazonaws.com 합니다.

참고

이 기능을 사용하여 녹음한 내용은 전자 통신 녹음에 관한 법률 또는 규정의 적용을 받을 수 있습니다. 녹화된 세션 또는 커뮤니케이션의 모든 참가자에게 세션 또는 커뮤니케이션이 레코딩되고 있음을 알리고 동의를 얻는 것을 포함하여 레코딩과 관련된 모든 관련 법률을 준수하는 것은 귀하와 귀하의 최종 사용자의 책임입니다.

다음 예에서는 Amazon Chime SDK 음성 커넥터 서비스 주체에s3:PutObject 및s3:PutObjectAcl 권한을 부여합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "SMARead",
            "Effect": "Allow",
            "Principal": {
                "Service": "voiceconnector.chime.amazonaws.com"
            },
            "Action": [                
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::bucket-name/*"
        }
    ]
}

다음 예제에서는 발신자가 파운드 키 (#) 를 누르거나 활동이 없는 상태에서 10초가 경과하거나 발신자가 3초 동안 침묵을 유지하면 녹화가 중지되고 결과 미디어 파일을RecordingDestination 매개 변수로 정의된 위치에 기록합니다.

참고

이 예제에서는CallId 파라미터를 사용합니다. ParticipantTag매개 변수를 대신 사용할 수 있지만 둘 다 사용할 수는 없습니다.

{
    "Type": "RecordAudio",
    "Parameters": {
        "CallId": "call-id-1",
        "DurationInSeconds": "10",
        "SilenceDurationInSeconds": 3,
        "SilenceThreshold": 100,
        "RecordingTerminators": [
            "#"
        ],
        "RecordingDestination": {
            "Type": "S3",
            "BucketName": "valid-bucket-name",
            "Prefix": "valid-prefix-name"
        }
    }
}
CallId

설명 —AWS Lambda 함수 호출에CallDetails 참여한CallId 참가자의 정보

허용된 값 — 유효한 통화 ID

필수 — 아니요

기본값 – 없음

ParticipantTag

설명 — 연결된 참가자ParticipantTag 중 한 명에 대한 설명CallDetails

허용된 값 —LEG-A 또는LEG-B

필수 — 아니요

기본값 — 지정한 경우 호출된callLeg 항목ParticipantTag 중 무시됨CallId

RecordingDestination. 유형

설명 — 목적지 유형. S3만 해당됩니다.

허용되는 값 — S3

필수 — 예

기본값 – 없음

RecordingDestination.BucketName

설명 — 유효한 S3 버킷 이름입니다. 버킷은 Amazon Chime SDK 음성 커넥터 서비스 주체에 액세스할 수 있어야voiceconnector.chime.amazonaws.com 합니다.

허용된 값 — Amazon Chime SDK가s3:PutObject 및s3:PutObjectAcl 작업에 액세스할 수 있는 유효한 S3 버킷입니다.

필수 — 예

기본값 – 없음

RecordingDestination. 접두사

설명 — 녹화 파일의 S3 접두사

허용되는 값 — 최대 979개의 안전한 문자를 포함하는 유효한 접두사 이름입니다. 안전 문자에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 안전 문자를 참조하세요.

필수 — 아니요

기본값 - 없음. 지정하지 않으면 녹화가 S3 버킷의 루트에 저장됩니다.

DurationInSeconds

설명 — 녹화 시간 (초 단위)

허용된 값 — >0

필수 — 아니요

기본값 – 없음

SilenceDurationInSeconds

설명 — 녹음이 중지된 후 침묵의 지속 시간 (초) 입니다. 지정하지 않은 경우 무음 감지가 비활성화됩니다.

허용되는 값 — [1; 1000]

필수 — 아니요

기본값은 200입니다.

SilenceThreshold

설명 — “침묵”으로 간주되는 소음 수준. 지정하지 않은SilenceDurationInSeconds 경우 이 파라미터는 무시됩니다.

기준값 (노이즈를 무음으로 처리하기 위한 노이즈 레벨 및 임계값):

  • 1—30dB 이하 (예: 조용한 방)

  • 100—40-50 dB (예: 속삭이는 사무실 또는 조용한 사무실)

  • 200—60dB (혼잡한 사무실 등)

  • 1000—75 dB (예: 시끄러운 사람 또는 음악 소리)

허용되는 값 — [1; 1000]

필수 — 아니요

기본값은 200입니다.

RecordingTerminators

설명 — 사용 가능한 모든 레코딩 종료자를 나열합니다.

허용되는 값 — [123456789*0#] 의 한 자리 숫자와 기호로 구성된 배열

필수 — 예

기본값 – 없음

액션_성공 이벤트 처리

녹화가 끝나면 Amazon Chime SDK SIP 미디어 애플리케이션이AWS Lambda 함수를 호출하고 호출 결과와 함께 ACTION_SUCCESTION 이벤트를 해당 함수에 전달합니다.

{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type" : "RecordAudio",
        "Parameters": {
           ...           
        },
        "RecordingDestination": {
            "Type": "S3",
            "BucketName": "valid-bucket-name",
            "Key": "valid-S3-key"              
        },
        "RecordingTerminatorUsed":"#"
    },
    "CallDetails": {
        ...
    }
}

ACTION_SUCCESSFUL이벤트에는ActionData 다음 필드가 포함되어 있습니다.

유형

설명 — 작업 유형,RecordAudio.

파라미터

설명 — 작업의 매개 변수입니다.

RecordingDestination. 유형

설명 — 목적지 유형. S3만 해당됩니다.

RecordingDestination.BucketName

설명 — 레코딩 파일이 포함된 S3 버킷입니다.

RecordingDestination. 키

설명 — 레코딩 파일의 S3 키입니다.

RecordingTerminatorUsed

설명 — 레코딩을 중지하는 데 사용되는 터미네이터로서RecordingTerminators 파라미터에 전달된 종료자 중 하나입니다. 최대 지속 시간 (DurationInSeconds) 에 도달한 후 또는 침묵 (SilenceDurationInSeconds) 으로 인해 기록이 중지되는 경우 이 키-값 쌍은 출력에 포함되지 않습니다.

오류 처리

검증 오류의 경우 SIP 미디어 애플리케이션은 해당 오류 메시지와 함께AWS Lambda 함수를 호출합니다. 다음 표에는 가능한 오류 메시지가 나열됩니다.

오류 메시지 이유

InvalidActionParameter

CallId또는 작업ParticipantTag 매개변수가 잘못되었습니다.

DurationInSeconds매개변수 값이 잘못되었습니다.

SilenceDurationInSeconds매개변수 값이 잘못되었습니다.

SilenceThreshold매개변수 값이 잘못되었습니다.

RecordingDestination매개변수 값이 잘못되었습니다.

녹화를 S3 버킷에 업로드하는 동안 오류가 발생했습니다.

파라미터는 잘못되었습니다.

SystemException

작업 실행 중 시스템 오류가 발생했습니다.

작업을 실행하는 동안 다른 유형의 시스템 오류가 발생했습니다.

ACTION_FAILED 이벤트 처리

작업이 콜 레그에 미디어를 기록하지 못하면 SIP 미디어 애플리케이션은ACTION_FAILED 이벤트 유형의AWS Lambda 함수를 호출합니다. 다음 예를 참조하세요.

{
    "SchemaVersion": "1.0",
    "Sequence": 5,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "RecordAudio",
        "Parameters": {
           ...           
        },
        "ErrorType": "InvalidActionParameter",
        "ErrorMessage": "RecordingDestination parameter value is invalid."
    },
    "CallDetails": {
        ...
    }
}

다음 주소에서 작업 예제를 확인하세요 GitHub. https://github.com/aws-samples/amazon-chime-sma-bridging