스트리밍 트랜스크립션 설정

요청을 수행하는 IAM 역할에 다음 정책을 연결합니다. 자세한 내용은 IAM 정책 추가를 참조하세요.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "my-transcribe-http2-policy",
            "Effect": "Allow",
            "Action": "transcribe:StartStreamTranscription",
            "Resource": "*"
        }
    ]
}

세션을 시작하려면 Amazon Transcribe로 HTTP/2 요청을 전송합니다.

POST /stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartStreamTranscription
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: string
X-Amz-Date: YYYYMMDDTHHMMSSZ
Authorization: AWS4-HMAC-SHA256 Credential=access-key/YYYYMMDD/us-west-2/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature=string
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000
transfer-encoding: chunked

추가 작업 및 파라미터는 API 참조에 나열되어 있으며, 모든 AWS API 작업에 공통적인 파라미터는 공통 파라미터 섹션에 나열되어 있습니다.

Amazon Transcribe 는 다음 응답을 전송합니다.

HTTP/2.0 200
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000
x-amzn-request-id: 8a08df7d-5998-48bf-a303-484355b4ab4e
x-amzn-transcribe-session-id: b4526fcf-5eee-4361-8192-d1cb9e9d6887
content-type: application/json

오디오 데이터가 포함된 오디오 이벤트를 만듭니다. 다음 테이블에 설명된 헤더를 오디오 바이트 청크와 결합하여 이벤트 코딩된 메시지를 만듭니다. 이벤트 메시지에 대한 페이로드를 만들려면 원시 바이트 형식의 버퍼를 사용합니다.

이 예시의 이진 데이터는 base64로 인코딩됩니다. 실제 요청에서 데이터는 원시 바이트입니다.

:content-type: "application/vnd.amazon.eventstream"
:event-type: "AudioEvent"
:message-type: "event"
UklGRjzxPQBXQVZFZm10IBAAAAABAAEAgD4AAAB9AAACABAAZGF0YVTwPQAAAAAAAAAAAAAAAAD//wIA/f8EAA==

오디오 데이터가 포함된 오디오 메시지를 만듭니다.

1. 오디오 메시지 데이터 프레임에는 오디오 청크 및 오디오 이벤트에 대한 현재 날짜와 서명이 포함된 이벤트 인코딩 헤더가 포함됩니다.

   헤더 이름 바이트 길이	헤더 이름(문자열)	헤더 값 유형	값 문자열 바이트 길이	값
   16	:청크 서명	6	varies	생성된 서명
   5	:날짜	8	8	타임스탬프

   이 요청의 이진 데이터는 base64로 인코딩됩니다. 실제 요청에서 데이터는 원시 바이트입니다.

   :date: 2019-01-29T01:56:17.291Z
   :chunk-signature: signature
   
   AAAA0gAAAIKVoRFcTTcjb250ZW50LXR5cGUHABhhcHBsaWNhdGlvbi9vY3RldC1zdHJlYW0LOmV2ZW50LXR5
   cGUHAApBdWRpb0V2ZW50DTptZXNzYWdlLXR5cGUHAAVldmVudAxDb256ZW50LVR5cGUHABphcHBsaWNhdGlv
   bi94LWFtei1qc29uLTEuMVJJRkY88T0AV0FWRWZtdCAQAAAAAQABAIA+AAAAfQAAAgAQAGRhdGFU8D0AAAAA
   AAAAAAAAAAAA//8CAP3/BAC7QLFf

2. 서명 버전 4의 서명할 문자열 만들기에 설명된 대로 서명할 문자열을 구성합니다. 문자열은 다음 형식을 따릅니다.

   String stringToSign =
   "AWS4-HMAC-SHA256" +
   "\n" +
   DateTime +
   "\n" +
   Keypath +
   "\n" +
   Hex(priorSignature) +
   "\n" +
   HexHash(nonSignatureHeaders) +
   "\n" +
   HexHash(payload);

   • DateTime: 서명이 생성된 날짜 및 시간. 형식은 YYYYMMDDTHHMMSSZ입니다. 여기서 YYYY=년, MM=월, DD=일, HH=시간, MM=분, SS=초이고, 'T'와 'Z'는 고정 문자입니다. 자세한 내용은 서명 버전 4의 날짜 처리를 참조하세요.

   • Keypath: 서명은 date/region/service/aws4_request 형식으로 표시됩니다. 예: 20220127/us-west-2/transcribe/aws4_request.

   • Hex: 입력을 16진수 형식으로 인코딩하는 함수.

   • priorSignature: 이전 프레임의 서명. 첫 데이터 프레임에는 헤더 프레임의 서명을 사용합니다.

   • HexHash: 먼저 입력의 SHA-256 해시를 생성한 후 함수를 사용하여 해시를 인코딩하는 함수.

   • nonSignatureHeaders: 문자열로 인코딩된 DateTime 헤더.

   • payload: 오디오 이벤트 데이터가 포함된 바이트 버퍼.

