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

# Amazon Chime SDK 라이브 트랜스크립션 시작 및 중지
<a name="initiate-transcription"></a>

회의에 `TranscriptionConfiguration`을 적용하여 회의 트랜스크립션을 시작하려면 Amazon Chime SDK [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html) API를 사용합니다. Amazon Chime SDK 컨트롤러는 구성을 회의에 비동기적으로 전달합니다. Amazon Simple Notification Service(SNS) 및 Amazon EventBridge를 사용한 메시지를 통해 회의 트랜스크립션 시작의 성공 또는 실패 신호를 전달합니다.

**트랜스크립션 시작**  
이 예제에서는 Amazon Transcribe에서 라이브 트랜스크립션을 시작하는 방법을 보여줍니다.

```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{
    "TranscriptionConfiguration": {
        "EngineTranscribeSettings": {
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "en-US",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "tag",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "profanity",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "lingo",
            "Region": "us-east-1"
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": true,  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "high",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "ALL",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "language-model"
        }
    }
}
```

이 예제에서는 Amazon Transcribe Medical에서 라이브 트랜스크립션을 시작하는 방법을 보여줍니다.

```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{  
    "TranscriptionConfiguration": {
        "EngineTranscribeMedicalSettings": {
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "en-US",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PRIMARYCARE",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "CONVERSATION",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "lingo",
            "Region": "us-east-1",
           "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PHI", 
        }
   }
}
```

`StartMeetingTranscription` - 회의 트랜스크립션을 시작합니다.  
`meetingId` – [CreateMeeting API](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax)가 반환하는 회의 ID입니다.  
`TranscriptionConfiguration` - 라이브 트랜스크립션의 파라미터를 캡슐화합니다. 구성을 `EngineTranscribeSettings` 또는 `EngineTranscribeMedicalSettings`에서 정확히 하나만 지정해야 합니다.

`EngineTranscribeSettings` - Amazon Transcribe 사용을 지정하고 해당 설정을 [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters)로 전달합니다.  
`LanguageCode` - 필수입니다.  
`VocabularyFilterMethod` – 선택 사항입니다.  
`VocabularyFilterName` – 선택 사항입니다.  
`VocabularyName` – 선택 사항입니다.  
`Region` – 선택 사항입니다.  
`EnablePartialResultsStabilization` – 선택 사항입니다.  
`PartialResultsStability` – 선택 사항입니다.  
` ContentIdentificationType` – 선택 사항입니다.  
`ContentRedactionType` – 선택 사항입니다.  
`PiiEntityTypes ` – 선택 사항입니다.  
`LanguageModelName` – 선택 사항입니다.

`EngineTranscribeMedicalSettings` - Amazon Transcribe Medical 사용을 지정하고 해당 설정을 [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters)로 전달합니다.  
`LanguageCode` - 필수입니다.  
`Speciality` - 필수입니다.  
`Type` - 필수입니다.  
`VocabularyName` – 선택 사항입니다.  
`Region` – 선택 사항입니다.  
` ContentIdentificationType` – 선택 사항입니다.

**응답**  
Amazon Transcribe 및 Amazon Transcribe Medical은 다음과 같은 응답을 취합니다.
+ 회의에 `TranscriptionConfiguration`을 성공적으로 적용한 경우, 빈 본문과 함께 `OK` (200)

**오류 메시지**  
Amazon Transcribe 및 Amazon Transcribe Medical에 다음과 같은 오류 메시지가 표시됩니다.
+ **BadRequestException(400):** 입력 파라미터가 서비스 제한과 일치하지 않습니다.
+ **ForbiddenException(403):** 클라이언트의 요청이 영구적으로 금지됩니다.
+ **NotFoundException(404):** `meetingId`가 없습니다.
+ **ResourceLimitExceededException(400):** 요청이 리소스 한도를 초과합니다. 예를 들어 라이브 트랜스크립션을 활성화한 회의가 너무 많습니다.
+ **ServiceFailureException(500):** 서비스에서 예기치 않은 오류가 발생했습니다.
+ **ServiceUnavailableException(503):** 현재 서비스를 이용할 수 없습니다.
+ **ThrottledClientException(429):** 클라이언트가 요청 속도 제한을 초과했습니다.
+ **UnauthorizedClientException(401):** 클라이언트에 현재 요청 권한이 없습니다.

두 번째로 `StartMeetingTranscription`을 직접 호출하면 회의에 적용된 `TranscriptionConfiguration`이 업데이트됩니다.

**트랜스크립션 중지**  
[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html) API를 사용하여 지정된 `meetingID`의 `TranscriptionConfiguration`을 제거하고 회의 트랜스크립션을 종료할 수 있습니다. 회의를 종료하면 트랜스크립션이 자동으로 중지됩니다.

이 예제에서는 `StopMeetingTranscription`을 간접 호출하는 요청 구문을 보여줍니다.

```
POST/meetings/meetingId/transcription?operation=stop HTTP/1.1
```

**응답**  
Amazon Transcribe 및 Amazon Transcribe Medical은 다음과 같은 응답을 취합니다.
+ 회의에서 `TranscriptionConfiguration`을 성공적으로 제거한 경우, 빈 본문과 함께 `OK` (200)

**오류 메시지**  
Amazon Transcribe 및 Amazon Transcribe Medical에 다음과 같은 오류 메시지가 표시됩니다.
+ **BadRequestException(400):** 입력 파라미터가 서비스 제한과 일치하지 않습니다.
+ **ForbiddenException(403):** 클라이언트의 요청이 영구적으로 금지됩니다.
+ **NotFoundException(404):** `meetingId`가 없습니다.
+ **ServiceFailureException(500):** 서비스에서 예기치 않은 오류가 발생했습니다.
+ **ServiceUnavailableException(503):** 현재 서비스를 이용할 수 없습니다.
+ **ThrottledClientException(429):** 클라이언트가 요청 속도 제한을 초과했습니다.
+ **UnauthorizedClientException(401):** 클라이언트에 현재 요청 권한이 없습니다.