本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon Chime SDK 的通話分析組態
若要使用通話分析組態處理音訊，您必須建立通話分析管道，也稱為媒體洞察管道。在通話期間建立管道以處理音訊，並在通話結束時終止。通話分析管道需要通話分析組態的 ARN，以及音訊來源的相關資訊。通話分析組態包含音訊處理器、洞見目的地和提醒事件組態的詳細資訊，*但不包括音訊來源*。這可讓您在不同的通話分析工作流程中重複使用組態，例如使用不同的語音連接器或 KVS 來源。呼叫分析管道會叫用組態中指定的機器學習服務，並記錄音訊。您可以在通話結束時手動或自動停止管道。
您可以在各種使用案例中使用通話分析管道。下列工作流程顯示使用通話分析組態和管道的潛在方法。
**Topics**
+ [了解記錄 Amazon Chime SDK 呼叫的工作流程](recording-workflows.md)
+ [了解 Amazon Chime SDK 機器學習型分析的工作流程](ml-based-analytics.md)
# 了解記錄 Amazon Chime SDK 呼叫的工作流程
本節中的主題會列出並描述記錄通話和 Kinesis Video Streams 的工作流程。
# 錄製語音連接器呼叫
在下列情況下使用此工作流程：
+ 您已使用或計劃使用 Voice Connector 將 SIP 媒體帶入通話分析。
**注意**
Voice Connectors 支援 SIP 和 SIPREC。如需詳細資訊，請參閱《[Amazon Chime SDK 管理員指南》中的管理 Amazon Chime SDK 語音連接器](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html)。 **
+ 您想要自動記錄對您選擇的 Amazon Simple Storage Service 目的地具有低延遲的 SIP 或 SIPREC 呼叫。
+ 您想要使用 Amazon Chime SDK 主控台來建立組態，並將其與語音連接器建立關聯。
+ 您想要將相同的錄製組態套用至每個 Voice Connector 呼叫。如果您想要將多個組態套用至一或多個語音連接器，請參閱下一節。
若要以程式設計方式啟用呼叫，請使用下列 Amazon Chime SDK APIs。
+ 使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 建立呼叫分析組態
+ 使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html) 建立語音連接器。
+ 使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) API 將組態與語音連接器建立關聯。
如需詳細資訊，請參閱《*Amazon Chime SDK 管理員指南*》中的[設定語音連接器以使用通話分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
下圖顯示語音連接器啟動通話錄音工作階段時的資料流程。圖表中的數字對應於下方的編號文字。
![\[此圖顯示語音連接器開始記錄通話時的資料流程。\]](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)
在圖表中：
1. 使用 Amazon Chime SDK 主控台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 來建立呼叫分析組態。在組態建立過程中，您只需啟用通話錄音、選擇所需的錄音檔案格式，以及指定 Amazon S3 目的地來存放錄音檔案。如需詳細資訊，請參閱《*Amazon Chime SDK 管理員指南*》中的[建立通話分析組態](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-ca-config.html)。
1. 您可以使用 Amazon Chime SDK 主控台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) API，將組態與語音連接器建立關聯。若要使用主控台，請參閱[設定語音連接器以使用通話分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
1. 在外撥通話期間，語音連接器會收到每個通話參與者的音訊。
1. 如果通話分析錄音組態連接至 Voice Connector，則 Voice Connector 服務會使用媒體管道服務來啟動通話分析錄音工作階段。
1. 媒體管道服務會啟動通話錄音處理器，以監控正在進行的通話。
1. 當呼叫結束時，媒體管道服務會將呼叫記錄檔案交付至指定的 Amazon S3 儲存貯體，並透過 Amazon Kinesis Data Stream 提供記錄中繼資料。如果已啟用資料倉儲，呼叫中繼資料也會前往 Amazon Simple Storage Service 資料倉儲。如果使用 SIPREC 將 SIP 音訊納入通話分析，則通話中繼資料會以資料表格式包含 SIPREC 中繼資料。如需錄製資料表的詳細資訊，請參閱本節[了解 Amazon Chime SDK AWS Glue 的資料目錄資料表](glue-tables.md)稍後的 。
1. 媒體管道服務會將管道狀態事件傳送至預設的 Amazon EventBridge。如需詳細資訊，請參閱本指南中的[使用 EventBridge 通知](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html)。
**注意**
請注意，您必須啟用 Voice Connector 串流，才能使用 Voice Connector 進行錄製。此功能可讓您將通話資料串流到帳戶中的 Voice Connector 受管 Kinesis Video Streams。如需詳細資訊，請參閱[《Amazon Chime SDK 管理員指南》中的將 Amazon Chime SDK Voice Connector 媒體串流至 Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html)。 **
您也可以將 Voice Connector 建立的通話資料存放在 Kinesis Video Streams 中，持續時間從數小時到數天甚至數年不等。選擇不保留資料會限制呼叫資料的可用性，以供立即使用。Kinesis Video Streams 的成本取決於使用的頻寬和總儲存體。您可以在 Voice Connector 串流組態內隨時調整資料保留期間。若要啟用通話分析記錄，您必須確保 Kinesis Video Stream 保留資料的時間足以執行通話分析。您可以透過指定適當的資料保留期來執行此操作。
您可以將通話洞見管道組態與任意數量的語音連接器建立關聯。您也可以為每個語音連接器建立不同的組態。Voice Connectors 使用 AWSServiceRoleForAmazonChimeVoiceConnector 為每個交易 ID 代表您呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API 一次。如需角色的相關資訊，請參閱《[Amazon Chime SDK 管理員指南》中的使用 Amazon Chime SDK Voice Connectors 的 Amazon Chime SDK 服務連結角色](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream)。 **
# 使用 Amazon Kinesis Video 串流生產者進行錄製
在以下情況下，您會記錄 Amazon Kinesis Video 串流：
+ 您需要將不同的組態套用至呼叫，而不是針對每個 Voice Connector 呼叫使用相同的組態。
+ 您想要記錄語音連接器未處理的 SIP 或非 SIP 音訊。
若要使用此通話錄音選項，您需要將音訊發佈至 Kinesis Video Streams (KVS)，然後使用 KVS 串流頻道資訊和通話分析組態 ARN 呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
**注意**
呼叫分析 APIs 最多支援兩個音訊通道。您也可以啟用 Voice Connector 串流，然後使用在 Voice Connector 的 EventBridge 通知中發佈的 KVS 資訊來啟動通話錄音。
呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API 時，您可以選擇是否要為每個 KVS 串流頻道定義指定片段編號。如果您提供片段號碼，呼叫分析將開始處理該片段的串流。如果您未指定片段 ID，呼叫分析會開始處理來自最新可用片段的串流。
下圖顯示語音連接器啟動通話錄音工作階段時的資料流程。圖表中的數字對應於下方的編號文字。
![\[此圖顯示語音連接器開始記錄通話時的資料流程。\]](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/images/call-analytics-workflow-2.png)
在圖表中：
1. 您可以使用 Amazon Chime SDK 主控台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 來建立通話錄音組態。
1. 使用 AWS SDK 建立將外部音訊推送至 KVS 的應用程式，或啟用 Voice Connector 串流以自動將通話音訊發佈至 KVS。如需詳細資訊，請參閱[《Amazon Chime SDK 管理員指南》中的將 Amazon Chime SDK Voice Connector 媒體串流至 Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html)。 **
1. 如果啟用 Voice Connector 串流，語音連接器服務會將通知傳送至預設的 EventBridge。
1. 在 Voice Connector 串流的情況下，您的應用程式可以使用來自 EventBridge 的 Amazon Chime Voice Connector 串流`STARTED`事件來收集有關通話分支的 KVS 串流資訊。
1. 一旦應用程式擁有來自 Voice Connector 串流事件或外部來源的音訊資訊，您的應用程式就會叫用 Amazon Chime SDK [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
1. 媒體管道服務會啟動通話錄音處理器，以監控正在進行的通話。
1. 媒體管道服務會將管道狀態事件傳送至預設的 Amazon EventBridge。如需詳細資訊，請參閱[使用 EventBridge 通知](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html)。
1. 通話完成後，媒體管道服務會將通話錄音檔案交付至指定的 Amazon S3 儲存貯體，並透過 Amazon Kinesis Data Stream 提供錄音中繼資料。如果已啟用資料倉儲，呼叫中繼資料也會傳送至 Amazon S3 資料倉儲。如果使用 SIPREC 將 SIP 音訊納入通話分析，則通話中繼資料將以方便的資料表格式包含 SIPREC 中繼資料。如需錄製資料表的詳細資訊，請參閱本節[了解 Amazon Chime SDK AWS Glue 的資料目錄資料表](glue-tables.md)稍後的 。
1. 您的應用程式可以監控管道，如果是 Voice Connector，則會使用發佈至 Amazon EventBridge 的事件來監控呼叫狀態。如需詳細資訊，請參閱本指南中的[使用 EventBridge 通知](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html)。
1. 若要終止錄音，請呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) API 以終止通話錄音。
如需 API 型錄製和範例，請參閱本指南中的 [Amazon S3 錄製目的地](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-processors-sinks.html#ca-s3-recording-sink)。
# 使用 CLI 開始錄製
本節中的範例說明如何執行下列動作：
+ 使用 CLI 執行呼叫分析組態並叫用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)。
+ 使用 CLI 指定錄製目的地音訊檔案格式和音訊檔案名稱。
**Topics**
+ [執行組態並啟動管道](#cli-run-config)
+ [設定目的地、名稱和格式](#cli-set-buckets-formats)
## 執行組態並啟動管道
使用下列命令來執行組態並啟動媒體洞察管道。pipeline.json 檔案包含組態設定。
```
aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json
```
下列範例顯示典型`pipeline.json`檔案。
```
{
"MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration,
"KinesisVideoStreamRecordingSourceRuntimeConfiguration": {
"Streams": [
{
"StreamArn": kinesis_video_stream_arn_1
},
{
"StreamArn": kinesis_video_stream_arn_2
}
],
"FragmentSelector": {
"FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type
"TimestampRange": {
"StartTimestamp": epoch_time_seconds,
"EndTimestamp": epoch_time_seconds
}
}
},
"S3RecordingSinkRuntimeConfiguration": {
"Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name,
"RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration
}
}
```
`MediaInsightsPipelineConfigurationArn` 是您在建立通話分析組態後收到的組態 ARN。
## 設定目的地、名稱和格式
下列範例使用名為 的資料夾`MyRecordingBucket`做為 `S3SinkConfiguration.Destination`值，並使用 `Opus`做為 `RecordingFileFormat`值。
```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg
```
下列範例使用 `MyRecordingBucket`做為 `S3SinkConfiguration.Destination`值，使用 `Wav`做為 `RecordingFileFormat`值。
```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav
```
# 了解 Amazon Chime SDK 機器學習型分析的工作流程
下列各節說明如何使用 Amazon Chime SDK 呼叫分析提供的機器學習分析功能。
**注意**
如果您計劃在相同的 Kinesis Video Stream 上執行多個機器學習分析，您可能需要提高`GetMediaForFragmentList`影片串流的 `GetMedia`和 連線層級限制。如需詳細資訊，請參閱《[Kinesis Video Streams 開發人員指南》中的 Kinesis Video Streams 限制](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html)。 **
# 使用語音連接器自動啟動通話分析
在下列情況下使用此工作流程：
+ 您想要主控台驅動的設定。
+ 您已使用或計劃使用 Voice Connector 將 SIP 媒體帶入通話分析。Voice Connectors 支援 SIP 和 SIPREC。如需設定語音連接器的詳細資訊，請參閱[管理 Amazon Chime SDK 語音連接器](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html)。
+ 您想要將相同的媒體洞見組態套用至每個 Voice Connector 呼叫。
+ 您需要使用 Amazon Chime SDK 語音分析，這需要語音連接器或媒體洞察管道。
若要在 Amazon Chime SDK 主控台中啟用此工作流程，請遵循[設定語音連接器以使用通話分析中建立錄製組態的步驟。](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)
若要以程式設計方式啟用此工作流程，請使用下列 APIs：[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API 建立通話分析組態，然後使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) API 將組態關聯至語音連接器。如需詳細資訊，請參閱《*Amazon Chime SDK 管理員指南*》中的[設定語音連接器以使用語音分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
下圖顯示語音連接器啟動通話分析工作階段時的資料流程。圖表中的數字對應於下方的編號文字。
![\[Image showing the flow of data when a Voice Connector initiates a call.\]](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)
在圖表中：
1. 您可以使用 Amazon Chime SDK 主控台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 來建立媒體洞見管道組態。
1. 您可以使用 Amazon Chime SDK 主控台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) API，將組態與語音連接器建立關聯。若要將現有組態與語音連接器建立關聯，請參閱《*Amazon Chime SDK 管理員指南*》中的[設定語音連接器以使用通話分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
1. 在外撥通話期間，語音連接器會收到每個通話參與者的音訊。
1. 由於內建與通話分析的整合，如果通話分析組態連接至 Voice Connector，則 Voice Connector 服務會使用媒體管道服務啟動通話分析工作階段。
1. 媒體管道服務會叫用組態中指定的一或多個媒體處理器。
1. 媒體管道服務會根據組態將輸出資料傳送至一或多個目的地。例如，您可以透過 Amazon Kinesis Data Stream 傳送即時分析，如果已設定，您可以將呼叫中繼資料和分析傳送至 Amazon S3 資料倉儲。
1. 媒體管道服務會將管道狀態事件傳送至預設的 Amazon EventBridge。如果您已設定規則，則通知也會傳送至 Amazon EventBridge。如需詳細資訊，請參閱[使用 EventBridge 通知](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html)。
**注意**
語音分析處理器只會在您呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html) APIs時自動啟動。
您必須啟用 Voice Connector 串流，才能搭配 Voice Connector 使用通話分析。此功能可讓您將通話資料串流到帳戶中的 Voice Connector 受管 Kinesis Video Streams。如需詳細資訊，請參閱[《Amazon Chime SDK 管理員指南》中的將 Amazon Chime SDK Voice Connector 媒體串流至 Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html)。 **
您可以將 Voice Connector 呼叫資料存放在 Kinesis Video Streams 中，時間從數小時到數年不等。選擇不保留資料會限制呼叫資料的可用性，以供立即使用。Kinesis Video Streams 的成本取決於使用的頻寬和總儲存體。您可以編輯 Voice Connector 的串流組態，隨時調整資料保留期。若要啟用通話分析記錄，您必須確保 Kinesis Video Stream 會保留資料，直到通話分析完成為止。您可以透過指定適當的資料保留期來執行此操作。
您可以將媒體洞見管道組態與任意數量的語音連接器建立關聯。您也可以為每個語音連接器建立不同的組態。Voice Connectors 使用 AWSServiceRoleForAmazonChimeVoiceConnector 為每個交易 ID 代表您呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API 一次。如需角色的相關資訊，請參閱《[Amazon Chime SDK 管理員指南》中的使用 Amazon Chime SDK Voice Connectors 的 Amazon Chime SDK 服務連結角色](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream)。 **
# 將通話分析 APIs與語音連接器搭配使用
如果您使用語音連接器，但需要控制何時套用通話分析組態，以及要套用組態的呼叫，請使用此工作流程。
若要使用此方法，您需要為 Voice Connector 發佈的事件建立 EventBridge 目標，然後使用事件來觸發呼叫分析管道 APIs。如需詳細資訊，請參閱《[Amazon Chime SDK 管理員指南》中的使用 EventBridge 自動化](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html) Amazon Chime 開發套件。 **
下圖說明如何在搭配 Voice Connector 使用通話分析時實作更精細的控制。圖表中的數字對應至下方文字中的數字。
![\[顯示搭配 Voice Connectors 使用 API 呼叫時資料流程的影像。\]](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/images/analytics-vc-with-apis.png)
在圖表中：
1. 您可以使用 Amazon Chime SDK 主控台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 來建立媒體洞見管道組態。
1. 在外撥通話期間，語音連接器會收到參與者音訊。
1. Voice Connector 會將呼叫音訊傳送至 Kinesis Video Stream，並將對應的事件傳送至 EventBridge。這些事件具有串流和呼叫中繼資料。
1. 您的應用程式是透過 EventBridge 目標訂閱 EventBridge。
1. 您的應用程式會叫用 Amazon Chime SDK [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
1. 媒體管道服務會根據媒體洞察管道組態中的處理器元素，叫用一或多個媒體處理器。
1. 媒體管道服務會根據組態將輸出資料傳送至一或多個目的地。Amazon Chime SDK 呼叫分析將透過 Amazon Kinesis Data Stream 提供即時分析，如果已將呼叫中繼資料分析設定為 Amazon S3 資料倉儲。
1. 媒體管道服務會將事件傳送至 Amazon EventBridge。如果您已設定規則，則通知也會傳送至 Amazon EventBridge。
1. 您可以透過叫用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html) API 來暫停或繼續通話分析工作階段。
**注意**
通話錄音不支援暫停和繼續通話。此外，當您暫停工作階段時，針對通話啟動的語音分析任務也會停止。若要重新啟動它們，您必須呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs。
1. 如果您在組態期間選取語音音分析，您可以呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs 來啟動語音分析。
# 搭配 Kinesis Video Streams 生產者使用呼叫分析
若要使用此選項，您需要將音訊資料發佈至 Kinesis Video Streams (KVS)，然後使用 KVS 串流頻道資訊呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
**注意**
呼叫分析 APIs 最多支援兩個音訊通道。
呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API 時，您可以為每個 KVS 串流頻道定義指定片段編號。如果您提供片段號碼，呼叫分析會開始處理該片段的串流。否則，呼叫分析會開始處理來自最新可用片段的串流。
通話分析支援 PCM 音訊 （僅簽署的 16 位元小端音訊格式，不包括 WAV)，音訊取樣率介於 8kHz 和 48kHz 之間。低品質音訊，例如電話音訊，通常約為 8，000 Hz。優質的音訊，通常介於 16,000 Hz 至 48,000 Hz 間。您指定的取樣率必須符合音訊的取樣率。如需詳細資訊，請參閱《*Amazon Chime SDK API 參考*[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html)》中的 。
Kinesis Video Streams Producer SDK 提供一組程式庫，可用來將音訊資料串流至 Kinesis Video Stream。如需詳細資訊，請參閱《*Amazon Kinesis Video Streams * [ Kinesis Video Streams 開發人員指南》中的 Kinesis Video Streams 生產者程式庫](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk.html)。
下圖顯示搭配自訂 Kinesis Video Stream 生產者使用通話分析時的資料流程。圖表中的數字對應至下方的編號文字。
![\[本圖顯示搭配 Kinesis Video Stream 生產者使用通話分析時的資料流程。\]](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/images/analytics-kvs-with-apis.png)
1. 您可以使用 AWS 主控台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 來建立媒體洞見管道組態。
1. 您可以使用 Kinesis Video Stream Producer 將音訊寫入 Kinesis Video Streams。
1. 您的應用程式會叫用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
1. 媒體管道服務會從客戶的 Kinesis Video Streams 讀取音訊。
1. 媒體管道服務會將事件傳送至 Amazon EventBridge。如果您已設定規則，則通知也會傳送至 Amazon EventBridge。
1. 媒體管道服務會叫用一或多個處理器元素。
1. 媒體管道服務會將輸出資料傳送至一或多個接收器元素。
1. 您可以透過叫用 [ UpdateMediaInsightsPipelineStatus](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html) API 來暫停或繼續通話分析工作階段。
**注意**
通話錄音不支援暫停和繼續。
1. 您的應用程式可以處理 Amazon EventBridge 事件，以觸發自訂業務工作流程。
1. 如果您在建立組態時選取語音分析，您的應用程式可以透過呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs 來啟動語音分析。