Kinesis Video Streams のチュートリアルをやってみた
Getting started with Amazon Kinesis Video Streams - Amazon Kinesis Video Streams
上記チュートリアルをやってみました。
前提
- IAM ユーザー作成済み
- アクセスキー発行済み
- 使用リージョンは us-west-2
01. ビデオストリームの作成
Create an Amazon Kinesis video stream - Amazon Kinesis Video Streams
Kinesis Video Streams のコンソールからデフォルト設定で作成しました。
02. ビデオストリームにデータを送信する
Send data to an Amazon Kinesis video stream - Amazon Kinesis Video Streams
チュートリアルではローカル端末を使用する方法と Cloud9 を使用する方法が紹介されています。
今回は Cloud9 を使用しました。
Cloud9 環境は Ubuntu Server 22.04 LTS で作成します。
その他の設定はデフォルト設定です。
環境作成後、IDE にログインして後の手順のために Preferences > AWS Settings > Credentials の AWS managed temporary credentials をオフにしました。
ここからはドキュメントのコマンドを順番に実行します。
まずはボリュームの拡張コマンドです。
$ wget https://awsj-iot-handson.s3-ap-northeast-1.amazonaws.com/kvs-workshop/resize_volume.sh
$ chmod +x resize_volume.sh
$ ./resize_volume.sh
続いて必要なライブラリなどをインストールするコマンドです。
$ sudo apt-get update
$ sudo apt-get install -y cmake m4 git build-essential pkg-config libssl-dev libcurl4-openssl-dev \
liblog4cplus-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
gstreamer1.0-plugins-base-apps gstreamer1.0-plugins-bad gstreamer1.0-plugins-good \
gstreamer1.0-plugins-ugly gstreamer1.0-tools
$ git clone https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
$ cd amazon-kinesis-video-streams-producer-sdk-cpp
$ mkdir build
$ cd build
$ cmake .. -DBUILD_GSTREAMER_PLUGIN=TRUE -DBUILD_DEPENDENCIES=OFF
$ make
$ ls
CMakeCache.txt Makefile dependency kvs_gstreamer_file_uploader_sample kvs_gstreamer_sample libKinesisVideoProducer.so
CMakeFiles cmake_install.cmake kvs_gstreamer_audio_video_sample kvs_gstreamer_multistream_sample kvssink_gstreamer_sample libgstkvssink.so
ls コマンドの実行結果に以下のファイルが表示されることを確認します。
- kvs_gstreamer_sample
- libgstkvssink.so
続いて、IAM ユーザーの認証情報を環境変数にエクスポートします。
チュートリアルのサンプルアプリケーションはインスタンスメタデータ (IMDS) の認証情報をサポートしていないため、認証情報を手動で設定します。
$ export AWS_ACCESS_KEY_ID=YourAccessKey
$ export AWS_SECRET_ACCESS_KEY=YourSecretKey
$ export AWS_DEFAULT_REGION=us-west-2
続いてサンプルの mp4 ファイルをダウンロードしてアプリケーションを実行します。
YourStreamName には手順 01 で作成したビデオストリームの名前を入力します。
$ wget https://awsj-iot-handson.s3-ap-northeast-1.amazonaws.com/kvs-workshop/sample.mp4
./kvs_gstreamer_sample YourStreamName ./sample.mp4
アプリケーション実行後、以下のようなログが出力されれば送信完了です。
{"EventType":"PERSISTED","FragmentTimecode":1711124585823,"FragmentNumber":"12345678901234567890123456789012345678901234567"}
03. メディアデータの確認
Consume media data - Amazon Kinesis Video Streams
Kinesis Video Streams のコンソールで作成済みのビデオストリームを選択し、メディア再生をクリックすると送信した mp4 ファイルを再生できます。
まとめ
今回は Kinesis Video Streams のチュートリアルをやってみました。
どなたかの参考になれば幸いです。
Discussion