3. AWS 보안 액세스 키에서 서명 키를 파생하고 이를 사용하여에 서명합니다stringToSign. 생성된 키는 더 높은 수준의 보호를 위해 날짜, 서비스 및 AWS 리전에 고유합니다. 자세한 내용은 AWS서명 버전 4의 서명 계산을 참조하세요.

   서명 키를 추출하는 GetSignatureKey 함수를 구현했는지 확인합니다. 서명 키를 아직 추출하지 않은 경우 서명 버전 4에 대한 서명 키 생성 방법을 보여주는 예를 참조하세요.

   String signature = HMACSHA256(derivedSigningKey, stringToSign);

   • HMACSHA256: SHA-256 해시 함수를 사용하여 서명을 만드는 함수.

   • derivedSigningKey: 서명 버전 4 서명 키.

   • stringToSign: 데이터 프레임에 대해 계산된 문자열.

   데이터 프레임의 서명을 계산한 후 날짜, 서명 및 오디오 이벤트 페이로드가 포함된 바이트 버퍼를 구성합니다. 바이트 배열을 트랜스크립션을 수행할 Amazon Transcribe 로 보냅니다.

오디오 스트림의 완료를 알리기 위해 날짜와 서명만 포함된 빈 데이터 프레임을 전송합니다. 이 종료 프레임은 데이터 프레임을 구성한 것과 동일한 방식으로 구성합니다.

Amazon Transcribe 는 애플리케이션으로 전송되는 트랜스크립션 이벤트 스트림으로 응답합니다. 이 응답은 이벤트 스트림 인코딩됩니다. 여기에는 표준 서문과 다음 헤더가 포함됩니다.

이벤트는 원시 바이트 형식으로 전송됩니다. 이 예에서 바이트는 base64로 인코딩됩니다.

AAAAUwAAAEP1RHpYBTpkYXRlCAAAAWiXUkMLEDpjaHVuay1zaWduYXR1cmUGACCt6Zy+uymwEK2SrLp/zVBI
5eGn83jdBwCaRUBJA+eaDafqjqI=

트랜스크립션 결과를 보려면 이벤트 스트림 인코딩을 사용하여 원시 바이트를 디코딩합니다.

:content-type: "application/vnd.amazon.eventstream"
:event-type: "TranscriptEvent"
:message-type: "event"

{
    "Transcript":
        {
            "Results":
                [
                    results
                ]
        }
}

스트리밍을 종료하려면 Amazon Transcribe로 빈 오디오 이벤트를 전송합니다. 빈 페이로드를 제외하고 오디오 이벤트는 다른 오디오 이벤트와 동일하게 만듭니다. 이벤트를 서명하고 서명을 다음과 같이 :chunk-signature 헤더에 포함합니다.

:date: 2019-01-29T01:56:17.291Z
:chunk-signature: signature

요청을 수행하는 IAM 역할에 다음 정책을 연결합니다. 자세한 내용은 IAM 정책 추가를 참조하세요.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "my-transcribe-websocket-policy",
            "Effect": "Allow",
            "Action": "transcribe:StartStreamTranscriptionWebSocket",
            "Resource": "*"
        }
    ]
}

세션을 시작하려면 다음 형식으로 미리 서명된 URL을 만듭니다. 가독성을 높이기 위해 줄바꿈이 추가되었습니다.

GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=access-key%2FYYYYMMDD%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=YYYYMMDDTHHMMSSZ
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=string
&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date
&language-code=en-US
&media-encoding=flac
&sample-rate=16000

추가 작업 및 파라미터는 API 참조에 나열되어 있으며, 모든 AWS API 작업에 공통적인 파라미터는 공통 파라미터 섹션에 나열되어 있습니다.

요청에 대한 URL과 서명 버전 4 서명을 생성하려면 다음 단계를 참조하세요. 유사 코드의 예시입니다.

