設定串流轉錄

將下列政策連接至發出請求 IAM 的角色。如需詳細資訊，請參閱新增 IAM 政策。

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

若要開始工作階段，請將 HTTP/2 請求傳送至 Amazon Transcribe。

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. 您的資訊訊息資料框架包含事件編碼標頭，其中包含目前日期，以及音訊區塊和音訊事件的簽章。

   標頭名稱位元組長度	標頭名稱 (字串)	標頭值類型	值字串位元組長度	Value
   16	:chunk-signature	6	各有不同	產生的簽章
   5	:date	8	8	timestamp

   此請求中的二進位資料是以 base64 編碼。在實際請求中，資料是原始位元組。

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

2. 如 Signature 第 4 版中的建立字串以簽署所述，建構要簽署的字串。您的字串遵循以下格式：

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

   • DateTime：建立簽章的日期和時間。格式為 YYYYMMDDTHHMMSSZ，其中 YYYY=year、MM=month、DD=day、HH=hour、MM=minute、SS=seconds 和 'T' 和 'Z' 是固定字元。如需詳細資訊，請參閱 Signature 第 4 版的處理日期。

   • Keypath：格式 date/region/service/aws4_request 中的簽章範圍。例如：20220127/us-west-2/transcribe/aws4_request。

   • Hex：此函數會將其輸入編碼為十六進位表示法。

   • priorSignature：上一個影格的簽章。對於第一個資料框架，請使用標頭框架的簽章。

   • HexHash：函數會先建立其輸入的 SHA-256 雜湊，然後使用十六進位函數來編碼雜湊。

   • nonSignatureHeaders：編碼為字串的 DateTime 標頭。

   • payload：包含音訊事件資料的位元組緩衝區。

3. 從 AWS 秘密存取金鑰衍生簽署金鑰，並使用它來簽署 stringToSign。為了提供更大程度的保護，衍生的金鑰有專屬的日期、服務和 AWS 區域。如需詳細資訊，請參閱 AWS Signature 第 4 版的計算簽章。

   確保您實作該 GetSignatureKey 函數以衍生出您的簽名密鑰。如果您尚未衍生出簽名密鑰，請參閱 Signature 第 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為您的請求建構 並建立 Signature Version 4 簽章 ，請參閱下列步驟。範例是虛擬程式碼。

1. 建立正式請求。正式請求是其中包括來自您的請求的資訊的字串 (使用標準化格式)。這可確保 AWS 收到請求時，它可以計算您為 建立的相同簽章URL。如需詳細資訊，請參閱 Signature 第 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. 建立正式查詢字串。查詢字串值必須 URI- 編碼並依名稱排序。

   • 依照字元字碼指標的參數名稱遞增排序。​具有重複名稱的參數應依數值排序。例如，以大寫字母 F 開頭的參數名稱，放在以小寫字母 b 開頭的參數名稱之前。

   • 請勿 URI-編碼 3986 RFC 定義的任何未保留字元：A-Z、a-z、0-9、連字號 （ - ）、底線 （ _ ）、句點 （ . ） 和波浪 （ ~ ）。

   • 對所有其他含有 %XY 的字元執行百分比編碼，其中 X 和 Y 是十六進位字元 (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

建立要簽署的字串，其中包含有關您的請求的中繼資料。您在下一個步驟計算請求簽章時，使用此字串登入。如需詳細資訊，請參閱 Signature 第 4 版的建立簽署字串。

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

計算簽章。若要執行此操作，請從 AWS 秘密存取金鑰衍生簽署金鑰。為了提供更大程度的保護，衍生的金鑰有專屬的日期、服務和 AWS 區域。您使用衍生的金鑰以簽署請求。如需詳細資訊，請參閱計算簽章第 4 版的 AWS 簽章。

確保您實作該 GetSignatureKey 函數以衍生出您的簽名密鑰。如果您尚未衍生出簽名密鑰，請參閱 Signature 第 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

當 Amazon Transcribe 收到您的 WebSocket 請求時，它會以 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結構。