기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Chime SDK 사용 Amazon Chime SDK를 사용하여 오디오와 비디오를 송수신하고 콘텐츠 공유를 허용하는 실시간 미디어 애플리케이션을 구축합니다. Amazon Chime SDK는 모든 Amazon Chime 관리자 계정과 독립적으로 작동하며, Amazon Chime에서 호스팅되는 회의에는 영향을 주지 않습니다. 대신 Amazon Chime SDK는 자체 회의 애플리케이션을 구축하는 데 사용할 수 있는 빌더 도구를 제공합니다. **Topics** + [Amazon Chime SDK 사용을 위한 사전 조건](#mtg-prereqs) + [Amazon Chime SDK의 개념](#mtg-glossary) + [Amazon Chime SDK 아키텍처](#mtg-arch) + [Amazon Chime SDK 할당량](#mtg-limits) + [Amazon Chime SDK 시스템 요구 사항](#mtg-browsers) + [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md) + [Amazon Chime SDK 클라이언트 라이브러리에 대해 알아보기](mtgs-sdk-client-lib.md) + [Amazon Chime SDK 음성 커넥터를 사용한 SIP 통합 이해](mtgs-sdk-cvc.md) + [Amazon Chime SDK 이벤트 알림 이해](mtgs-sdk-notifications.md) + [Amazon Chime 네임스페이스에서 마이그레이션](migrate-from-chm-namespace.md) ## Amazon Chime SDK 사용을 위한 사전 조건 Amazon Chime SDK를 사용하려면 다음 사항이 필요합니다. + 프로그래밍 능력. + AWS 계정. + AWS 관리형 **AmazonChimeSDK** 정책과 같이 Amazon Chime SDK에서 사용하는 Amazon Chime API 작업에 액세스할 수 있는 권한을 부여하는 정책이 있는 IAM 역할입니다. 자세한 내용은 Amazon Chime SDK 관리자 안내서**의 [Amazon Chime에서 IAM을 사용하는 방법](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_service-with-iam.html) 및 [사용자가 Amazon Chime SDK 작업에 액세스하도록 허용](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk)을 참조하세요. + 대부분의 사용 사례에는 다음도 필요합니다. + **서버 애플리케이션** - 회의 및 참석자 리소스를 관리하고 이러한 리소스를 클라이언트 애플리케이션에 제공합니다. 서버 애플리케이션은 AWS 계정에 생성되며 앞서 언급한 IAM 역할에 액세스할 수 있어야 합니다. + **클라이언트 애플리케이션** - 서버 애플리케이션으로부터 회의 및 참석자 정보를 수신하고 이 정보를 사용하여 미디어 연결을 설정합니다. ## Amazon Chime SDK의 개념 다음 용어 및 개념은 Amazon Chime SDK를 이해하고 사용하는 데 있어 매우 중요합니다. **회의** 고유한 `MeetingId`로 식별되는 임시 리소스입니다. `MeetingId`는 진행 중인 회의를 주최하는 미디어 서비스 그룹에 배치됩니다. **미디어 서비스 그룹** 진행 중인 회의를 주최하는 미디어 서비스 그룹입니다. **미디어 배치** 미디어 서비스 그룹을 나타내는 리전화된 URL 세트입니다. 참석자는 클라이언트와 함께 미디어 서비스 그룹에 연결하여 실시간 오디오 및 비디오를 송수신하고 화면을 공유합니다. **참석자** 고유한 `AttendeeId`로 식별되는 회의 참석자입니다. 참석자는 Amazon Chime SDK 클라이언트 라이브러리로 구축된 클라이언트 애플리케이션을 사용하여 자유롭게 회의에 참여하고 나갈 수 있습니다. **참여 토큰** 각 참석자에게 할당되는 고유한 토큰입니다. 참석자는 참여 토큰을 사용하여 미디어 서비스 그룹에 인증합니다. ## Amazon Chime SDK 아키텍처 다음 목록은 Amazon Chime SDK 아키텍처의 다양한 구성 요소가 함께 작동하여 회의 및 참석자, 오디오, 비디오, 콘텐츠 공유를 지원하는 방법을 설명합니다. **회의 및 참석자** 서버 애플리케이션이 Amazon Chime SDK 회의를 생성하면 회의가 리전별 미디어 서비스에 배정됩니다. 서비스 호스트는 참석자 클라이언트 간에 실시간 미디어를 안전하게 전송할 책임이 있습니다. 생성된 각 참석자에게는 고유한 참여 토큰이 할당되는데, 이는 서버 애플리케이션이 참석자를 대신하여 회의에 참여할 권한이 있는 클라이언트에게 안전하게 전송해야 하는 불투명한 비밀 키입니다. 각 클라이언트는 참여 토큰을 사용하여 미디어 서비스 그룹에 인증합니다. 클라이언트는 보안 WebSocket과 데이터그램 전송 계층 보안(DTLS)을 함께 사용하여 미디어 서비스 그룹에 안전하게 신호를 보내고 미디어 서비스 그룹을 통해 다른 참석자와 미디어를 주고 받습니다. **오디오** 미디어 서비스는 각 참석자의 오디오를 믹싱하여 각 수신자의 오디오를 믹싱하고 각 수신자에게 믹스를 전송합니다. Amazon Chime SDK는 디바이스 및 브라우저에서 지원하는 최고 속도(최대 48kHz)로 오디오를 샘플링합니다. Opus 코덱을 사용하여 오디오를 인코딩합니다. 기본 비트레이트는 32kbps이며, 최대 128kbps 스테레오 및 64kbps 모노까지 늘릴 수 있습니다. **비디오** 미디어 서비스는 게시 및 구독 모델을 사용하는 선택적 전달 디바이스(SFU) 역할을 합니다. 각 참석자는 하나의 비디오 소스를 게시할 수 있으며, 회의당 최대 25개의 동시 비디오를 게시할 수 있습니다. JavaScript용 Amazon Chime SDK 클라이언트 라이브러리는 동시 방송이 없는 경우 초당 30프레임, 동시 방송의 경우 초당 15프레임으로 최대 1280x720의 비디오 해상도를 지원합니다. [iOS](sdk-for-ios.md), [Android](sdk-for-android.md), [Windows](client-lib-windows.md)용 Amazon Chime SDK 클라이언트 라이브러리는 최대 1280x720 및 초당 30프레임의 비디오 해상도를 지원하지만 실제 프레임 속도와 해상도는 Amazon Chime SDK에서 자동으로 관리합니다. 활성화되면 비디오 동시 방송은 각 비디오 스트림을 서로 다른 두 가지 해상도와 비트레이트로 전송합니다. 대역폭 제약이 있는 클라이언트는 더 낮은 비트레이트 스트림을 자동으로 구독합니다. 비디오 인코딩 및 디코딩은 성능 향상을 위해 가능한 경우 하드웨어 가속을 사용합니다. **데이터 메시지** 오디오 및 비디오 콘텐츠 외에도 회의 참석자는 각각 최대 2KB의 실시간 데이터 메시지를 서로 전송할 수 있습니다. 메시지를 사용하여 화이트보드, 채팅, 실시간 이모티콘 반응, 애플리케이션별 플로어 컨트롤 신호 등 사용자 지정 회의 기능을 구현할 수 있습니다. **콘텐츠 공유** 클라이언트 애플리케이션은 화면 캡처 또는 미디어 파일과 같은 오디오 및 비디오 콘텐츠를 공유할 수 있습니다. 콘텐츠 공유는 사전 녹화된 콘텐츠 비디오를 초당 15프레임으로 최대 1280x720까지 지원하고 64kbps에서 최대 48kHz의 오디오를 지원합니다. 콘텐츠 공유를 위한 화면 캡처는 초당 최대 15프레임까지 지원되지만 디바이스 및 브라우저의 기능에 따라 제한될 수 있습니다. ## Amazon Chime SDK 할당량 Amazon Chime SDK 서비스의 할당량은 AWS 일반 참조에 설명되어 있습니다. 자세한 내용은 *AWS 일반 참조*의 [Amazon Chime SDK endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html)를 참조하세요. **참고** 서비스 할당량은 API 엔드포인트를 기준으로 합니다. 서비스 할당량 증가를 요청할 때는 애플리케이션이 사용하는 모든 API 엔드포인트에서 증가를 요청해야 합니다. ## Amazon Chime SDK 시스템 요구 사항 Amazon Chime SDK로 생성한 애플리케이션에는 다음과 같은 시스템 요구 사항이 적용됩니다. **지원되는 브라우저, JavaScript용 Amazon Chime SDK 클라이언트 라이브러리** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/chime-sdk/latest/dg/meetings-sdk.html) **iOS용 Amazon Chime SDK 클라이언트 라이브러리** + iOS 버전 13 이상 **Android용 Amazon Chime SDK 클라이언트 라이브러리** + Android OS 버전 5 이상, ARM 및 ARM64 아키텍처 # Amazon Chime SDK에 사용 가능한 AWS 리전 다음 표에는 Amazon Chime SDK 서비스의 기능과 각 서비스를 제공하는 AWS 리전이 나와 있습니다. **참고** AWS 계정에서 별표(**\$1**)로 표시된 리전을 활성화해야 합니다.는 기본적으로 해당 리전을 AWS 차단합니다. 리전 활성화에 대한 자세한 내용은 계정 관리 참조[의 계정에서 사용할 수 있는 AWS 리전 지정](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html)을 참조하세요. *AWS * **Topics** + [콘솔 리전](#sdk-console-regions) + [통화 분석 리전](#call-analytics-regions) + [회의 리전](#sdk-meeting-regions) + [미디어 파이프라인 리전](#sdk-media-pipelines) + [메시징 리전](#sdk-messaging-regions) + [음성 리전](#voice-regions) ## 콘솔 리전 Amazon Chime SDK 콘솔을 사용하여 리소스를 구성하고 Amazon Chime SDK 서비스에 대해 자세히 알아볼 수 있습니다. | **AWS 리전** | **콘솔** | | --- | --- | | 아시아 태평양(서울) | 예 | | 아시아 태평양(싱가포르) | 예 | | 아시아 태평양(시드니) | 예 | | 아시아 태평양(도쿄)(ap-northeast-1) | 예 | | 캐나다(중부)(ca-central-1) | 예 | | 유럽(프랑크푸르트)(eu-central-1) | 예 | | 유럽(아일랜드)(eu-west-1) | 예 | | 유럽(런던)(eu-west-2) | 예 | | 미국 동부(버지니아 북부)(us-east-1) | 예 | | 미국 서부(오레곤)(us-west-2) | 예 | ## 통화 분석 리전 다음 표에는 분석, 트랜스크립션 및 통화 녹음에 사용할 수 있는 AWS 리전이 나열되어 있습니다. | **AWS 리전** | **음성 분석** | **트랜스크립션** | **통화 레코딩** | | --- | --- | --- | --- | | 미국 동부(버지니아 북부)(us-east-1) | 예 | 예 | 예 | | 미국 서부(오레곤)(us-west-2) | 예 | 예 | 예 | | 유럽(프랑크푸르트)(eu-central-1) | 아니요 | 예 | 예 | ## 회의 리전 Amazon Chime SDK 회의에는 *컨트롤 리전* 및 *미디어 리전*이 있습니다. 컨트롤 리전은 회의를 생성, 업데이트, 삭제하는 데 사용되는 API 엔드포인트를 제공합니다. 컨트롤 리전은 [Amazon Chime SDK 회의 수명 주기 이벤트 이해](using-events.md)도 수신하고 처리합니다. 미디어 리전은 실제 회의를 주최하고 클라이언트는 미디어 리전에 연결합니다. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) API를 직접 호출할 때 미디어 리전을 지정합니다. 제어 리전은 동일한 AWS 파티션의 모든 미디어 리전에서 회의를 생성할 수 있습니다. 하지만 회의를 만드는 데 사용된 컨트롤 리전에서만 회의를 업데이트할 수 있습니다. 컨트롤 및 미디어 리전 선택에 대한 자세한 내용은 [Amazon Chime SDK 회의에 회의 리전 사용](chime-sdk-meetings-regions.md) 항목을 참조하세요. 아래 표에 컨트롤, 미디어 또는 두 가지 모두를 제공하는 리전이 나열되어 있습니다. | **AWS 리전** | **회의 컨트롤** | **회의 미디어** | | --- | --- | --- | | 아프리카(케이프타운)(af-south-1)**\$1** | 예\$1\$1 | 예 | | 아시아 태평양(뭄바이)(ap-south-1) | 예 | 예 | | 아시아 태평양(서울)(ap-northeast-2) | 예 | 예 | | 아시아 태평양(싱가포르)(ap-southeast-1) | 예 | 예 | | 아시아 태평양(시드니)(ap-southeast-2) | 예 | 예 | | 아시아 태평양(도쿄)(ap-northeast-1) | 예 | 예 | | 캐나다(중부)(ca-central-1) | 예 | 예 | | 유럽(프랑크푸르트)(eu-central-1) | 예 | 예 | | 유럽(아일랜드)(eu-west-1) | | 예 | | 유럽(런던)(eu-west-2) | 예 | 예 | | 유럽(밀라노)(eu-south-1)**\$1** | | 예 | | 유럽(파리)(eu-west-3) | | 예 | | 유럽(스톡홀름)(eu-north-1) | | 예 | | 이스라엘(텔아비브)(il-central-1)**\$1** | 예**\$1\$1** | 예 | | 남아메리카(상파울루)(sa-east-1) | | 예 | | 미국 동부(오하이오)(us-east-2) | | 예 | | 미국 동부(버지니아 북부)(us-east-1) | 예 | 예 | | 미국 서부(캘리포니아 북부)(us-west-1) | | 예 | | 미국 서부(오레곤)(us-west-2) | 예 | 예 | | AWS GovCloud(미국 동부)(us-gov-east-1) | 예 | 예 | | AWS GovCloud(미국 서부)(us-gov-west-1) | 예 | 예 | **\$1** AWS 계정에서 이러한 리전을 활성화해야 합니다. 자세한 내용은 *AWS 일반 참조*의 [리전 활성화](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)를 참조하세요. **\$1\$1**이 리전의 회의 컨트롤을 사용하는 회의는 해당 리전의 미디어만 호스팅할 수 있습니다. **참고** AWS GovCloud(미국) 리전에서 회의를 생성하려면 GovCloud에서 제어 리전을 사용해야 합니다. 또한 GovCloud의 제어 리전은 AWS GovCloud(미국) 리전에서만 회의를 수행할 수 있습니다. ## 미디어 파이프라인 리전 Amazon Chime SDK 미디어 파이프라인에는 *컨트롤 리전*과 *미디어 리전*이 있습니다. 컨트롤 리전은 미디어 파이프라인을 생성 및 삭제하는 데 사용되는 미디어 파이프라인 API 엔드포인트를 제공합니다. 또한 컨트롤 리전을 사용하여 [미디어 파이프라인 이벤트](media-pipe-events.md)를 수신하고 처리할 수 있습니다. 미디어 리전은 미디어 파이프라인을 실행하며, 시스템은 회의와 동일한 미디어 리전을 자동으로 선택합니다. 컨트롤 리전을 사용하여 모든 데이터 리전에 미디어 파이프라인을 만들 수 있습니다. 미디어 파이프라인은 모든 회의 미디어 리전의 회의에 참여할 수 있습니다. | **AWS 리전** | **컨트롤** | **미디어** | | --- | --- | --- | | 아프리카(케이프타운)(af-south-1)**\$1** | | 예 | | 아시아 태평양(뭄바이)(ap-south-1) | 예 | 예 | | 아시아 태평양(서울)(ap-northeast-2) | 예 | 예 | | 아시아 태평양(싱가포르)(ap-southeast-1) | 예 | 예 | | 아시아 태평양(시드니)(ap-southeast-2) | 예 | 예 | | 아시아 태평양(도쿄)(ap-northeast-1) | 예 | 예 | | 캐나다(중부)(ca-central-1) | 예 | 예 | | 유럽(프랑크푸르트)(eu-central-1) | 예 | 예 | | 유럽(아일랜드)(eu-west-1) | | 예 | | 유럽(런던)(eu-west-2) | 예 | 예 | | 유럽(밀라노)(eu-south-1)**\$1** | | 예 | | 유럽(파리)(eu-west-3) | | 예 | | 유럽(스톡홀름)(eu-north-1) | | 예 | | 남아메리카(상파울루)(sa-east-1) | | 예 | | 미국 동부(오하이오)(us-east-2) | | 예 | | 미국 동부(버지니아 북부)(us-east-1) | 예 | 예 | | 미국 서부(캘리포니아 북부)(us-west-1) | | 예 | | 미국 서부(오레곤)(us-west-2) | 예 | 예 | **\$1** AWS 계정에서 이러한 리전을 활성화해야 합니다. 자세한 내용은 *AWS 일반 참조*의 [리전 활성화](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)를 참조하세요. ## 메시징 리전 Amazon Chime SDK 메시징에는 *컨트롤 리전*과 *데이터 리전*이 있습니다. 컨트롤 리전은 메시징 API 엔드포인트를 노출하고, 데이터 리전은 메시지를 저장합니다. Amazon Kinesis를 사용하여 메시징 데이터 또는 채널 흐름에 대한 AWS Lambda 함수를 스트리밍하는 경우 제어 리전에 있어야 합니다. | **AWS 리전** | **컨트롤** | **데이터** | | --- | --- | --- | | 유럽(프랑크푸르트)(eu-central-1) | 예 | 예 | | 미국 동부(버지니아 북부)(us-east-1) | 예 | 예 | ## 음성 리전 Amazon Chime SDK SIP(세션 개시 프로토콜) 기능은 *API 리전*, *미디어 리전*, *PSTN 리전*으로 구성되어 있습니다. API 리전은 SIP 기능을 생성하고 구성하기 위한 API 엔드포인트를 제공합니다. 미디어 리전에는 Amazon Chime SDK 음성 커넥터 및 SIP 미디어 애플리케이션이 포함됩니다. PSTN 리전을 통해 고객은 온프레미스 전화 시스템을 공중 전화 네트워크에 연결할 수 있습니다. 또한 PSTN 리전은 전화번호 프로비저닝 및 관리를 지원합니다. | **AWS 리전** | **API** | **미디어** | **PSTN** | | --- | --- | --- | --- | | 아시아 태평양(서울)(ap-northeast-2) | 예 | 예 | | | 아시아 태평양(싱가포르)(ap-southeast-1) | 예 | 예 | | | 아시아 태평양(시드니)(ap-southeast-2) | 예 | 예 | | | 아시아 태평양(도쿄)(ap-northeast-1) | 예 | 예 | | | 캐나다(중부)(ca-central-1) | 예 | 예 | | | 유럽(프랑크푸르트)(eu-central-1) | 예 | 예 | | | 유럽(아일랜드)(eu-west-1) | 예 | 예 | | | 유럽(런던)(eu-west-2) | 예 | 예 | | | 미국 동부(버지니아 북부)(us-east-1) | 예 | 예 | 예**\$1** | | 미국 서부(오리건)(us-west-2) | 예 | 예 | 예**\$1** | **\$1**특정 AWS 리전의 전화번호 가용성에 대한 자세한 내용은 [Amazon Chime SDK 요금](https://aws.amazon.com/chime/chime-sdk/pricing/) 페이지를 참조하세요. # Amazon Chime SDK 클라이언트 라이브러리에 대해 알아보기 Amazon Chime SDK로 실시간 회의 클라이언트를 구축하려면 먼저 클라이언트 애플리케이션을 Amazon Chime SDK 클라이언트 라이브러리와 통합해야 합니다. 다음과 같은 클라이언트 라이브러리를 사용할 수 있습니다. + [Android용 Amazon Chime SDK 클라이언트 라이브러리](https://github.com/aws/amazon-chime-sdk-android) – 지원되는 Android 디바이스에서 Amazon Chime SDK 애플리케이션을 구축하는 데 도움이 되는 Kotlin 라이브러리입니다. + [C\$1\$1용 Amazon Chime SDK 시그널링 클라이언트 라이브러리](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp) – 임베디드 디바이스에서 Amazon Chime SDK 회의에 대한 시그널링 연결을 설정하는 데 도움이 되는 C\$1\$1 라이브러리입니다. + [iOS용 Amazon Chime SDK 클라이언트 라이브러리](https://github.com/aws/amazon-chime-sdk-ios) – 지원되는 iOS 디바이스에서 Amazon Chime SDK 애플리케이션을 구축하는 데 도움이 되는 스위프트 라이브러리입니다. + [JavaScript용 Amazon Chime SDK 클라이언트 라이브러리](https://github.com/aws/amazon-chime-sdk-js)([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)) – WebRTC 지원 브라우저에서 Amazon Chime SDK 애플리케이션을 구축하는 데 도움이 되는 TypeScript 유형 정의가 포함된 JavaScript 라이브러리입니다. + [Windows용 Amazon Chime SDK 클라이언트 라이브러리](https://github.com/aws/amazon-chime-sdk-cpp)입니다. 지원되는 디바이스에서 Amazon Chime SDK 애플리케이션을 구축하는 데 도움이 되는 C\$1\$1 라이브러리입니다. 클라이언트 애플리케이션을 Amazon Chime SDK와 통합하는 방법을 알아보려면 클라이언트 라이브러리 `README.md` 파일의 작업을 참조하세요. 데모를 통해 애플리케이션용 특정 미디어 구성 요소를 구축하는 방법을 알아봅니다. # Amazon Chime SDK 음성 커넥터를 사용한 SIP 통합 이해 SIP 호환 음성 인프라를 Amazon Chime SDK 음성 커넥터와 통합하여 SIP 음성 통화를 할 수 있습니다. `us-east-1` 또는 `us-east-2` 리전을 사용해야 합니다. SIP(세션 시작 프로토콜)를 지원하는 인터넷에 액세스할 수 있는 PBX(IP Private Branch Exchange), Session SBC(Border Controller) 또는 기타 음성 인프라가 있어야 합니다. 자세한 내용은 Amazon Chime SDK 관리자 안내서**의 [시작하기 전에](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq)를 참조하세요. **음성 인프라를 통합하려면** 1. AWS 계정에서 Amazon Chime SDK Voice Connector를 생성합니다. 자세한 내용은 Amazon Chime SDK 관리자 안내서**의 [Amazon Chime SDK 음성 커넥터 생성](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon)을 참조하세요. 1. 음성 인프라에서 AWS로 전화를 걸 수 있도록 Amazon Chime SDK 음성 커넥터 설정을 편집하세요. 자세한 내용은 Amazon Chime SDK 관리자 안내서**의 [Amazon Chime SDK 음성 커넥터 설정 편집](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon)을 참조하세요. 1. **종료 설정**을 선택하고 **활성화됨**을 선택합니다. 1. **허용 목록**에서 **신규**를 선택합니다. 1. 내부 SIP 인프라 IP 주소의 CIDR 표기법을 입력합니다. 이렇게 하면 인프라에서 Amazon Chime SDK 음성 커넥터에 액세스할 수 있습니다. 예를 들어 IP 주소 `10.24.34.0`로부터의 트래픽을 허용하려면 CIDR 표기법 `10.24.34.0/32`를 허용 목록에 추가합니다. 1. **추가**를 선택합니다. 1. **통화 계획**에서 통화 계획에 추가할 국가를 하나 이상 선택합니다. 1. 필요에 따라 다른 설정을 편집하고 **저장**을 선택합니다. 1. Amazon Chime SDK 콘솔의 **음성 커넥터**에서 Amazon Chime SDK 음성 커넥터의 **아웃바운드 호스트 이름**을 확인합니다. 이름의 예는 *abcdef1ghij2klmno3pqr4*.voiceconnector.chime.aws와 같습니다. 1. Amazon Chime SDK를 사용하여 회의에 참여하려면 SIP URI를 사용하여 Amazon Chime SDK 음성 커넥터의 **아웃바운드 호스트 이름**에 SIP 요청을 보냅니다. SIP URI에 있는 전화번호 **\$117035550122**를 사용합니다. TLS 프로토콜을 사용하여 `transport` 파라미터를 설정합니다. 마지막으로 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html) API 작업을 직접 호출하여 생성된 고유한 참여 토큰을 사용합니다. 자세한 내용은 다음 예제를 참조하세요. **Example 예: SIP 요청** 다음 예제는 Amazon Chime SDK 음성 커넥터에 SIP 요청을 보내는 데 사용되는 SIP URI의 콘텐츠를 보여줍니다. ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` 다음 예제는 Amazon Chime SDK 회의에 참여하기 위한 샘플 SIP 초대 메시지를 보여줍니다. ``` INVITE sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token SIP/2.0 Via: SIP/2.0/TLS IPaddress:12345;rport;branch=branch;alias Max-Forwards: 70 From: sip:+12065550100@IPaddress;tag=tag To: sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;X-chime-join-token=join-token Contact: Call-ID: a1234567-89b0-1c2d-e34f-5gh678j9k2lm CSeq: 6214 INVITE Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS Supported: replaces, 100rel, timer, norefersub Session-Expires: 1800 Min-SE: 90 Content-Type: application/sdp Content-Length: 991 v=0 o=- 3775321410 3775321410 IN IP4 IPaddress s=pjmedia b=AS:117 t=0 0 a=X-nat:0 m=audio 4000 RTP/SAVP 0 3 8 9 125 101 c=IN IP4 IPaddress b=TIAS:96000 a=rtcp:4001 IN IP4 IPaddress a=sendrecv a=rtpmap:0 PCMU/8000 a=rtpmap:3 GSM/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:9 G722/8000 a=rtpmap:125 opus/48000/2 a=fmtp:125 useinbandfec=1 a=rtpmap:101 telephone-event/8000 a=fmtp:101 0-16 a=crypto:1 AEAD_AES_256_GCM inline:EXAMPLE a=crypto:2 AEAD_AES_256_GCM_8 inline:EXAMPLE a=crypto:3 AES_256_CM_HMAC_SHA1_80 inline:EXAMPLE a=crypto:4 AES_256_CM_HMAC_SHA1_32 inline:EXAMPLE a=crypto:5 AES_CM_128_HMAC_SHA1_80 inline:EXAMPLE a=crypto:6 AES_CM_128_HMAC_SHA1_32 inline:EXAMPLE ``` **참고** Amazon Chime SDK는 E.164 형식의 전화번호만 인식합니다. `From` 헤더에 E.164 전화번호가 있는지 확인하세요. # Amazon Chime SDK 이벤트 알림 이해 Amazon Chime SDK는 Amazon EventBridge, Amazon Simple Queue Service(SQS), Amazon Simple Notification Service(SNS)에 회의 이벤트 알림을 전송하는 것을 지원합니다. **참고** 기본 Amazon Chime SDK 회의 네임스페이스는 `ChimeSDKMeetings` 엔드포인트를 사용합니다. 레거시 Chime 네임스페이스는 단일 엔드포인트를 사용합니다. 네임스페이스와 엔드포인트에 대한 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK 회의 네임스페이스로 마이그레이션](meeting-namespace-migration.md) 단원을 참조하세요. ## EventBridge에 알림 전송 Amazon Chime SDK 이벤트 알림을 EventBridge에 전송할 수 있습니다. Amazon Chime SDK를 EventBridge와 함께 사용하는 방법에 대한 자세한 내용은 Amazon Chime SDK 관리자 안내서**의 [EventBridge를 사용한 Amazon Chime SDK 자동화](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#events-sdk)를 참조하세요. EventBridge에 대한 자세한 내용은 Amazon EventBridge 사용 설명서[https://docs.aws.amazon.com/eventbridge/latest/userguide/](https://docs.aws.amazon.com/eventbridge/latest/userguide/)를 참조하세요. ## Amazon SQS 및 Amazon SNS로 알림 전송 *Amazon Chime SDK API 참조*의 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) API를 사용하여 Amazon Chime SDK 회의 이벤트 알림을 회의당 하나의 Amazon SQS 대기열과 하나의 Amazon SNS 주제로 보낼 수 있습니다. 이렇게 하면 알림 지연 시간을 줄이는 데 도움이 될 수 있습니다. Amazon SQS에 대한 자세한 설명은 [Amazon Simple Queue Service 개발자 안내서](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/)를 참조하세요. Amazon SNS에 대한 자세한 내용은 [Amazon Simple Notification Service 개발자 안내서](https://docs.aws.amazon.com/sns/latest/dg/)를 참조하세요. Amazon SNS 및 Amazon SQS로 전송되는 알림에는 Amazon Chime SDK가 EventBridge에 전송하는 알림과 동일한 정보가 포함되어 있습니다. Amazon Chime SDK는 회의를 생성하는 데 사용된 API 리전의 대기열 및 주제에 회의 이벤트 알림을 전송하는 것을 지원합니다. 이벤트 알림은 발생 순서와 다르게 전달될 수 있습니다. ## Amazon Chime SDK에 Amazon SQS 및 Amazon SNS에 대한 액세스 권한 부여 Amazon Chime SDK가 Amazon SQS 대기열 또는 Amazon SNS 주제를 통해 알림을 보내려면 먼저 대기열 또는 주제의 Amazon 리소스 이름(ARN)에 메시지를 게시할 권한을 Amazon Chime SDK에 부여해야 합니다. 이렇게 하려면 Amazon Chime SDK에 적절한 권한을 부여하는 AWS Identity and Access Management (IAM) 정책을 대기열 또는 주제에 연결합니다. 자세한 내용은 Amazon Simple Queue Service 개발자 안내서**의 [Amazon SQS의 ID 및 액세스 관리](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html) 및 *Amazon Simple Notification Service 개발자 안내서*의 [Amazon SNS 액세스 제어의 사례 예시](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html)를 참조하세요. **참고** Amazon SQS 대기열 또는 Amazon SNS 주제는 Amazon Chime SDK API 엔드포인트와 동일한 AWS 리전을 사용해야 합니다. **Example Amazon Chime SDK가 Amazon SQS 대기열에 이벤트를 게시하도록 허용** 다음 예제 IAM 정책은 회의 이벤트 알림을 지정된 Amazon SQS 대기열에 게시할 수 있는 권한을 Amazon Chime SDK에 부여합니다. `aws:SourceArn` 및 `aws:SourceAccount`에 대한 조건문을 참고하세요. 여기에서는 발생할 수 있는 [혼동된 대리자](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) 문제를 다룹니다. + 아래 정책을 만들 때 `aws:SourceArn` 또는 `aws:SourceAccount`를 사용할 수 있습니다. 두 가지 모두를 사용할 필요는 없습니다. + 이러한 예시에서는 `ChimeSDKMeetings` 네임스페이스와 해당 엔드포인트를 사용합니다. `Chime` 네임스페이스를 사용하는 경우 `chime.amazonaws.com` 엔드포인트를 사용해야 합니다. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "sqs:SendMessage", "sqs:GetQueueUrl" ], "Resource": "arn:aws:sqs:us-east-1:111122223333:queueName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` 이 예제는 Amazon Chime SDK가 회의 이벤트 알림을 SNS 주제에 전송할 수 있도록 허용하는 Amazon SNS 정책을 보여줍니다. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` Amazon SQS 대기열이 서버 측 암호화(SSE)에 대해 활성화된 경우 추가 단계를 수행해야 합니다. 대기열에 추가된 데이터를 암호화하는 데 필요한 AWS KMS 작업에 Amazon Chime SDK 권한을 부여하는 IAM 정책을 연결된 AWS KMS 키에 연결합니다. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` **Example Amazon Chime SDK가 Amazon SNS 주제에 이벤트를 게시하도록 허용** 다음 예제 IAM 정책은 회의 이벤트 알림을 지정된 Amazon SNS 주제에 게시할 수 있는 권한을 Amazon Chime SDK에 부여합니다. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` # Amazon Chime 네임스페이스에서 마이그레이션 Amazon Chime SDK는 엔드포인트 세트에 API를 노출합니다. 엔드포인트에 직접 HTTPS 요청을 할 수 있지만 많은 고객이 애플리케이션에서 AWS SDK를 사용하여 서비스 API를 직접 호출합니다. AWS SDK는 다양한 언어로 제공되며 요청 서명 및 재시도 로직을 캡슐화하여 API 호출을 간소화합니다. AWS SDK에는 각 서비스 엔드포인트에 대한 네임스페이스가 포함되어 있습니다. 처음 출시되었을 때 Amazon Chime SDK는 Amazon Chime 애플리케이션과 단일 엔드포인트를 공유했습니다. 따라서 솔루션은 AWS SDK의 `Chime` 네임스페이스를 사용하여 Amazon Chime 애플리케이션과 Amazon Chime SDK APIs. Amazon Chime SDK는 이제 회의 및 PSTN 오디오 등의 각 하위 서비스에 전용 엔드포인트를 제공합니다. 각 엔드포인트는 AWS SDK의 전용 네임스페이스를 통해 주소를 지정할 수 있습니다. 다음 주제에서는 서비스, 네임스페이스 및 엔드포인트를 나열하고 코드 및 AWS CLI에서 서비스, 네임스페이스 및 엔드포인트를 사용하는 방법을 설명합니다. **Topics** + [엔드포인트, 네임스페이스, CLI 명령](#endpoint-namespace-cli) + [각 서비스의 마이그레이션 도움말](#help-per-service) + [API 매핑](#name-end-map) ## 엔드포인트, 네임스페이스, CLI 명령 다음 표에는 전용 Amazon Chime SDK 네임스페이스, 엔드포인트 및 CLI 명령이 나열되어 있습니다. 링크를 클릭하면 각 서비스에 대한 자세한 정보로 이동할 수 있습니다. | 엔드포인트 | AWS SDK 네임스페이스 | AWS SDK CLI | | --- | --- | --- | | [identity-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) | ChimeSDKIdentity | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html) | | [media-pipelines-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) | ChimeSDKMediaPipelines | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html) | | [meetings-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) | ChimeSDKMeetings | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html) | | [messaging-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) | ChimeSDKMessaging | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html) | | [voice-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) | ChimeSDKVoice | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html) | ## 각 서비스의 마이그레이션 도움말 모든 고객은 전용 Amazon Chime SDK 엔드포인트를 사용하여 최신 Amazon Chime SDK 기능, APIs 및 AWS 리전에 액세스하는 것을 고려해야 합니다. `Chime` 네임스페이스와 함께 공유 엔드포인트를 사용하는 경우, 마이그레이션하기 전에 다음 마이그레이션 안내서가 기술적 차이를 이해하는 데 도움이 될 수 있습니다. + [Amazon Chime SDKIdentity 네임스페이스로 마이그레이션](identity-namespace-migration.md) + [Amazon Chime SDKMediaPipelines 네임스페이스로 마이그레이션](migrate-pipelines.md) + [Amazon Chime SDKMeetings 네임스페이스로 마이그레이션](meeting-namespace-migration.md) + [Amazon Chime SDKMessaging 네임스페이스로 마이그레이션](messaging-namespace-migration.md) + [Amazon Chime SDK 음성 네임스페이스로 마이그레이션](voice-namespace-migration.md) ## API 매핑 다음 표에는 `Chime` 네임스페이스의 API와 해당 전용 네임스페이스 및 API가 나열되어 있습니다. 일부 전용 API는 `Chime` API와 다르며, 표에는 이러한 인스턴스가 나와 있습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **\$1** API가 다른 이름의 API로 대체되었습니다. **\$1 **API를 더 이상 사용할 수 없습니다.