기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Chime SDK 사용
Amazon Chime SDK를 사용하여 오디오와 비디오를 송수신하고 콘텐츠 공유를 허용하는 실시간 미디어 애플리케이션을 구축합니다. Amazon Chime SDK는 모든 Amazon Chime 관리자 계정과 독립적으로 작동하며, Amazon Chime에서 호스팅되는 회의에는 영향을 주지 않습니다. 대신 Amazon Chime SDK는 자체 회의 애플리케이션을 구축하는 데 사용할 수 있는 빌더 도구를 제공합니다.
주제
Amazon Chime SDK 사용을 위한 사전 조건
Amazon Chime SDK를 사용하려면 다음 사항이 필요합니다.
프로그래밍 능력.
AWS 계정.
AWS 관리형 AmazonChimeSDK 정책과 같이 Amazon Chime SDK에서 사용하는 Amazon Chime API 작업에 액세스할 수 있는 권한을 부여하는 정책이 있는 IAM 역할입니다. 자세한 내용은 Amazon Chime SDK 관리자 안내서의 Amazon Chime에서 IAM을 사용하는 방법 및 사용자가 Amazon 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, Android, Windows용 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를 참조하세요.
참고
서비스 할당량은 API 엔드포인트를 기준으로 합니다. 서비스 할당량 증가를 요청할 때는 애플리케이션이 사용하는 모든 API 엔드포인트에서 증가를 요청해야 합니다.
Amazon Chime SDK 시스템 요구 사항
Amazon Chime SDK로 생성한 애플리케이션에는 다음과 같은 시스템 요구 사항이 적용됩니다.
지원되는 브라우저, JavaScript용 Amazon Chime SDK 클라이언트 라이브러리
운영 체제 | 브라우저 | 지원되는 버전 | Notes |
---|---|---|---|
Windows |
Mozilla Firefox |
75 이상 |
|
Google Chrome |
78 이상 | ||
Chromium 기반 Edge |
79 이상 | ||
Chromium 기반 Electron | 7 이상 | Chrome 버전 78 이상. | |
Opera | 66 이상 | ||
macOS |
Mozilla Firefox |
75 이상 |
|
Google Chrome |
78 이상 | ||
Chromium 기반 Edge |
79 이상 | ||
Chromium 기반 Electron |
|||
Safari | 13 이상 | ||
Opera | 66 이상 | ||
iOS | Mozilla Firefox | 10 이상 | 오디오 및 비디오만 지원되며 콘텐츠 공유는 불가합니다. |
Google Chrome | 78 이상 | 오디오 및 비디오만 지원되며 콘텐츠 공유는 불가합니다. | |
Safari | 13 이상 | 오디오 및 비디오만 지원되며 콘텐츠 공유는 불가합니다. | |
WKWebView | 14.3 이상 | 오디오 및 비디오만 지원되며 콘텐츠 공유는 불가합니다. | |
Android | Google Chrome | 10 이상 | 오디오 및 비디오만 지원되며 콘텐츠 공유는 불가합니다. |
삼성 | 12 이상 | 오디오 및 비디오만 지원되며 콘텐츠 공유는 불가합니다. | |
Chromium WebView | 5 이상 | 오디오 및 비디오만 지원되며 콘텐츠 공유는 불가합니다. | |
Ubuntu LTS 16.04 이상 | Google Chrome | 78 이상 |
iOS용 Amazon Chime SDK 클라이언트 라이브러리
-
iOS 버전 13 이상
Android용 Amazon Chime SDK 클라이언트 라이브러리
-
Android OS 버전 5 이상, ARM 및 ARM64 아키텍처