本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 開始即時通話分析轉錄
開始即時通話分析轉錄之前，您必須建立 Amazon Transcribe 要在通話中符合的所有[類別](tca-categories-stream.md)。
**注意**
通話分析轉錄無法追溯配對至新類別。只有您開始通話分析轉錄*前*建立的類別，才能套用至該轉錄輸出。
如果您已建立一或多個類別，且音訊符合至少一個類別中的所有規則， Amazon Transcribe 將標記輸出為符合的類別。如果您選擇不使用類別，或您的音訊與類別中指定的規則不符，系統就不會標示您的文字記錄。
若要將通話後分析納入即時通話分析轉錄中，您必須使用 `OutputLocation` 參數，在請求中提供 Amazon S3 儲存貯體。您還必須包含有指定儲存貯體寫入權限的 `DataAccessRoleArn`。您的即時通話分析串流工作階段完成後，系統會在指定的儲存貯體中產生並儲存獨立的文字記錄。
使用即時通話分析，您還可以選擇建立即時類別警示；請參閱 [建立類別配對的即時警示](#tca-create-alert-stream)，了解指示。
若要開始即時通話分析轉錄，您可以使用 **AWS 管理主控台**、**HTTP/2** 或 **WebSockets**；請參閱下列範例：
**重要**
目前， AWS 管理主控台 僅提供具有預先載入音訊範例的即時通話分析示範。如果您想要使用自己的音訊，您必須使用 API(HTTP/2、WebSockets 或 SDK)。
## AWS 管理主控台
使用以下程序以開始通話分析請求。會以該類別標示符合某個類別定義之所有特徵的通話。
**注意**
僅在 AWS 管理主控台可使用示範。若要啟動自訂即時分析轉錄，您必須使用 [API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)。
1. 在導覽窗格的 Amazon Transcribe 通話分析下，選擇**分析即時通話**。
![\[Amazon Transcribe 主控台螢幕擷取畫面：「分析串流通話」示範頁面。\]](http://docs.aws.amazon.com/zh_tw/transcribe/latest/dg/images/analytics-start-stream.png)
1. 對於**步驟 1：指定輸入音訊**，從下拉式功能表選擇示範測試檔案。
![\[Amazon Transcribe 主控台螢幕擷取畫面：示範輸入音訊的下拉式清單選項。\]](http://docs.aws.amazon.com/zh_tw/transcribe/latest/dg/images/analytics-start-stream-settings1.png)
1. 對於**步驟 2：檢視通話類別**，您可以選擇檢視先前建立的即時通話分析類別。所有即時通話分析類別都會套用至您的轉錄。
選擇**檢視類別**會開啟新窗格，顯示您現有的即時通話分析類別，並提供建立新類別的連結。
![\[Amazon Transcribe 主控台螢幕擷取畫面：「呼叫分析類別」頁面。\]](http://docs.aws.amazon.com/zh_tw/transcribe/latest/dg/images/analytics-start-stream-settings2.png)
1. 對於**步驟 3：配置輸入和輸出**，您可以選擇套用其他設定。
選擇**配置進階設定**會開啟新窗格，您可以在其中指定內容修訂設定。
![\[Amazon Transcribe 主控台螢幕擷取畫面：進階設定面板，全部收合。\]](http://docs.aws.amazon.com/zh_tw/transcribe/latest/dg/images/analytics-start-stream-settings3.png)
完成所有選擇後，選擇**儲存**，返回主頁面。
1. 若要套用其他分析，您可以開啟**通話後分析**。這提供與通話後分析轉錄相同的分析，包括中斷、響度、非通話時間、通話速度、通話時間、問題、行動項目和結果。通話後分析輸出會在與即時通話分析文字記錄不同的檔案儲存。
![\[Amazon Transcribe 主控台螢幕擷取畫面：通話後分析面板，收合。\]](http://docs.aws.amazon.com/zh_tw/transcribe/latest/dg/images/analytics-start-stream-post-call1.png)
如果您套用通話後分析，則必須指定 Amazon S3 輸出檔案目的地和 IAM 角色。您可以選擇加密輸出。
![\[Amazon Transcribe 主控台螢幕擷取畫面：通話後分析面板，已展開。\]](http://docs.aws.amazon.com/zh_tw/transcribe/latest/dg/images/analytics-start-stream-post-call1a.png)
1. 選擇**開始串流**。
## HTTP/2 串流
此範例會建立啟用通話分析的 HTTP/2 請求。如需搭配 使用 HTTP/2 串流的詳細資訊 Amazon Transcribe，請參閱 [設定 HTTP/2 串流](streaming-setting-up.md#streaming-http2)。如需特定參數和標頭的詳細資訊 Amazon Transcribe，請參閱 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)。
此範例包括[通話後分析](tca-post-call.md)。如果您不想進行通話後分析，請從請求中移除該 `PostCallAnalyticsSettings` 區段。
請注意，下列範例中顯示的組態事件必須作為串流中的第一個事件傳遞。
```
POST /stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartCallAnalyticsStreamTranscription
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: string
X-Amz-Date: 20220208T235959Z
Authorization: AWS4-HMAC-SHA256 Credential=access-key/20220208/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
{
"AudioStream": {
"AudioEvent": {
"AudioChunk": blob
},
"ConfigurationEvent": {
"ChannelDefinitions": [
{
"ChannelId": 0,
"ParticipantRole": "AGENT"
},
{
"ChannelId": 1,
"ParticipantRole": "CUSTOMER"
}
],
"PostCallAnalyticsSettings": {
"OutputLocation": "s3://amzn-s3-demo-bucket/my-output-files/",
"DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
}
}
}
}
```
您可以在 [API 參考](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html)中找到參數定義；所有 AWS API 操作通用的參數都列在[通用參數](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html)區段中。
## WebSocket 串流
此範例會建立預先簽署 URL，並在 WebSocket 串流中使用通話分析。已加入分行符號以提高可讀性。如需有關搭配 Amazon Transcribe使用 WebSocket 串流的詳細資訊，請參閱 [設定 WebSocket 串流](streaming-setting-up.md#streaming-websocket)。如需參數詳細資訊，請參閱 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)。
此範例包括[通話後分析](tca-post-call.md)。如果您不想進行通話後分析，請從請求中移除該 `PostCallAnalyticsSettings` 區段。
請注意，下列範例中顯示的組態事件必須作為串流中的第一個事件傳遞。
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/call-analytics-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-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
{
"AudioStream": {
"AudioEvent": {
"AudioChunk": blob
},
"ConfigurationEvent": {
"ChannelDefinitions": [
{
"ChannelId": 0,
"ParticipantRole": "AGENT"
},
{
"ChannelId": 1,
"ParticipantRole": "CUSTOMER"
}
],
"PostCallAnalyticsSettings": {
"OutputLocation": "s3://amzn-s3-demo-bucket/my-output-files/",
"DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
}
}
}
}
```
您可以在 [API 參考](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html)中找到參數定義；所有 AWS API 操作通用的參數會列在[通用參數](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html)區段中。
**提示**
以上 HTTP/2 和 WebSocket 的範例包括通話後分析。如果您不想進行通話後分析，請從請求中移除該 `PostCallAnalyticsSettings` 區段。
如果啟用 `PostCallAnalyticsSettings`，則必須傳送組態事件作為第一個事件。如前面的範例所示，您的組態事件包括 `ChannelDenifitions` 和 `PostStreamAnalyticsSettings` 的設定。
二進位資料會連同 `content-type application/octet-stream` 以二進位訊息的格式傳遞，且組態事件會連同 `content-type application/json` 以文字訊息的格式傳遞。
如需詳細資訊，請參閱[設定串流轉錄](streaming-setting-up.md)。
## 建立類別配對的即時警示
若要設定即時警示，您必須先建立帶 `REAL_TIME` 標記的 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html) 類別。此標記可讓您的類別套用至即時通話分析轉錄。
如需建立新類別的說明，請參閱 [建立即時轉錄的類別](tca-categories-stream.md)。
您開始進行即時通話分析轉錄時，所有有 `REAL_TIME` 標識的類別都會自動套用至區段層級的轉錄輸出。如果有 `TranscriptFilterType` 相符項目，會在您的文字記錄 `CategoryEvent` 區段下方出現。然後，您可以使用此參數及其子參數，`MatchedCategories` 及 `MatchedDetails` 設定自訂即時警示。
以下是 `CategoryEvent` 相符項目的即時通話分析轉錄輸出的範例：
```
"CategoryEvent": {
"MatchedCategories": [ "shipping-complaint" ],
"MatchedDetails": {
"my package never arrived" : {
"TimestampRanges": [
{
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22690
}
]
}
}
},
```
前一個範例代表與「*我的包裹從未送達*」的語音完全相符的文字，代表屬於「shipping-complaint」類別中的規則。
您可以設定即時警示，以包含所列參數的任何組合。例如，您可以將警示設定為僅包含符合的片語 (`MatchedDetails`) 或僅包含類別名稱 (`MatchedCategories`)。或者，您可以將警示設定為包含所有參數。
設定即時警示的方式需視組織的介面和所需的警示類型而定。例如，您可以設定 `CategoryEvent` 配對以傳送快顯通知、電子郵件、文字或系統可接受的任何其他警示。