1. 표준 요청을 생성합니다. 표준 요청은 표준화된 형식으로 된 요청의 정보가 포함된 문자열입니다. 이렇게 하면가 요청을 AWS 수신할 때 URL에 대해 생성한 것과 동일한 서명을 계산할 수 있습니다. 자세한 내용은 서명 버전 4에 대한 표준 요청 생성을 참조하세요.

   # HTTP verb
   method = "GET"
   # Service name
   service = "transcribe"
   # Region
   region = "us-west-2"
   # Amazon Transcribe streaming endpoint
   endpoint = "wss://transcribestreaming.us-west-2.amazonaws.com:8443"
   # Host
   host = "transcribestreaming.us-west-2.amazonaws.com:8443"
   # Date and time of request
   amz-date = YYYYMMDDTHHMMSSZ
   # Date without time for credential scope
   datestamp = YYYYMMDD

2. 도메인과 쿼리 문자열 간의 URI 부분인 표준 URI를 생성합니다.

   canonical_uri = "/stream-transcription-websocket"

3. 표준 헤더 및 서명된 헤더를 생성합니다. 표준 헤더의 후행 \n에 유의하세요.

   • 소문자 헤더 이름과 콜론( : )을 차례대로 추가합니다.

   • 헤더에 대한 쉼표로 구분된 값 목록을 추가합니다. 여러 값을 가진 헤더에서 값을 정렬하지 마세요.

   • 새 줄(\n)을 추가합니다.

   canonical_headers = "host:" + host + "\n"
   signed_headers = "host"

4. 이 알고리즘을 해싱 알고리즘과 일치시킵니다. SHA-256를 사용합니다.

   algorithm = "AWS4-HMAC-SHA256"

5. 생성된 키의 범위를 날짜, AWS 리전및 서비스로 지정하는 자격 증명 범위를 생성합니다. 예: 20220127/us-west-2/transcribe/aws4_request.

   credential_scope = datestamp + "/" + region + "/" + service + "/" + "aws4_request"

6. 표준 쿼리 문자열을 생성합니다. 쿼리 문자열 값은 URL로 인코딩되어야 하며 이름을 기준으로 정렬되어야 합니다.

   • 문자 코드 포인트를 기준으로 파라미터 이름을 오름차순으로 정렬합니다. ​중복된 이름을 가진 파라미터는 값별로 정렬해야 합니다. 예를 들어 대문자 F로 시작하는 파라미터 이름 앞에 소문자 b로 시작하는 파라미터 이름이 옵니다.

   • 예약되지 않은 문자는 URI로 인코딩하지 않습니다. RFC 3986에 정의된 예약되지 않은 문자는 A-Z, a-z, 0-9, 하이픈( - ), 밑줄( _ ), 마침표( . ) 및 물결표( ~ )입니다.

   • %XY와 같이 모든 기타 문자를 퍼센트 인코딩합니다. 여기서 X 및 Y는 16진 문자(0 ~ 9 및 대문자 A ~ F)입니다. 예를 들어 공백 문자는 %20(일부 인코딩 구조처럼 +를 넣지 말 것)로 인코딩되고, 확장 UTF-8 문자는 %XY%ZA%BC 형식이어야 합니다.

   • 매개변수 값에서 등호(=) 문자를 두 번 인코딩합니다.

   canonical_querystring  = "X-Amz-Algorithm=" + algorithm
   canonical_querystring += "&X-Amz-Credential="+ URI-encode(access key + "/" + credential_scope)
   canonical_querystring += "&X-Amz-Date=" + amz_date 
   canonical_querystring += "&X-Amz-Expires=300"
   canonical_querystring += "&X-Amz-Security-Token=" + token
   canonical_querystring += "&X-Amz-SignedHeaders=" + signed_headers
   canonical_querystring += "&language-code=en-US&media-encoding=flac&sample-rate=16000"

7. 페이로드의 해시를 생성합니다. GET 요청의 경우 페이로드는 빈 문자열입니다.

   payload_hash = HashSHA256(("").Encode("utf-8")).HexDigest()

8. 다음 요소를 결합하여 표준 요청을 생성합니다.

   canonical_request = method + '\n' 
      + canonical_uri + '\n' 
      + canonical_querystring + '\n' 
      + canonical_headers + '\n' 
      + signed_headers + '\n' 
      + payload_hash

