기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Chime SDK 회의 네임스페이스로 마이그레이션
Amazon Chime SDK 회의 네임스페이스는 Amazon Chime SDK 회의 리소스를 생성하고 관리하는 API의 전용 공간입니다. 네임스페이스를 사용하여 Amazon Chime SDK 회의 API 엔드포인트를 사용할 수 있는 모든 AWS 리전에서 이를 다룹니다. Amazon Chime SDK를 막 사용하기 시작한 경우 이 네임스페이스를 사용하세요. 리전에 대한 자세한 내용은 이 설명서의 Amazon Chime SDK에 사용 가능한 AWS 리전 섹션을 참조하세요.
Amazon Chime 네임스페이스를 사용하는 기존 애플리케이션은 최신 API 및 기능을 사용하기 위해 전용 네임스페이스로의 마이그레이션을 계획해야 합니다.
마이그레이션하는 이유
다음과 같은 이유로 Amazon Chime SDK 회의 네임스페이스로 마이그레이션하는 것이 좋습니다.
- API 엔드포인트 선택
-
Amazon Chime SDK 회의 네임스페이스는 API 엔드포인트를 사용할 수 있는 리전 모두에서 API 엔드포인트를 사용할 수 있는 유일한 API 네임스페이스입니다.
us-east-1이외의 API 엔드포인트를 사용하는 경우 Amazon Chime SDK 회의 네임스페이스를 사용해야 합니다.Amazon Chime SDK 회의가 AWS 리전을 사용하는 방법에 대한 자세한 내용은이 안내서의 회의 리전을 참조하세요.
- 업데이트된 회의 API 및 새 회의 API
-
Amazon Chime SDK 회의 네임스페이스에서만 회의 API를 추가하거나 업데이트합니다.
마이그레이션하기 전
마이그레이션하기 전에 네임스페이스 간 차이점에 유의해야 합니다. 다음 표는 네임스페이스를 나열하고 설명합니다.
| Amazon Chime SDK 회의 네임스페이스 | Amazon Chime 네임스페이스 | |
|---|---|---|
| AWS SDK 네임스페이스 | ChimeSDKMeetings | Chime |
| 리전 | 다양함 | us-east-1 전용 |
| 엔드포인트 | https://meetings-chime.region.amazonaws.com | https://service.chime.aws.amazon.com |
| 서비스 보안 주체 | meetings.chime.amazonaws.com | chime.amazonaws.com |
| API | 회의용 API 전용 | 회의 및 Amazon Chime의 기타 부분을 위한 API |
| CreateMeeting | ExternalMeetingId 및 MediaRegion은 필수 사항 |
ExternalMeetingId 및 MediaRegion은 선택 사항 |
| CreateMeetingWithAttendees | ExternalMeetingId 및 MediaRegion은 필수 사항 |
ExternalMeetingId 및 MediaRegion은 선택 사항 |
ListMeetings |
사용할 수 없음 | 사용 가능 |
ExternalMeetingId |
검증에 패턴 일치 포함 | Available |
ExternalUserId |
검증에 패턴 일치 포함 | Available |
| 회의 태그 API | TagResource, UntagResource,
ListTagsForResource |
TagMeeting, UntagMeeting,
ListMeetingTags |
| 참석자 태그 | 사용할 수 없음 | 사용 가능 |
| 울림 감소 | Available | 사용할 수 없음 |
| 라이브 트랜스크립션 언어 식별 | Available | 사용할 수 없음 |
| 참석자 기능 | Available | 사용할 수 없음 |
| 미디어 복제 | Available | 사용할 수 없음 |
| AppKey 및 TenantId | Available | 사용할 수 없음 |
| 미디어 파이프라인 | 미디어 파이프라인은 Amazon Chime SDK 회의 네임스페이스의 여러 리전을 지원합니다. 자세한 내용은 Amazon Chime SDK 미디어 파이프라인 네임스페이스로 마이그레이션을 참조하세요. | us-east-1 엔드포인트를 통해 사용 가능 |
| SIP 미디어 애플리케이션 | JoinChimeMeeting 작업은 MeetingId 필요 |
JoinChimeMeeting 작업은 MeetingId 불필요 |
|
직접 SIP 통합 |
사용할 수 없음 | 사용 가능 |
네임스페이스 간 차이점
다음 섹션에서는 Amazon Chime 네임스페이스와 Amazon Chime SDK Meetings 네임스페이스의 차이점을 설명합니다.
Amazon Chime SDK 네임스페이스는 Chime 공식 이름을 사용합니다. Amazon Chime SDK 회의 네임스페이스는 ChimeSDKMeetings 공식 이름을 사용합니다. 이름의 정확한 형식은 플랫폼마다 다릅니다.
예를 들어 Node.js의 AWS SDK를 사용하여 회의를 생성하는 경우 코드 줄을 사용하여 네임스페이스를 처리합니다.
const chimeMeetings = AWS.Chime();
Amazon Chime 회의 SDK 네임스페이스로 마이그레이션하려면 새 네임스페이스와 엔드포인트 리전으로 아래 코드를 업데이트합니다.
const chimeMeetings = AWS.ChimeSDKMeetings({ region: "eu-central-1" });
Amazon Chime 네임스페이스는 us-east-1 리전의 API 엔드포인트만 다룹니다. Amazon Chime SDK 회의 네임스페이스는 Amazon Chime SDK 회의 API 엔드포인트를 사용 가능한 모든 리전에서 이를 다룰 수 있습니다. 현재 회의 리전의 목록은 본 설명서의 Amazon Chime SDK에 사용 가능한 AWS 리전을 참조하세요.
Amazon Chime SDK 회의 네임스페이스는 Amazon Chime 네임스페이스와는 다른 API 엔드포인트를 사용합니다.
회의를 생성하는 데 사용된 엔드포인트만 회의를 수정하는 데 사용할 수 있습니다. 즉, EU-CENTRAL-1에서 엔드포인트를 통해 생성된 회의는 EU-CENTRAL-1을 통해서만 수정할 수 있습니다. 또한 Chime 네임스페이스를 통해 생성된 회의를 US-EAST-1의 ChimeSDKMeetings 네임스페이스로 다룰 수 없습니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 API 매핑 섹션을 참조하세요.
Amazon Chime SDK 회의 네임스페이스는 새로운 서비스 보안 주체인 meetings.chime.amazonaws.com을 사용합니다. 서비스에 액세스 권한을 부여하는 SQS, SNS 또는 기타 IAM 액세스 정책이 있는 경우, 새 서비스 보안 주체에 대한 액세스 권한을 부여하도록 해당 정책을 업데이트해야 합니다.
Amazon Chime SDK 회의 네임스페이스에는 회의를 생성하고 관리하기 위한 API만 포함되어 있습니다. Amazon Chime 네임스페이스에는 회의 및 Amazon Chime 서비스의 기타 부분을 위한 API가 포함되어 있습니다.
Amazon Chime SDK 회의 네임스페이스에서 CreateMeeting 및 CreateMeetingWithAttendees API를 사용하려면 ExternalMeetingId 및 MediaRegion 필드를 지정해야 합니다.
Amazon Chime SDK 회의 네임스페이스는 ExternalMeetingId 및 ExternalUserId에 사용할 수 있는 값에 대한 추가 검증을 시행합니다.
Amazon Chime SDK 회의 네임스페이스는 기계 학습 기반 울림 감소를 제공하여 로컬 스피커의 소음과 소리가 다시 회의로 들어가는 것을 막는 데 도움이 됩니다. 자세한 내용은 GitHub의 설명서를 참조하세요.
Amazon Chime SDK 회의 네임스페이스에서는 회의 내 참석자가 오디오, 비디오 및 콘텐츠를 보내고 받을 수 있는 기능을 세부적으로 제어할 수 있습니다.
Amazon Chime SDK 회의 네임스페이스는 미디어 복제를 제공하여 기본 회의를 복제 회의에 연결하고 실시간 세션에 최대 10,000명을 모을 수 있습니다. 복제 세션에 연결된 참가자는 기본 세션에 연결된 발표자의 미디어를 수신하지만 기본 회의로 승격될 수는 있습니다. 자세한 내용은 이 설명서의 Amazon Chime SDK 회의에 미디어 복제 사용을 참조하세요.
Amazon Chime SDK 회의 네임스페이스는 네트워크에서 특정 Amazon Chime SDK 회의로의 액세스를 제한하는 방법을 제공합니다. 자세한 내용은 이 설명서의 Amazon Chime SDK에 AppKey 및 TenantID 사용을 참조하세요.
Amazon Chime SDK 미디어 파이프라인은 Amazon Chime SDK 회의 또는 Amazon Chime 네임스페이스를 사용하여 모든 회의 엔드포인트에서 생성한 회의와 작동합니다. 미디어 파이프라인 리전의 최신 목록은 사용 가능한 리전을 참조하세요.
Amazon Chime SDK SIP 미디어 애플리케이션은 Amazon Chime SDK 회의 또는 Amazon Chime 네임스페이스를 사용하여 모든 회의 엔드포인트에서 생성한 회의와 작동합니다. Amazon Chime SDK 회의 네임스페이스를 통해 회의를 생성한 SIP 미디어 애플리케이션을 사용하는 경우, JoinChimeMeeting 작업에 MeetingId 파라미터가 필요합니다.
회의 네임스페이스에는 Chime 네임스페이스에 없는 API 목록이 점점 늘어나고 있습니다. Amazon Chime SDK를 시작하는 경우 회의 네임스페이스를 사용하여 최신 기능에 액세스하세요.
