ビデオ内のラベルの検出 - Amazon Rekognition

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

ビデオ内のラベルの検出

Amazon Rekognition Video では、ビデオ内のラベルを検出し、ラベルが検出された時刻を確認することができます。SDK のコード例については、「Java または Python を使用した、Amazon S3 バケットに保存されているビデオの分析 (SDK)」を参照してください。AWS CLI の例については、「を使用したビデオの分析AWS Command Line Interface」を参照してください。

Amazon Rekognition Video ラベル検出は、非同期オペレーションです。ビデオ内のラベルの検出を開始するには、StartLabelDetection。Amazon Rekognition Video は、Amazon Simple Notification Service トピックにビデオ分析の完了ステータスを発行します。ビデオ分析が成功したら、GetLabelDetection を呼び出して検出したラベルを取得します。ビデオ分析の API オペレーションの詳細については、「Amazon Rekognition Video オペレーションを呼び出す」を参照してください。

GetLabelDetection オペレーションレスポンス

GetLabelDetection は、ビデオ内で検出されたラベルに関する情報が含まれた配列 (Labels) を返します。この配列は、SortBy パラメータを指定することによって、時刻別または検出されたラベル別に並べ替えることができます。

次は、GetLabelDetection の JSON レスポンス例です。レスポンスで、以下の点に注意してください。

  • 並べ替え順序— 返されるラベルの配列は時刻別にソートされます。ラベル別に並べ替えるには、GetLabelDetectionSortBy 入力パラメータに NAME を指定します。ビデオ内でラベルが複数回表示されている場合、(LabelDetection) 要素のインスタンスは複数になります。

  • ラベル情報LabelDetection配列要素には、(Label) は、ラベル名と Amazon Rekognition で検出されたラベルの精度の信頼度を含むオブジェクトです。Label オブジェクトには、ラベルの階層分類と、一般的なラベルの境界ボックス情報も含まれます。Timestamp は、ラベルが検出されたビデオの開始時刻からのミリ秒単位の時間です。

  • ページング情報— 例は 1 ページのラベル検出情報を示しています。GetLabelDetectionMaxResults 入力パラメータには、返す LabelDetection オブジェクトの数を指定できます。結果が MaxResults を超える場合、GetLabelDetection は次のページの結果を取得するためのトークン (NextToken) を返します。詳細については、「Amazon Rekognition Video 分析結果の取得」を参照してください。

  • ビデオの情報 – レスポンスには、VideoMetadata から返される情報のページごとにビデオ形式に関する情報 (GetLabelDetection) が含まれます。

{ "Labels": [ { "Timestamp": 0, "Label": { "Instances": [], "Confidence": 60.51791763305664, "Parents": [], "Name": "Electronics" } }, { "Timestamp": 0, "Label": { "Instances": [], "Confidence": 99.53411102294922, "Parents": [], "Name": "Human" } }, { "Timestamp": 0, "Label": { "Instances": [ { "BoundingBox": { "Width": 0.11109819263219833, "Top": 0.08098889887332916, "Left": 0.8881205320358276, "Height": 0.9073750972747803 }, "Confidence": 99.5831298828125 }, { "BoundingBox": { "Width": 0.1268676072359085, "Top": 0.14018426835536957, "Left": 0.0003282368124928324, "Height": 0.7993982434272766 }, "Confidence": 99.46029663085938 } ], "Confidence": 99.53411102294922, "Parents": [], "Name": "Person" } }, . . . { "Timestamp": 166, "Label": { "Instances": [], "Confidence": 73.6471176147461, "Parents": [ { "Name": "Clothing" } ], "Name": "Sleeve" } } ], "LabelModelVersion": "2.0", "JobStatus": "SUCCEEDED", "VideoMetadata": { "Format": "QuickTime / MOV", "FrameRate": 23.976024627685547, "Codec": "h264", "DurationMillis": 5005, "FrameHeight": 674, "FrameWidth": 1280 } }