서명할 문자열을 생성합니다. 여기에는 요청에 대한 메타 정보가 포함됩니다. 요청 서명을 계산할 때 다음 단계의 서명할 문자열을 사용합니다. 자세한 내용은 서명 버전 4에 대한 서명할 문자열 생성을 참조하세요.

string_to_sign=algorithm + "\n"
   + amz_date + "\n"
   + credential_scope + "\n"
   + HashSHA256(canonical_request.Encode("utf-8")).HexDigest()

서명을 계산합니다. 이렇게 하려면 AWS 보안 액세스 키에서 서명 키를 추출합니다. 생성된 키는 더 높은 수준의 보호를 위해 날짜, 서비스 및 AWS 리전에 고유합니다. 생성된 키를 사용하여 요청에 서명합니다. 자세한 내용은 서명 버전 4의 AWS 서명 계산을 참조하세요.

서명 키를 추출하는 GetSignatureKey 함수를 구현했는지 확인합니다. 서명 키를 아직 추출하지 않은 경우 서명 버전 4에 대한 서명 키 생성 방법을 보여주는 예를 참조하세요.

#Create the signing key
signing_key = GetSignatureKey(secret_key, datestamp, region, service)
                
# Sign the string_to_sign using the signing key
signature = HMAC.new(signing_key, (string_to_sign).Encode("utf-8"), Sha256()).HexDigest

HMAC(key, data) 함수는 결과를 이진 형식으로 반환하는 HMAC-SHA256 함수를 나타냅니다.

요청에 서명 정보를 추가하고 요청 URL을 생성합니다.

서명을 계산한 후 쿼리 문자열에 추가합니다. 자세한 내용은 요청에 서명 추가를 참조하세요.

첫째, 쿼리 문자열에 인증 정보를 추가합니다.

canonical_querystring += "&X-Amz-Signature=" + signature

둘째, 요청에 대한 URL을 생성합니다.

request_url = endpoint + canonical_uri + "?" + canonical_querystring

요청 URL을 WebSocket 라이브러리와 함께 사용하여 Amazon Transcribe에 대한 요청을 수행합니다.

에 대한 요청에는 다음 헤더가 포함되어야 Amazon Transcribe 합니다. 일반적으로 이러한 헤더는 WebSocket 클라이언트 라이브러리에서 관리합니다.

Host: transcribestreaming.us-west-2.amazonaws.com:8443
Connection: Upgrade
Upgrade: websocket
Origin: URI-of-WebSocket-client
Sec-WebSocket-Version: 13
Sec-WebSocket-Key: randomly-generated-string

가 WebSocket 요청을 Amazon Transcribe 수신하면 WebSocket 업그레이드 응답으로 응답합니다. 일반적으로 WebSocket 라이브러리는이 응답을 관리하고 통신용 소켓을 설정합니다 Amazon Transcribe.

다음은의 응답입니다 Amazon Transcribe. 가독성을 높이기 위해 줄바꿈이 추가되었습니다.

HTTP/1.1 101 WebSocket Protocol Handshake

Connection: upgrade
Upgrade: websocket
websocket-origin: wss://transcribestreaming.us-west-2.amazonaws.com:8443
websocket-location: transcribestreaming.us-west-2.amazonaws.com:8443/stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
&language-code=en-US
&session-id=String
&media-encoding=flac
&sample-rate=16000
x-amzn-RequestId: RequestId
Strict-Transport-Security: max-age=31536000
sec-websocket-accept: hash-of-the-Sec-WebSocket-Key-header

WebSocket 스트리밍을 요청합니다.

WebSocket 연결이 설정되면 클라이언트는 각각 이벤트 스트림 인코딩을 사용하여 인코딩한 오디오 프레임 시퀀스 전송을 시작할 수 있습니다.

각 데이터 프레임에는 원시 오디오 바이트의 청크와 결합된 세 개의 헤더가 있으며, 다음 테이블은 이러한 헤더를 설명한 것입니다.

데이터 스트림을 종료하려면 이벤트 스트림 인코딩 메시지에 빈 오디오 청크를 보냅니다.

응답에는 페이로드의 이벤트 스트림 인코딩 원시 바이트가 포함되어 있습니다. 여기에는 표준 서문과 다음 헤더가 포함됩니다.

이진 응답을 디코딩할 때 트랜스크립션 결과가 포함된 JSON 구조로 종료합니다.