Amazon Chime SDK 라이브 트랜스크립션 시작 및 중지 - Amazon Chime SDK

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

Amazon Chime SDK 라이브 트랜스크립션 시작 및 중지

회의에 TranscriptionConfiguration을 적용하여 회의 트랜스크립션을 시작하려면 Amazon Chime SDK StartMeetingTranscription 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": {
            "LanguageCode": "en-US",  
            "VocabularyFilterMethod": "tag",
            "VocabularyFilterName": "profanity",
            "VocabularyName": "lingo",
            "Region": "us-east-1"
            "EnablePartialResultsStabilization": true,  
            "PartialResultsStability": "high",  
            "ContentIdentificationType": "PII",  
            "ContentRedactionType": "PII",  
            "PiiEntityTypes": "ALL",  
            "LanguageModelName": "language-model"
        }
    }
}

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

POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{  
    "TranscriptionConfiguration": {
        "EngineTranscribeMedicalSettings": {
            "LanguageCode": "en-US",
            "Specialty": "PRIMARYCARE",
            "Type": "CONVERSATION",
            "VocabularyName": "lingo",
            "Region": "us-east-1",
           "ContentIdentificationType": "PHI", 
        }
   }
}
StartMeetingTranscription - 회의 트랜스크립션을 시작합니다.

meetingId – CreateMeeting API가 반환하는 회의 ID입니다.

TranscriptionConfiguration - 라이브 트랜스크립션의 파라미터를 캡슐화합니다. 구성을 EngineTranscribeSettings 또는 EngineTranscribeMedicalSettings에서 정확히 하나만 지정해야 합니다.

EngineTranscribeSettings - Amazon Transcribe 사용을 지정하고 해당 설정을 Amazon Transcribe로 전달합니다.

LanguageCode - 필수입니다.

VocabularyFilterMethod – 선택 사항입니다.

VocabularyFilterName – 선택 사항입니다.

VocabularyName – 선택 사항입니다.

Region – 선택 사항입니다.

EnablePartialResultsStabilization – 선택 사항입니다.

PartialResultsStability – 선택 사항입니다.

ContentIdentificationType – 선택 사항입니다.

ContentRedactionType – 선택 사항입니다.

PiiEntityTypes – 선택 사항입니다.

LanguageModelName – 선택 사항입니다.

EngineTranscribeMedicalSettings - Amazon Transcribe Medical 사용을 지정하고 해당 설정을 Amazon Transcribe Medical로 전달합니다.

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이 업데이트됩니다.

트랜스크립션 중지

StopMeetingTranscription 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): 클라이언트에 현재 요청 권한이 없습니다.