

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

# Amazon Chime SDK에 대해 자주 묻는 질문(FAQ)
<a name="chime-sdk-faq"></a>

다음 단원의 주제에서는 Amazon Chime SDK에 대해 자주 묻는 질문에 대한 답변을 제공합니다. 주제를 확장하면 자세한 내용을 확인할 수 있습니다.

**Topics**
+ [회의 FAQ](#meeting-faqs)
+ [미디어 파이프라인 FAQ](#media-pipeline-faqs)
+ [PSTN 오디오 FAQ](#pstn-faqs)

## 회의 FAQ
<a name="meeting-faqs"></a>

**Topics**
+ [참석자](#attendee-faqs)
+ [보안 및 암호화](#security-faqs)
+ [오디오/비디오](#av-faqs)
+ [라이브 트랜스크립션](#transcription-faqs)
+ [Service Quotas](#service-quota-faqs)
+ [네임스페이스 마이그레이션](#migration-faqs)
+ [모니터링](#monitoring-faqs)
+ [로깅](#logging-faqs)
+ [오류 메시지](#error-msg-faqs)

### 참석자
<a name="attendee-faqs"></a>

#### Amazon Chime SDK 회의에 참여할 수 있는 사람은 누구인가요?
<a name="who-can-join"></a>

필요한 참여 토큰이 있는 참석자만 참여할 수 있습니다. [CreateAttendee](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html), [BatchCreateAttendee](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html) 또는 [CreateMeetingWithAttendees](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html) API를 사용하면 클라이언트에게 전달하여 클라이언트가 회의에 참여할 수 있도록 하는 참여 토큰을 생성할 수 있습니다. 이러한 API를 통해 생성된 토큰은 서비스에서 인증되며, 이를 통해 회의 참여 권한이 부여됩니다.

**참고**  
Amazon Chime SDK는 회의 참석자를 위한 회의 ID나 참여 URL을 생성하지 않습니다.

#### 회의 참석자 할당량은 어떻게 되나요?
<a name="attendee-quotas"></a>

참석자 할당량은 회의별로 적용됩니다. Amazon Chime SDK는 표준 세션에서 250명의 참석자를, 고화질 세션에서 100명의 참석자를 지원합니다. 더 많은 참석자가 필요한 경우 미디어 복제를 사용하는 것이 좋습니다. 이 경우 [AWS Support Center 콘솔](https://console.aws.amazon.com/support/home#/AWS)을 통해 한도 증가를 요청하면 최대 10,000명의 참석자가 허용됩니다. 미디어 복제에 대한 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK 회의에 미디어 복제 사용](media-replication.md) 단원을 참조하세요.

#### 회의에 참석자가 없는 경우에도 요금이 부과되나요?
<a name="charges"></a>

 아니요. Amazon Chime SDK는 참석자가 회의에 참여할 때만 요금을 청구합니다. 또한 마지막 활성 참석자가 회의에서 이탈하거나 퇴장한 후 5분이 지나면 회의가 자동으로 종료됩니다.

#### AttendeeDeleted, AttendeeLeft, AttendeeDropped 회의 이벤트의 차이점은 무엇인가요?
<a name="attendee-diffs"></a>

`AttendeeLeft`는 참석자가 회의에서 나가기로 결정했을 때 트리거됩니다. `AttendeeDropped`는 일반적으로 네트워크 문제로 인해 회의에서 참석자와 연결이 끊겼을 때 트리거됩니다. `AttendeeDeleted`는 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteAttendee.html) API가 직접 호출되었을 때 트리거됩니다.

`AttendeeLeft`는 다음과 같은 경우에도 트리거됩니다.
+ 서버 측 회의 핸들러에서 `DeleteAttendee` API가 직접 호출될 때 `AttendeeDeleted`와 함께 트리거됩니다.
+ 클라이언트가 [JavaScript용 클라이언트 라이브러리](js-sdk-intro.md)에서 `meetingSession.audioVideo.Stop` API를 직접 호출하거나, [iOS](sdk-for-ios.md) 및 [Android](sdk-for-android.md) SDK에서 해당하는 API를 직접 호출하거나 회의가 종료될 때 트리거됩니다.

회의 이벤트에 대한 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK 회의 수명 주기 이벤트 이해](using-events.md) 단원을 참조하세요.

#### 참석자가 참여했지만 연결 불량으로 이탈하고 아무도 회의를 종료하지 않으면 회의는 얼마나 지속되나요?
<a name="meeting-time"></a>

회의는 다음과 같은 경우 자동으로 종료됩니다.
+ 회의 시간이 24시간을 초과한 경우
+ 회의가 복제 회의이며 기본 회의가 종료된 경우
+ 비복제 회의에서 참석자가 5분 연속으로 연결되지 않는 경우

#### Amazon Chime SDK는 얼마 동안 참석자와 재연결을 시도하나요?
<a name="reconnect-attempts"></a>

기본적으로 [JavaScript용 Amazon Chime SDK 클라이언트 라이브러리](https://aws.github.io/amazon-chime-sdk-js/index.html)는 `MeetingSessionConfiguration` 회의 이벤트에 지정된 대로 2분 동안 재연결을 시도합니다. 또한 참석자가 회의에서 이탈하고 세션에 다시 연결되지 않으면 Amazon Chime SDK는 `AttendeeDropped` 이벤트를 전송합니다.

회의 이벤트에 대한 자세한 내용은 이 FAQ 뒷부분에 설명된 [모니터링](#monitoring-faqs) 단원을 참조하세요.

### 보안 및 암호화
<a name="security-faqs"></a>

#### Amazon Chime SDK는 end-to-end AWS 256비트 암호화를 지원하나요?
<a name="256-encryption"></a>

예. 모든 미디어는 전송 중에 암호화되어 서비스를 통해 전달됩니다. 미디어는 클라이언트와 회의를 호스팅하는 특정 미디어 인스턴스 간에 암호화됩니다. 미디어 인스턴스는 믹싱을 위해 오디오를 해독한 다음 믹싱된 오디오를 암호화하여 클라이언트로 전송합니다. 미디어 캡처를 통해 미디어를 녹화하는 경우 미디어 인스턴스와 캡처 인스턴스 간에 미디어가 암호화됩니다.

### 오디오/비디오
<a name="av-faqs"></a>

**Topics**
+ [일반](#av-general)
+ [코덱 및 동시 방송](#codecs-simulcast)
+ [울림 감소](#echo-reduction-faqs)
+ [소음 억제](#noise-suppression-faqs)
+ [배경 흐림](#bg-blur-faqs)
+ [화면 공유](#share-faqs)

#### 일반
<a name="av-general"></a>

##### Amazon Chime SDK는 백그라운드 상태일 때 비디오를 일시 중지하나요?
<a name="background-pause"></a>

아니요. 하지만 대역폭이 제한되면 비디오 스트림이 일시 중지될 수 있습니다.

##### 회의 중에 비디오 스트림과 타일의 우선 순위를 지정하려면 어떻게 해야 하나요? 회의 중에 특정 비디오 스트림을 중지할 수 있나요?
<a name="stream-priority"></a>

각 클라이언트가 구독하는 비디오 스트림을 프로그래밍 방식으로 제어할 수 있습니다. 이렇게 하면 '발표자 항상 표시' 또는 '회의 호스트 항상 표시'와 같은 로직을 페이지 나누기 방식으로 구현할 수 있습니다. 클라이언트에 리소스 제약이 있는 경우 우선순위가 가장 낮은 스트림을 끌 수 있습니다. 자세한 내용은 GitHub에서 [User Guide for Priority-based Downlink Policy](https://aws.github.io/amazon-chime-sdk-js/modules/prioritybased_downlink_policy.html)를 참조하세요.

#### 코덱 및 동시 방송
<a name="codecs-simulcast"></a>

##### 어떤 비디오 및 오디오 코덱을 지원하나요?
<a name="av-codecs"></a>

**비디오 코덱 **  
H.264, VP8, VP9, AV1

**오디오 코덱**  
Opus, 16kHz, 48kHz, 48kHz 스테레오

##### Amazon Chime SDK는 여러 해상도를 어떻게 지원하나요?
<a name="multi-resolution"></a>

 VP8 및 H.264를 통한 비디오 동시 방송과 VP9를 통한 확장 가능한 비디오 인코딩을 지원합니다. [JavaScript용 Amazon Chime SDK 클라이언트 라이브러리](https://aws.github.io/amazon-chime-sdk-js/index.html)를 사용하면 비디오 전송을 위한 코덱 기본 설정을 지정할 수 있습니다. iOS 및 Android 클라이언트 라이브러리는 디바이스의 기능에 따라 자동으로 코덱을 선택합니다. 비디오 코덱에 대한 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK 회의를 위한 비디오 코덱 구성](js-meeting-manage-codecs.md) 단원을 참조하세요. 적응형 동시 방송 및 다양한 정책에 대한 자세한 내용은 GitHub에서 [Video Simulcast](https://aws.github.io/amazon-chime-sdk-js/modules/simulcast.html)를 참조하세요.

#### 울림 감소
<a name="echo-reduction-faqs"></a>

##### 회의의 특정 참석자에게만 선택적으로 에코 감소를 적용할 수 있나요?
<a name="echo-reduction"></a>

아니요. 에코 감소는 [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) 또는 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html) API를 직접 호출하면 회의 수준에서 모든 참석자에게 적용됩니다. 에코 감소 사용에 대한 자세한 내용은 GitHub에서 [Adding Echo Reduction to your application](https://aws.github.io/amazon-chime-sdk-js/modules/amazonvoice_focus.html#adding-echo-reduction-to-your-application) 및 [Enabling Voice Focus with Echo Reduction](https://aws.github.io/amazon-chime-sdk-js/modules/amazonvoice_focus.html#enabling-voice-focus-with-echo-reduction)을 참조하세요.

#### 소음 억제
<a name="noise-suppression-faqs"></a>

##### Amazon Chime SDK는 어떤 소음 억제 공급자를 사용하나요?
<a name="noise-suppression"></a>

 AWS에서 구축한 소음 억제 기술인 Amazon Voice Focus를 사용합니다. Amazon Voice Focus에 대한 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK PTSN 오디오 서비스용 VoiceFocus 이해](voice-focus.md) 및 [Amazon Voice Focus 구성](network-config.md#voice-focus-config) 단원을 참조하세요.

##### 누가 소음 억제 기능을 켜고 끌 수 있나요?
<a name="suppression-on-off"></a>

솔루션을 코딩하는 방식에 따라 회의 참석자가 일반적으로 소음 억제 기능을 켜거나 끕니다. Amazon Chime SDK 클라이언트 라이브러리는 소음 억제를 위한 프로그래밍 방식의 제어 기능을 제공하며, 이를 구현하는 방법은 사용자가 선택할 수 있습니다. 예를 들어 토글 버튼을 제공하거나 소음 억제 기능을 제어할 수 있는 앱 수준의 설정을 제공할 수 있습니다. 자세한 내용은 GitHub에서 [Amazon Voice Focus](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/09_Amazon_Voice_Focus.md)를 참조하세요.

#### 배경 흐림
<a name="bg-blur-faqs"></a>

##### 배경 흐림은 얼마나 많은 CPU를 사용하나요?
<a name="blur-cpu"></a>

v1 및 v2 알고리즘이 있습니다. v1 알고리즘은 CPU 사용률(10%\~40%)에 따라 네 가지 옵션을 제공합니다. v2 알고리즘은 흐림의 양을 높음, 중간, 낮음으로 효과적으로 조절합니다. GitHub의 [JavaScript 브라우저 기반 데모](https://github.com/aws/amazon-chime-sdk-js/blob/59fe66553c09c1ef28747edf773f6cc52d3805a7/demos/browser/app/meetingV2/meetingV2.ts#L185)에서는 작업 예제를 제공합니다.

#### 화면 공유
<a name="share-faqs"></a>

##### 웹 클라이언트의 화면 공유 해상도는 어떻게 되나요?
<a name="share-resolution"></a>

JavaScript 클라이언트의 경우 브라우저에서 클라이언트 라이브러리의 화면 프레임을 제공합니다. 해상도는 공유 화면의 기본 해상도이며, 회의에서 지원하는 최대 해상도로 제한됩니다. 프레임 속도를 설정할 수 있지만 프레임 속도가 높을수록 CPU 부하가 증가한다는 점을 유의하세요.

공유할 코덱을 선택할 수도 있습니다. 표준 화질 회의의 경우 해상도는 1080p이며 1.5Mbps로 인코딩됩니다. 고화질 회의의 경우 해상도는 4K이며 2.5Mbps로 인코딩됩니다.

##### 모바일 디바이스 브라우저에서 내 화면을 공유할 수 없는 이유는 무엇인가요?
<a name="no-mobile-share"></a>

모바일 디바이스 브라우저는 화면 캡처 또는 화면 공유를 지원하지 않습니다. 화면 공유를 지원하는 앱을 개발하려면 GitHub에서 [iOS](https://github.com/aws/amazon-chime-sdk-ios) 또는 [Android](https://github.com/aws/amazon-chime-sdk-android) SDK를 사용해야 합니다. 자세한 내용은 GitHub에서 다음 주제를 참조하세요.
+ [콘텐츠 공유(JavaScript)](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/02_Content_Share.md)
+ [콘텐츠 공유(iOS)](https://github.com/aws/amazon-chime-sdk-ios/blob/master/guides/content_share.md)
+ [콘텐츠 공유(Android)](https://github.com/aws/amazon-chime-sdk-android/blob/master/guides/content_share.md)

### 라이브 트랜스크립션
<a name="transcription-faqs"></a>

#### 트랜스크립션에서 PII를 수정하려면 어떻게 해야 하나요?
<a name="pii-redaction"></a>

Amazon Transcribe를 사용하여 PII를 수정할 수 있습니다. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StartMeetingTranscription.html) API를 사용하여 회의를 트랜스크립션할 때 콘텐츠 수정 유형과 수정할 다른 PII 엔터티를 지정할 수 있습니다.

**참고**  
기계 학습의 예측적 특성으로 인해 Amazon Transcribe는 민감한 데이터의 인스턴스를 모두 식별하고 제거하지 못할 수 있으며, 1996년 미국 건강 보험 양도 및 책임에 관한 법률(HIPAA)과 같은 의료 개인정보 보호법을 준수하지 못할 수도 있습니다. 자세한 내용은 *Amazon Transcribe 개발자 안내서*에서 [개인 식별 정보 수정 또는 식별](https://docs.aws.amazon.com/transcribe/latest/dg/pii-redaction.html)을 참조하세요.

#### 회의 중에 트랜스크립션이 시작되거나 종료되는 시기를 추적할 수 있나요?
<a name="transcription-start-stop"></a>

예. `transcribeEvent`를 구독하면 모든 클라이언트가 해당 이벤트를 수신하며, 클라이언트에서 최종 사용자에게 해당 이벤트를 표시할 수 있습니다. 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK 라이브 트랜스크립션 이벤트 이해](transcription-events.md) 단원을 참조하세요.

다음 예는 `transcribeEvent`를 구독하는 한 가지 방법을 보여줍니다.

```
useEffect(() => {
        if (audioVideo) {
            audioVideo.transcriptionController?.subscribeToTranscriptEvent((transcriptEvent) => {
                setTranscripts(transcriptEvent);
            });
        }
    }, [audioVideo]);
```

`transcribeEvent` 사용에 대한 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK 라이브 트랜스크립션 이벤트 이해](transcription-events.md) 단원을 참조하세요.

#### 비속어는 어떻게 걸러내나요?
<a name="profanity"></a>

Amazon Transcribe를 사용하여 사용자 지정 어휘 및 어휘 필터를 생성하고, [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StartMeetingTranscription.html) API를 직접 호출할 때 `VocabularyFilterName` 및 `VocabularyFilterMethod` 값을 제공하여 원치 않는 단어를 마스킹할 수 있습니다. 자세한 내용은 *Amazon Transcribe 개발자 안내서*에서 [사용자 지정 어휘](https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html) 및 [어휘 필터 생성](https://docs.aws.amazon.com/transcribe/latest/dg/vocabulary-filter-create.html)을 참조하세요.

#### 회의에 실시간 트랜스크립션이 지원되는 언어는 무엇인가요?
<a name="transcript-languages"></a>

실시간 라이브 트랜스크립션을 위해 Amazon Transcribe는 다음 언어를 지원합니다.
+  중국어 간체(zh-CN)
+ 영어(호주(en-AU))
+ 영어(영국(en-GB))
+ 영어(미국(en-US))
+ 프랑스어(프랑스(fr-FR) 및 캐나다(fr-CA))
+ 독일어(de-DE)
+ 힌디어(hi-IN)
+ 이탈리아어(it-IT)
+ 일본어(jp-JP)
+ 한국어(ko-KR)
+ 포르투갈어(브라질(pt-BR))
+ 스페인어(미국(es-US))
+ 태국어(th-TH)

실시간 또는 일괄 트랜스크립션에 사용할 수 있는 언어에 대한 자세한 내용은 *Amazon Transcribe 개발자 안내서*에서 [지원되는 언어 및 언어별 기능](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html)을 참조하세요.

### Service Quotas
<a name="service-quota-faqs"></a>

#### US-EAST-1(버지니아 북부)에서 할당량을 업데이트했습니다. 업데이트는 US-EAST 엔드포인트에만 적용되나요?
<a name="quota-regions"></a>

예. 서비스 할당량은 API 엔드포인트별로 적용됩니다. 다른 API 엔드포인트로 전환하면 기본 제한이 적용됩니다.

### 네임스페이스 마이그레이션
<a name="migration-faqs"></a>

#### chime 네임스페이스에서 chimesdk 네임스페이스로 마이그레이션하는 방법에 대한 정보는 어디에서 찾을 수 있나요?
<a name="migration-info"></a>

이 안내서의 다음 주제를 참조하세요.
+ [Amazon Chime 네임스페이스에서 마이그레이션](migrate-from-chm-namespace.md).
+ [Amazon Chime SDK 회의 네임스페이스로 마이그레이션](meeting-namespace-migration.md).
+ [Amazon Chime SDK ID 네임스페이스로 마이그레이션](identity-namespace-migration.md).
+ [Amazon Chime SDK 음성 네임스페이스로 마이그레이션](voice-namespace-migration.md).

#### Amazon Chime SDK용 CloudWatch 이벤트는 전용 엔드포인트 및 네임스페이스에만 사용할 수 있나요?
<a name="no-cloudwatch"></a>

예. 이 이벤트를 사용하려면 `chime` 네임스페이스에서 `chimesdk` 네임스페이스로 마이그레이션해야 합니다. 자세한 내용은 이 안내서의 다음 주제를 참조하세요.
+ [Amazon Chime 네임스페이스에서 마이그레이션](migrate-from-chm-namespace.md).
+ [Amazon Chime SDK 회의 네임스페이스로 마이그레이션](meeting-namespace-migration.md).
+ [Amazon Chime SDK ID 네임스페이스로 마이그레이션](identity-namespace-migration.md).
+ [Amazon Chime SDK 음성 네임스페이스로 마이그레이션](voice-namespace-migration.md).

### 모니터링
<a name="monitoring-faqs"></a>

#### 날짜, 시간, 통화 시간, 참석자 등의 회의 데이터는 어떻게 추적하나요?
<a name="event-tracking"></a>

Amazon EventBridge, Amazon SNS 또는 Amazon SQS를 통해 회의 및 참석자 이벤트를 전송합니다. 이 이벤트에는 회의 시작 및 중지 시간, 참석자 참여, 이탈 및 나가기 작업 등의 정보가 포함됩니다. 회의 이벤트 및 이벤트 사용 방법에 대한 자세한 내용은 다음 주제를 참조하세요.
+ [Amazon Chime SDK 이벤트 알림 이해](mtgs-sdk-notifications.md)(이 안내서의 앞부분에 설명됨)
+ [Amazon Chime SDK 이벤트의 서버 측 로깅 및 모니터링](https://aws.amazon.com/blogs/business-productivity/server-side-logging-and-monitoring-of-amazon-chime-sdk-events/) 블로그 게시물
+ [Amazon Chime SDK 회의 이벤트를 통한 모니터링 및 문제 해결](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/) 블로그 게시물
+ [회의 이벤트](https://aws.github.io/amazon-chime-sdk-js/modules/meetingevents.html)(GitHub)

#### 어떤 CloudWatch 지표를 사용할 수 있나요?
<a name="cw-metrics-faq"></a>

`AttendeeAuthorizationSuccess`, `AttendeeAuthorizationErrors`, `AttendeeAudioDrops` 지표가 있습니다. 지표에 대한 자세한 내용은 이 안내서 앞부분에 있는 [Amazon Chime SDK 회의에 대한 Amazon CloudWatch 지표 이해](sdk-usage-metrics.md) 단원을 참조하세요.

#### 로깅 및 모니터링을 위한 대시보드를 구축하려면 어떻게 해야 하나요?
<a name="build-dashboard"></a>

Amazon Chime SDK는 오디오, 비디오, 화면 공유 또는 참석자 활동 등 클라이언트 애플리케이션에 있는 구성 요소의 다양한 상태를 기반으로 회의 이벤트를 생성합니다. 이러한 이벤트를 CloudWatch 로그에 기록한 다음 해당 로그에 대시보드를 구축할 수 있습니다. 다양한 이벤트, 오류 메시지 및 상태 코드를 포함시키면 데이터에서 인사이트를 얻을 수 있습니다.

또한 Amazon Chime SDK는 회의, 참석자 또는 미디어 파이프라인 생성 또는 삭제 요청과 같은 서버 측 이벤트를 추적하기 위해 Amazon EventBridge, Amazon SQS 및 Amazon SNS와 통합됩니다. 관심 있는 이벤트를 필터링하는 규칙을 구성하고 해당 이벤트를 CloudWatch 로그에 기록할 수 있습니다.

회의 이벤트 및 이를 사용하여 대시보드를 생성하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [회의 이벤트](https://aws.github.io/amazon-chime-sdk-js/modules/meetingevents.html)(GitHub)
+ [Amazon Chime SDK 회의 수명 주기 이벤트 이해](using-events.md)(이 안내서의 앞부분에 설명됨)
+ [Amazon Chime SDK 회의에 대한 Amazon CloudWatch 지표 이해](sdk-usage-metrics.md)(이 안내서의 앞부분에 설명됨)
+ [Amazon Chime SDK 이벤트 알림 이해](mtgs-sdk-notifications.md)(이 안내서의 앞부분에 설명됨)

사용해 보려면 다음 블로그 게시물의 지침을 따르세요.
+ [Amazon Chime SDK 이벤트의 서버 측 로깅 및 모니터링](https://aws.amazon.com/blogs/business-productivity/server-side-logging-and-monitoring-of-amazon-chime-sdk-events/)
+ [Amazon Chime SDK 회의 이벤트를 통한 모니터링 및 문제 해결](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/)

#### 회의가 자동으로 종료되는지 또는 DeleteMeeting API가 언제 호출되는지 모니터링하려면 어떻게 해야 하나요?
<a name="monitor-endings"></a>

회의를 종료하는 두 가지 방법 모두 `MeetingFailed` 이벤트를 트리거합니다. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html) API에 대한 Cloud Trail 또는 EventBridge 항목이 없는 경우 회의가 자동으로 종료된 것으로 간주할 수 있습니다.

### 로깅
<a name="logging-faqs"></a>

#### Google Chrome에서 WebRTC 디버그 로깅을 활성화하려면 어떻게 해야 하나요?
<a name="chrome-webrtc"></a>

`chrome —enable-logging —vmodule=*/webrtc/*=1` 명령과 플래그를 실행합니다. 그러면 WebRTC 에 대한 `IFO` 및 `VERBOSE` 로깅이 켜집니다. 결과 로그의 이름은 `chrome_debug.log`이며 Chrome 사용자 데이터 디렉터리에 저장됩니다.

#### macOS에서 Safari에 대한 WebRTC 디버그 로깅을 활성화하려면 어떻게 해야 하나요?
<a name="safari-webrtc"></a>

다음 단계를 따릅니다.

1. Safari에서 **설정**을 선택합니다.

1. **고급 옵션**을 선택한 다음 **웹 개발자용 기능 표시**를 선택합니다.

   브라우저에 **개발** 메뉴가 나타납니다.

1. **개발** 메뉴에서 ** JavaScript 콘솔 표시**를 선택합니다.

1.  JavaScript 콘솔에서 **설정**을 선택한 다음 WebRTC 로깅을 활성화합니다. 필요에 따라 기본 로깅 또는 상세 로깅을 선택할 수 있습니다.

### 오류 메시지
<a name="error-msg-faqs"></a>

#### “세션 중지됨 - 이유 - ICEGatheringTimeout Workground” 오류 문제를 해결하려면 어떻게 해야 하나요?
<a name="session-stopped"></a>

해결 방법:
+ IP 범위 99.77.128.0/18에서 UDP 포트 3478에 대한 송신이 활성화되어 있는지 확인합니다. 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK 회의를 위한 네트워크 구성](network-config.md) 단원을 참조하세요.
+ 바이러스 백신 브라우저 확장 프로그램이 리소스 로딩을 차단하지 않는지 확인합니다. UDP 3478은 TURN용이며 로컬 컴퓨터 방화벽 또는 회사 네트워크 방화벽의 최종 사용자 측에서 차단을 해제해야 합니다.
+ 연결 재시도는 포트 443을 통해 TLS로 되돌아가므로 도메인 또는 서브넷이 차단되지 않도록 해야 합니다.

#### “오류: 잘못된 캡처 파이프라인 ARN” 메시지는 무엇을 의미하나요?
<a name="invalid-capture"></a>

이 오류는 일반적으로 서비스가 미디어 파이프라인 ARN을 해결할 수 없을 때 발생합니다. ARN이 회의가 아닌 미디어 파이프라인에 속해 있는지 확인합니다. `MediaPipelineArn`은 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) API 응답의 일부입니다.

#### ‘AudioJoinedFromAnotherDevice’ 오류는 무엇을 의미하고 이를 방지하려면 어떻게 해야 하나요?
<a name="two-devices"></a>

이 오류는 동일한 참석자가 두 디바이스에서 참가할 때 발생합니다. 이 오류는 `meetingFailed` 이벤트의 `meetingErrorMessage` 속성에 반환됩니다. 이를 방지하려면 각 참석자에 고유한 `ExternalUserId`가 있는지 확인하고 두 개 이상의 회의에서 동시에 [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), [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html) 또는 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html) API의 동일한 참석자 응답을 사용하지 않도록 해야 합니다.

#### “금지됨: 계정 ID *111122223333*으로 Chime SDK를 호출할 권한이 없음” 오류를 해결하려면 어떻게 해야 하나요?
<a name="forbidden-meaning-1"></a>

더 이상 사용되지 않는 Amazon Chime API를 직접 호출하고 있는 것입니다. 문제를 해결하려면 Amazon Chime SDK 네임스페이스로 마이그레이션하세요. 자세한 내용은 이 안내서의 앞부분에 설명된 다음 주제를 참조하세요.
+ [Amazon Chime 네임스페이스에서 마이그레이션](migrate-from-chm-namespace.md).
+ [Amazon Chime SDK 회의 네임스페이스로 마이그레이션](meeting-namespace-migration.md).
+ [Amazon Chime SDK ID 네임스페이스로 마이그레이션](identity-namespace-migration.md).
+ [Amazon Chime SDK 음성 네임스페이스로 마이그레이션](voice-namespace-migration.md).

#### “금지됨: 계정 ID *111122223333*이 chime 엔드포인트에서 더 이상 사용되지 않는 Amazon Chime SDK API를 직접 호출할 수 있는 권한이 없음” 오류를 해결하려면 어떻게 해야 하나요?
<a name="forbidden-meaning-2"></a>

더 이상 사용되지 않는 Amazon Chime API를 직접 호출하고 있는 것입니다. 문제를 해결하려면 Amazon Chime SDK 네임스페이스로 마이그레이션하세요. 자세한 내용은 이 안내서의 앞부분에 설명된 다음 주제를 참조하세요.
+ [Amazon Chime 네임스페이스에서 마이그레이션](migrate-from-chm-namespace.md).
+ [Amazon Chime SDK 회의 네임스페이스로 마이그레이션](meeting-namespace-migration.md).
+ [Amazon Chime SDK ID 네임스페이스로 마이그레이션](identity-namespace-migration.md).
+ [Amazon Chime SDK 음성 네임스페이스로 마이그레이션](voice-namespace-migration.md).

#### 미디어 파이프라인의 경우 “런타임 오류: Chime에 연결하는 중 문제 발생: 활성 리소스가 없는 클라이언트 요청 토큰이 존재합니다. 클라이언트 요청 토큰을 다시 생성하세요” 오류를 해결하려면 어떻게 해야 하나요?
<a name="regenerate-token"></a>

클라이언트 요청 토큰은 API 요청을 무력화하는 고유 식별자입니다. 이 오류는 토큰이 비활성 미디어 파이프라인과 연결될 때 발생합니다. 문제를 해결하려면 고유 토큰을 새로 생성하고 API 요청과 함께 전송하세요.

## 미디어 파이프라인 FAQ
<a name="media-pipeline-faqs"></a>

### 미디어 캡처는 5초 세그먼트에 어떤 형식을 사용하나요?
<a name="segment-format"></a>

미디어 캡처는 MP4 형식을 사용합니다. 여기에는 5초 세그먼트, 결합된 레코딩 및 합성 파일이 포함됩니다.

### 미디어 캡처 파이프라인에서 생성한 참석자를 삭제하려면 어떻게 해야 하나요?
<a name="delete-bot"></a>

 미디어 캡처 참석자를 삭제하려면 파이프라인을 종료하거나 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html) API를 직접 호출할 수 있습니다.

### 레코딩은 클라우드에서 이루어지나요 아니면 로컬에서 이루어지나요?
<a name="cloud-local"></a>

미디어 캡처 파이프라인은 Amazon S3 버킷에 직접 레코딩합니다. 미디어 캡처 시 클라이언트에 대역폭이나 연결 요구 사항이 적용되지 않습니다.

### 회의와 관련하여 미디어 캡처를 어디에서 생성할 수 있나요?
<a name="create-capture"></a>

미디어 캡처를 생성할 리전을 선택하려면 먼저 사용 가능한 회의 컨트롤 플레인 리전에서 API 엔드포인트를 선택합니다. 그런 다음 해당 리전에서 회의 및 미디어 캡처 파이프라인을 생성합니다. 미디어 캡처는 모든 Amazon Chime SDK 미디어 리전에 있는 계정의 Amazon S3 버킷에 쓸 수 있습니다. 사용 가능한 리전 및 엔드포인트, 미디어 파이프라인 컨트롤 플레인 및 미디어 리전에 대한 자세한 내용은 이 안내서의 앞부분에 설명된 [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md) 단원 및 *AWS 참조 안내서*의 [Amazon Chime SDK 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html)을 참조하세요.

### 미디어 캡처는 회의 참석자 250명의 비디오를 모두 레코딩하나요?
<a name="all-250"></a>

아니요. 파이프라인은 처음 25개의 비디오 스트림만 캡처합니다.

### 회의가 진행되는 동안 레코딩을 중지할 수 있나요?
<a name="pipe-auto-end"></a>

지정된 시간 후에 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html) API를 직접 호출하는 메커니즘을 생성할 수 있습니다. 예를 들어 미디어 캡처가 시작되고 대기 시간이 미리 지정된 경우에 시작되는 단계 함수를 생성할 수 있습니다.

### 레코딩이 켜져 있는 동안 회의를 중지할 수 있나요?
<a name="auto-end-record"></a>

[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html) API를 호출하여 레코딩을 종료하거나 종료될 예정일 때 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html) API를 직접 호출할 수 있습니다. 회의 중에 미디어 캡처 참석자가 유일한 참석자인 경우 회의는 5분 후에 자동으로 종료됩니다.

## PSTN 오디오 FAQ
<a name="pstn-faqs"></a>

### PSTN 오디오를 사용하여 미국 외 번호에서 걸려온 인바운드 통화를 음성 커넥터로 라우팅할 수 있나요?
<a name="route-non-us"></a>

 아니요. 미국 외 번호는 PSTN 오디오를 사용하여 음성 커넥터로 라우팅할 수 없습니다.

### 참석자가 PSTN 오디오를 통해 연결한 경우 현재 회의에서 새 회의로 이동할 수 있나요?
<a name="move-attendees"></a>

예. 먼저 회의에 연결된 레그에 대해 [Hangup](hangup.md) 작업을 직접 호출합니다. 그러면 인바운드 통화를 종료하지 않고도 참석자의 회의 연결이 끊깁니다. 그런 다음 [JoinChimeMeeting](join-chime-meeting.md) 작업을 직접 호출하여 참석자를 새 회의에 참여시킵니다.