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

# Amazon Rekognition Video と Amazon Kinesis のリソースを設定する
<a name="setting-up-your-amazon-rekognition-streaming-video-resources"></a>

 次の手順では、ストリーミングビデオの顔認識に使用する Kinesis ビデオストリームとその他のリソースをプロビジョニングするための手順を説明します。

## 前提条件
<a name="streaming-video-prerequisites"></a>

この手順を実行するには、 AWS SDK for Java がインストールされている必要があります。詳細については、「[Amazon Rekognition の開始方法](getting-started.md)」を参照してください。 AWS アカウント 使用する には、Amazon Rekognition API へのアクセス許可が必要です。詳細については、*IAM ユーザーガイド*の「[Amazon Rekognition で定義されるアクション](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonrekognition.html#amazonrekognition-actions-as-permissions)」を参照してください。

**ビデオストリーム内の顔を認識するには (AWS SDK)**

1. まだの場合、Amazon Rekognition Video に Kinesis Video Streams と Kinesis Data Streams へのアクセスを許可するために IAM サービスロールを作成します。その ARN をメモします。詳細については、「[AmazonRekognitionServiceRole を使用してストリームへのアクセス権を付与する](api-streaming-video-roles.md#api-streaming-video-roles-all-stream)」を参照してください。

1. [コレクションを作成し](create-collection-procedure.md)、使用したコレクション識別子をメモします。

1. 手順 2 で作成したコレクションで、検索する[顔にインデックスを付けます](add-faces-to-collection-procedure.md)。

1. [Kinesis ビデオストリームの作成](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-createstream.html) と、ストリームの Amazon リソースネーム (ARN) を記録します。

1. [Kinesis データストリームを作成する](https://docs.aws.amazon.com/streams/latest/dev/learning-kinesis-module-one-create-stream.html)。ストリーム名の先頭に *AmazonRekognition* を追加し、ストリームの ARN をメモします。

これで、[顔検索ストリームプロセッサを作成](rekognition-video-stream-processor-search-faces.md#streaming-video-creating-stream-processor)し、選択したストリームプロセッサ名を使用して[ストリームプロセッサを起動](rekognition-video-stream-processor-search-faces.md#streaming-video-starting-stream-processor)できます。

**注記**  
 ストリームプロセッサは、Kinesis ビデオストリームにメディアを取り込めることを確認した後に起動する必要があります。

## Amazon Rekognition Video へのストリーミングビデオ
<a name="video-streaming-kinesisvideostreams-stream"></a>

Amazon Rekognition Video にビデオをストリーミングするには、Amazon Kinesis Video Streams SDK を使用して、Kinesis ビデオストリームを作成し使用します。`PutMedia` オペレーションは、Amazon Rekognition Video が消費するビデオデータ *フラグメント* を Kinesis ビデオストリームに書き込みます。通常、各ビデオデータフラグメントは 2 ～ 10 秒間の長さで、自己完結型のビデオフレームのシーケンスを含みます。Amazon Rekognition Video は、3 つのタイプのフレーム (I、B、および P) を持つ H.264 エンコードされたビデオをサポートしています。詳細については、「[フレーム間](https://en.wikipedia.org/wiki/Inter_frame)」を参照してください。フラグメントの最初のフレームは、I-frame でなければなりません。I-frame は、他のフレームから独立してデコードできます。

Kinesis ビデオストリームにビデオデータが到着すると、Kinesis Video Streams はフラグメントに一意の数値を割り当てます。例については、「[PutMedia API の例](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html)」を参照してください。
+  Matroska (MKV) でエンコードされたソースからストリーミングする場合は、[PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) オペレーションを使用して、作成した Kinesis ビデオストリームにソースビデオをストリーミングしてください。詳細については、「[PutMedia API の例](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html)」を参照してください。
+  デバイスカメラからストリーミングする場合は、[GStreamer プラグインを使用したストリーミング](streaming-using-gstreamer-plugin.md) を参照してください。

# Amazon Rekognition Video にリソースへのアクセス権を付与する
<a name="api-streaming-video-roles"></a>

 AWS Identity and Access Management (IAM) サービスロールを使用して、Amazon Rekognition Video に Kinesis ビデオストリームへの読み取りアクセスを許可します。顔検索のストリームプロセッサを使用している場合は、IAM サービスロールを使用して、Amazon Rekognition Video に Kinesis データストリームへの書き込みアクセス権を付与します。セキュリティモニタリングのストリームプロセッサを使用している場合は、IAM ロールを使用して、Amazon Rekognition Video に Amazon S3 バケットと Amazon SNS トピックへのアクセス権を付与します。

## 顔検索ストリームプロセッサのアクセス権の付与
<a name="api-streaming-video-roles-single-stream"></a>

個々の Kinesis Video Streams と Kinesis Data Streams に Amazon Rekognition Video へのアクセスを許可する権限ポリシーを作成することができます。

**Amazon Rekognition Video に顔検索ストリームプロセッサへのアクセス権を付与するには**

1. [[IAM JSON ポリシーエディターを使用して新しい許可ポリシーを作成し](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)]、次のポリシーを使用します。`video-arn` を、希望する Kinesis ビデオストリームの ARN に置き換えます。顔検索ストリームプロセッサを使用している場合は、`data-arn` を、希望する Kinesis データストリームの ARN に置き換えます。

1. [IAM サービスロールを作成する](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html?icmpid=docs_iam_console) または、既存の IAM サービスロールを更新します。次の情報を使用して、IAM サービスロールを作成します。

   1. サービス名の **Rekognition** を選択します。

   1. サービスロールのユースケースの **Rekognition** を選択します。

   1. 手順 1 で作成したアクセス権ポリシーを添付します。

1. サービスロールの ARN をメモしておきます。これは、ビデオ分析のオペレーションを開始する際に必要です。

## AmazonRekognitionServiceRole を使用してストリームへのアクセス権を付与する
<a name="api-streaming-video-roles-all-stream"></a>

 Kinesis ビデオストリームとデータストリームへのアクセスを設定する別の方法として、`AmazonRekognitionServiceRole` アクセス権限ポリシーを使用できます。IAM には、*Rekognition* サービスロールのユースケースが用意されています。このサービスロールを `AmazonRekognitionServiceRole` アクセス権限ポリシーと共に使用すると、複数の Kinesis Date Streams への書き込みやすべての Kinesis Video Streams の読み取りを行うことができます。Amazon Rekognition Video に複数の Kinesis Data Streams への書き込みアクセスを許可するには、Kinesis Data Streams の名前の前に *AmazonRekognition* を付けます (例えば、`AmazonRekognitionMyDataStreamName`)。

**Amazon Rekognition Video に Kinesis ビデオストリームと Kinesis データストリームへのアクセスを与えるには**

1. [IAM サービスロールを作成します](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html?icmpid=docs_iam_console)。次の情報を使用して、IAM サービスロールを作成します。

   1. サービス名の **Rekognition** を選択します。

   1. サービスロールのユースケースの **Rekognition** を選択します。

   1. **AmazonRekognitionServiceRole** アクセス権限ポリシーを選択します。これは、*AmazonRekognition* が先頭に追加されている Kinesis Data Streams への書き込みアクセスと、すべての Kinesis Video Streams への読み取りアクセスを Amazon Rekognition Video に付与するポリシーです。

1.  AWS アカウント のセキュリティを確保するには、使用しているリソースのみに Rekognition のアクセス範囲を制限します。これは、IAM サービスロールに信頼ポリシーをアタッチすることで実行できます。これを行う方法については、「[サービス間の混乱した代理の防止](cross-service-confused-deputy-prevention.md)」を参照してください。

1. このサービスロールの Amazon リソースネーム (ARN) をメモします。これは、ビデオ分析のオペレーションを開始する際に必要です。