本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 了解 Amazon Chime SDK 的通話分析狀態
<a name="call-analytics-statuses"></a>

當您執行下列其中一項或兩項操作時，媒體洞察管道會追蹤一組狀態：
+ 使用多個機器學習處理元素，例如 Amazon Transcribe 和語音分析。
+ 啟用或停用機器學習處理來啟用通話錄音。

若要取得管道和元素狀態，請使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html) API 和 [EventBridge 通知](using-eventbridge-notifications.md)。

若要取得語音分析任務的狀態，請使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetSpeakerSearchTask.html)和 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetVoiceToneAnalysisTask.html) APIs，以及[語音分析通知目標](va-notification-targets.md)。

媒體洞察管道會追蹤下列狀態。
+ **管道狀態** – 呼叫分析管道的整體狀態，也稱為媒體洞見管道。這取決於元素狀態。
+ **元素狀態** – 個別媒體洞見管道組態元素的處理狀態。
+ **任務狀態** – 針對語音分析啟動的媒體洞見管道任務的處理狀態。`VoiceAnalyticsProcessor` 元素狀態取決於任務狀態。呼叫分析管道中沒有其他元素具有任務狀態。

  如需媒體洞察管道任務的詳細資訊，請參閱本指南[了解 Amazon Chime SDK 的通話分析術語](ca-terms-concepts.md)稍早的 。

並非所有媒體洞察組態元素類型都有元素狀態。一般而言，只有「處理器」類型的媒體洞察組態元素具有元素狀態。此外，Amazon S3 錄音和語音增強接收器具有處理器狀態。具體而言，下列媒體洞察組態元素類型存在元素狀態：
+ `AmazonTranscribeProcessor`
+ `AmazonTranscribeCallAnalyticsProcessor`
+ `S3RecordingSink`
+ `VoiceAnalyticsProcessor`
+ `VoiceEnhancementSink`

管道狀態由元素狀態決定，如下所示：


| 管道狀態 | 條件 | 
| --- | --- | 
| NotStarted | 所有元素狀態都不會啟動。 | 
| 初始化 | 至少一個元素正在初始化，其他元素未啟動。 | 
| InProgress | 至少一個元素正在進行中。 | 
| 失敗 | 至少一個元素已失敗，其餘元素已停止。 | 
| 正在停止 | 如需停止條件的完整清單[管理 Amazon Chime SDK 的通話分析管道](managing-call-analytics-pipelines.md)，請參閱 。 | 
| 已停止 | 所有元素都會停止。 | 
| Paused | 所有元素都會暫停。 | 

與其他元素狀態不同，`VoiceAnalyticsProcessor`元素有一些細微差別。如前所述，對應至 Amazon Chime SDK 語音分析功能的`VoiceAnalyticsProcessor`元素狀態，取決於從 [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)。
+ `VoiceAnalyticsProcessor`的元素狀態會以 `NotStarted` 狀態開始，因為`StartVoiceToneAnalysisTask`必須先呼叫 `StartSpeakerSearchTask`和 ，才能將狀態變更為 `Initializing`，然後呼叫 `InProgress`。
+ `InProgress` 只要啟動一個任務，而且任務執行時不符合[停止條件](managing-call-analytics-pipelines.md)， 就會`VoiceAnalyticsProcessor`保留。
+ 即使 `VoiceAnalyticsProcessor`可能是 `InProgress`，您仍需支付任務處理期間的費用。
+ 若要清除至少有一個語音分析任務已啟動且不再執行任務的媒體洞見管道，您必須呼叫 `DeleteMediaPipeline`。
+ 只要任務成功執行或完成，`VoiceAnalyticsProcessor`元素狀態就會維持在 `InProgress`。