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

# ストリーミングビデオイベントの操作
<a name="streaming-video"></a>

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

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

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

## Amazon Rekognition Video ストリームプロセッサオペレーションの概要
<a name="using-rekognition-video-stream-processor"></a>

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

[StartStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartStreamProcessor.html) オペレーションを呼び出して、ビデオの処理を開始します。ストリームプロセッサのステータス情報を取得するには、[DescribeStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeStreamProcessor.html) を呼び出します。呼び出せるその他のオペレーションには、ストリームプロセッサをタグ付けする [TagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TagResource.html)、およびストリームプロセッサを削除する [DeleteStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteStreamProcessor.html) があります。顔検索ストリームプロセッサを使用している場合は、[StopStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StopStreamProcessor.html) を使用してストリームプロセッサを停止することもできます。アカウントのストリームプロセッサのリストを取得するには、[ListStreamProcessors](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListStreamProcessors.html) を呼び出します。

ストリームプロセッサが起動し始めたら、`CreateStreamProcessor` で指定した Kinesis ビデオストリームを通じて Amazon Rekognition Video にビデオをストリーミングします。Kinesis Video Streams SDK の [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)」を参照してください。

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

# 新しいストリームプロセッサにタグを追加する
<a name="streaming-video-tagging-stream-processor"></a>

タグを使用して、Amazon Rekognition ストリームプロセッサを識別、整理、検索、フィルタリングできます。各タグは、ユーザー定義のキーと値で構成されるラベルです。

`CreateStreamProcessor` オペレーション を使用して、ストリームプロセッサの作成時にタグを追加できます。`Tags` 配列入力パラメーターで、1 つ以上のタグを指定します。タグを用いて、`CreateStreamProcessor` リクエストに関する JSON の例を次に示します。

```
{
       "Name": "streamProcessorForCam",
       "Input": {
              "KinesisVideoStream": {
                     "Arn": "arn:aws:kinesisvideo:us-east-1:nnnnnnnnnnnn:stream/inputVideo"
              }
       },
       "Output": {
              "KinesisDataStream": {
                     "Arn": "arn:aws:kinesis:us-east-1:nnnnnnnnnnnn:stream/outputData"
              }
       },
       "RoleArn": "arn:aws:iam::nnnnnnnnnnn:role/roleWithKinesisPermission",
       "Settings": {
              "FaceSearch": {
                     "CollectionId": "collection-with-100-faces",
                     "FaceMatchThreshold": 85.5
              },
              "Tags": { 
      "Dept": "Engineering",
        "Name": "Ana Silva Carolina",
        "Role": "Developer"
       }
}
```

# 既存のストリームプロセッサにタグを追加する
<a name="add-tag-existing-stream-processor"></a>

タグを使用して、Amazon Rekognition ストリームプロセッサを識別、整理、検索、フィルタリングできます。各タグは、ユーザー定義のキーと値で構成されるラベルです。

既存のストリームプロセッサに 1 つ以上のタグを追加するには、`TagResource` オペレーションを使用します。ストリームプロセッサの Amazon リソースネーム (ARN) (`ResourceArn`) と、追加したいタグ (`Tags`) を指定します。次の例は、2 つのタグを追加する方法を示しています。

```
aws rekognition tag-resource --resource-arn resource-arn \
                --tags '{"key1":"value1","key2":"value2"}'
```

**注記**  
ストリームプロセッサの Amazon リソース名がわからない場合は、`DescribeStreamProcessor` オペレーションを使用することができます。

# ストリームプロセッサ内のタグを一覧表示する
<a name="list-tags-stream-processor"></a>

タグを使用して、Amazon Rekognition ストリームプロセッサを識別、整理、検索、フィルタリングできます。各タグは、ユーザー定義のキーと値で構成されるラベルです。

ストリームプロセッサに付属するタグを一覧表示するには、`ListTagsForResource` オペレーションを実行し、ストリームプロセッサの ARN (`ResourceArn`) を指定します。応答は、指定されたストリームプロセッサに添付されるタグのキーと値のマップです。

```
aws rekognition list-tags-for-resource --resource-arn resource-arn
```

出力には、ストリームプロセッサに添付されたタグのリストが表示されます:

```
{
    "Tags": {
        "Dept": "Engineering",
        "Name": "Ana Silva Carolina",
        "Role": "Developer"
    }
}
```

# ストリームプロセッサからタグを削除する
<a name="delete-tag-stream-processor"></a>

タグを使用して、Amazon Rekognition ストリームプロセッサを識別、整理、検索、フィルタリングできます。各タグは、ユーザー定義のキーと値で構成されるラベルです。

ストリームプロセッサから 1 つ以上のタグを削除するには、`UntagResource` オペレーションを使用する。モデル (`ResourceArn`) の ARN と 削除したいタグキー (`Tag-Keys`) を指定します。

```
aws rekognition untag-resource --resource-arn resource-arn \
                --tag-keys '["key1","key2"]'
```

または、次の形式でタグキーを指定できます。

```
--tag-keys key1,key2
```