ストリーミングビデオイベントの操作

Amazon Rekognition Video を使用して、ストリーミングビデオ内の顔を検出/認識したり、オブジェクトを検出したりできます。Amazon Rekognition Video は、Amazon Kinesis Video Streams を使用して、ビデオストリームを受信し処理します。ストリームプロセッサがビデオストリームから何を検出するかを示すパラメータを指定して、ストリームプロセッサを作成します。Rekognition は、ストリーミングビデオイベントからのラベル検出結果を Amazon SNSおよび Amazon S3 通知として送信します。Rekognition は、顔の検索結果を Kinesis データストリームに出力します。

顔検索ストリームプロセッサは、FaceSearchSettings を使用してコレクションから顔を検索します。顔検索ストリームプロセッサを実装してストリーミングビデオ内の顔を分析する方法については、「ストリーミングビデオのコレクション内での顔検索」を参照してください。

ラベル検出ストリームプロセッサは、ConnectedHomeSettings を使用してストリーミングビデオイベント内の人、パッケージ、ペットを検索します。ラベル検出ストリームプロセッサを実装する方法については、「ストリーミングビデオイベント内のラベルの検出」を参照してください。

Amazon Rekognition Video ストリームプロセッサオペレーションの概要

ストリーミングビデオの分析を開始するには、Amazon Rekognition Video ストリームプロセッサを起動し、Amazon Rekognition Video にビデオをストリーミングします。Amazon Rekognition Video ストリームプロセッサでは、ストリームプロセッサを起動、停止、管理できます。ストリームプロセッサを作成するには、 を呼び出しますCreateStreamProcessor。顔検索ストリームプロセッサを作成するためのリクエストパラメータには、Kinesis ビデオストリームの Amazon リソースネーム (ARNs）、Kinesis データストリーム、ストリーミングビデオ内の顔を認識するために使用されるコレクションの識別子が含まれます。セキュリティモニタリングストリームプロセッサを作成するためのリクエストパラメータには、Kinesis ビデオストリームと Amazon SNSトピックの Amazon リソースネーム (ARNs）、ビデオストリームで検出するオブジェクトのタイプ、出力結果の Amazon S3 バケットの情報が含まれます。また、ストリームプロセッサに指定した名前も含めます。

ビデオの処理を開始するには、 StartStreamProcessorオペレーションを呼び出します。ストリームプロセッサのステータス情報を取得するには、 を呼び出しますDescribeStreamProcessor。呼び出すことができるその他のオペレーションはTagResource、ストリームプロセッサDeleteStreamProcessorにタグを付け、ストリームプロセッサを削除することです。顔検索ストリームプロセッサを使用している場合は、 StopStreamProcessorを使用してストリームプロセッサを停止することもできます。アカウント内のストリームプロセッサのリストを取得するには、 を呼び出しますListStreamProcessors。

ストリームプロセッサが起動し始めたら、CreateStreamProcessor で指定した Kinesis ビデオストリームを通じて Amazon Rekognition Video にビデオをストリーミングします。Kinesis Video Streams SDKPutMediaオペレーションを使用して、Kinesis ビデオストリームにビデオを配信できます。例については、PutMediaAPI「例」を参照してください。

アプリケーションが顔検索ストリームプロセッサから Amazon Rekognition Video の分析結果を使用する方法については、「ストリーミングビデオの分析結果の読み取り」を参照してください。