翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# GStreamer プラグインを使用したストリーミング
**注記**
ストリーミングビデオと一括イメージ分析は、新しいお客様では利用できなくなりました。詳細については、「[Amazon Rekognition 機能の可用性の変更](rekognition-availability-changes.md)」を参照してください。
**この変更は、他の Amazon Rekognition 機能の可用性には影響しません。**
Amazon Rekognition Video は、デバイスカメラからのライブストリーミングビデオを分析できます。デバイスソースからのメディア入力にアクセスするには、GStreamer をインストールする必要があります。GStreamer は、メディアソースと処理ツールをワークフローパイプラインで接続するサードパーティー製のマルチメディアフレームワークソフトウェアです。また、Gstreamer 用の [Amazon Kinesis Video Streams プロデューサープラグイン](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) をインストールする必要があります。このプロセスでは、Amazon Rekognition Video および Amazon Kinesis リソースが正常にセットアップされていることを前提としています。詳細については、「[Amazon Rekognition Video と Amazon Kinesis のリソースを設定する](setting-up-your-amazon-rekognition-streaming-video-resources.md)」を参照してください。
## ステップ 1: GStreamer をインストールする
サードパーティー製のマルチメディアプラットフォームソフトウェアである Gstreamer をダウンロードしてインストールします。Homebrew のようなパッケージ管理ソフト ([Gstreamer on Homebrew](https://formulae.brew.sh/formula/gstreamer)) を使うか、[Freedesktop のウェブサイト](https://gstreamer.freedesktop.org/download/) から直接入手することができます。
コマンドラインターミナルからテストソースを使用してビデオフィードを起動して、Gstreamer が正常にインストールされたことを確認します。
```
$ gst-launch-1.0 videotestsrc ! autovideosink
```
## ステップ 2: Kinesis Video Streams Producer プラグインをインストールする
このセクションでは、[Amazon Kinesis Video Streams プロデューサーライブラリ](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) をダウンロードし、Kinesis Video Streams Gstreamer プラグインをインストールします。
ディレクトリを作成し、GitHub リポジトリからソースコードをクローンします。`--recursive` パラメータを必ず入れてください。
```
$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
```
[ライブラリが提供する説明書](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/README.md) に従って、プロジェクトの設定とビルドを行います。オペレーティングシステムに対応したプラットフォーム固有のコマンドを使用してください。`-DBUILD_GSTREAMER_PLUGIN=ON` を実行して、Kinesis Video Streams Gstreamer プラグインのインストールする際に、`cmake` パラメータを使用します。このプロジェクトでは、インストールに含まれる次の追加パッケージが必要です。GCC または Clang、Curl、Openssl、および log4CPlus。パッケージが見つからないためにビルドが失敗した場合は、パッケージがインストールされていて PATH にインストールされていることを確認してください。ビルド中に [C コンパイル済みプログラムを実行できません] というエラーが発生した場合は、ビルドコマンドを再度実行してください。正しい C コンパイラが見つからないことがあります。
次のコマンドを実行して Kinesis Video Streams プラグインのインストールを確認します。
```
$ gst-inspect-1.0 kvssink
```
ファクトリやプラグインの詳細など、次の情報が表示されます。
```
Factory Details:
Rank primary + 10 (266)
Long-name KVS Sink
Klass Sink/Video/Network
Description GStreamer AWS KVS plugin
Author AWS KVS
Plugin Details:
Name kvssink
Description GStreamer AWS KVS plugin
Filename /Users/YOUR_USER/amazon-kinesis-video-streams-producer-sdk-cpp/build/libgstkvssink.so
Version 1.0
License Proprietary
Source module kvssinkpackage
Binary package GStreamer
Origin URL http://gstreamer.net/
...
```
## ステップ 3: Kinesis Video Streams プラグインで Gstreamer を実行する
デバイスカメラから Kinesis Video Streams へのストリーミングを開始する前に、メディアソースを Kinesis Video Streams で許容されるコーデックに変換する必要がある場合があります。現在マシンに接続されているデバイスの仕様とフォーマット機能を調べるには、次のコマンドを実行します。
```
$ gst-device-monitor-1.0
```
ストリーミングを開始するには、以下のサンプルコマンドで Gstreamer を起動し、認証情報と Amazon Kinesis Video Streams 情報を追加します。[Amazon Rekognition に Kinesis ストリームへのアクセスを許可する](https://docs.aws.amazon.com/rekognition/latest/dg/api-streaming-video-roles.html#api-streaming-video-roles-all-stream) 際に、作成した IAM サービスロールのアクセスキーとリージョンを使用する必要があります。アクセスキーの詳細については、*IAM ユーザーガイド* の「[IAM ユーザーのアクセスキーの管理](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)」を参照してください。また、ビデオフォーマットの引数パラメータは、使用状況に応じて、お使いのデバイスから利用できるように調整することができます。
```
$ gst-launch-1.0 autovideosrc device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 !
x264enc bframes=0 key-int-max=45 bitrate=500 ! video/x-h264,stream-format=avc,alignment=au,profile=baseline !
kvssink stream-name="YOUR_STREAM_NAME" storage-size=512 access-key="YOUR_ACCESS_KEY" secret-key="YOUR_SECRET_ACCESS_KEY" aws-region="YOUR_AWS_REGION"
```
その他の起動コマンドについては、「[GStreamer 起動コマンドの例](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-gstreamer-plugin.html#examples-gstreamer-plugin-launch)」を参照してください。
**注記**
起動コマンドがノンネゴシエーションエラーで終了する場合は、デバイスモニターの出力をチェックし、`videoconvert` パラメータの値が、デバイスの有効な機能であることを確認してください。
数秒後に Kinesis ビデオストリームにデバイスカメラからのビデオフィードが表示されます。Amazon Rekognition で顔の検出とマッチングを開始するには、Amazon Rekognition Video ストリームプロセッサを起動します。詳細については、「[Amazon Rekognition Video ストリームプロセッサオペレーションの概要](streaming-video.md#using-rekognition-video-stream-processor)」を参照してください。