翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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) API と [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) API に加え、[音声分析通知のターゲット](va-notification-targets.md)を使用します。

メディアインサイトパイプラインでは、次のステータスが追跡されます。
+ **パイプラインステータス** — 通話分析パイプライン (メディアインサイトパイプラインとも呼ばれる) の全体的なステータス。これは、その要素のステータスによって決まります。
+ **要素ステータス** — 各メディアインサイトパイプライン設定要素の処理ステータス。
+ **タスクステータス** — 音声分析用に開始したメディアインサイトパイプラインタスクの処理ステータス。`VoiceAnalyticsProcessor` 要素のステータスは、タスクステータスによって決まります。通話分析パイプラインの他の要素には、タスクステータスはありません。

  メディアインサイトパイプラインタスクの詳細については、このガイドで前述した「[Amazon Chime SDK の通話分析の用語について](ca-terms-concepts.md)」を参照してください。

必ずしもすべてのメディアインサイト設定要素タイプに要素ステータスがあるわけではありません。一般的に、「プロセッサ」タイプのメディアインサイト設定要素にのみ要素ステータスがあります。また、Amazon S3 録音シンクと音声エンハンスメントシンクにはプロセッサステータスがあります。具体的には、次のメディアインサイト設定要素タイプに要素ステータスがあります。
+ `AmazonTranscribeProcessor`
+ `AmazonTranscribeCallAnalyticsProcessor`
+ `S3RecordingSink`
+ `VoiceAnalyticsProcessor`
+ `VoiceEnhancementSink`

パイプラインのステータスは、次に示すように、要素ステータスによって決まります。


| パイプラインのステータス | Condition | 
| --- | --- | 
| NotStarted | すべての要素ステータスが開始になっていません。 | 
| Initializing | 少なくとも 1 つの要素が初期化中で、それ以外は開始されていません。 | 
| InProgress | 少なくとも 1 つの要素が稼働中です。 | 
| 失敗 | 少なくとも 1 つの要素に障害が発生し、それ以外の要素は停止しています。 | 
| 停止中 | 停止条件をすべて確認するには、[Amazon Chime SDK の通話分析パイプラインの管理](managing-call-analytics-pipelines.md) を参照してください。 | 
| 停止 | すべての要素が停止しています。 | 
| 一時停止中 | すべての要素が一時停止しています。 | 

他の要素のステータスとは異なり、`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` の状態で始まります。これは、`StartSpeakerSearchTask` と `StartVoiceToneAnalysisTask` を呼び出さないと、要素のステータスが `Initializing` から `InProgress` に変わらないからです。
+ `VoiceAnalyticsProcessor` では、1 つのタスクを開始し、タスクの実行中に[停止条件](managing-call-analytics-pipelines.md)を満たさない限り、`InProgress` が維持されます。
+ `VoiceAnalyticsProcessor` が `InProgress` の場合にも、タスクの処理時間に対してのみ課金が発生します。
+ 少なくとも 1 つの音声分析タスクを開始し、それ以外のタスクを実行していないメディアインサイトパイプラインをクリーンアップするには、`DeleteMediaPipeline` を呼び出す必要があります。
+ タスクが実行中、または正常に完了している限り、`VoiceAnalyticsProcessor` 要素のステータスは `InProgress` が維持されます。