タスク結果のポーリング

重要

デフォルトでは、音声分析の結果は 7 日間有効で、その後データは自動的に削除されます。タスクデータを長期間使用したい場合や、データ保持法を遵守したい場合は、それらのデータを保存する必要があります。詳細については、このガイドで後述する「データ保持」を参照してください。

音声分析では通常、各タスク結果が少なくとも 1 回は配信されます。ただし、ネットワークに問題がある場合、レイテンシーが増加する可能性があります。潜在的な問題を回避したい場合や、同期処理を行いたい場合は、メディアパイプライン SDK または音声 SDK で次の API を使用できます。

• GetSpeakerSearchTask

• GetVoiceToneAnalysisTask

  重要

  GetVoiceToneAnalysisTask API はタスクのステータスのみを返します。タスクの結果は返しません。結果を表示するには、Amazon SQS 、Amazon SNS 、または AWS Lambda 通知ターゲットを使用します。

GetSpeakerSearchTask API は、タスク ID、遅延メッセージ、または順不同で届いたメッセージについて、最新の結果を同期的に取得します。ただし、通知ターゲットと非同期処理を使用することをお勧めします。そうすることで、コンピューティングリソースの消費量を抑えることができます。