Skip to content

Latest commit

 

History

History
78 lines (55 loc) · 3.68 KB

README.md

File metadata and controls

78 lines (55 loc) · 3.68 KB

動画から切り出した画像をサーバに送信する

動画ファイルから切り出した画像をサーバに送信する環境を構築する手順を示します。

flowchart LR
  subgraph S[image-sender]
    SS(SINETStream)
  end
  subgraph SRV[Server]
    B[Kafka Broker]
  end
  subgraph VV["VideoViewer.py"]
    RD(SINETStream)
  end
  F["video file"]
  F==>S
  SS==>|publish|B-.->RD
Loading

1. 準備

1.1. 前提条件

image-sender を実行するための前提条件を以下に示します。

  • Python
    • 3.8 以降

また画像ストリームの送信先となる Kafka ブローカが利用可能な状態になっている必要があります。以下に示すいずれかの構成でKafkaブローカを事前に構築してください。

1.2. ライブラリのインストール

image-senderが利用する Python ライブラリをインストールします。

pip install -U --user sinetstream-kafka sinetstream-type-image

既にインストールしているライブラリとconflictしてしまいエラーとなる場合は venv や pipenv などの仮想環境の利用を検討してください。また環境によっては pip コマンドは pip3 となっていることがあります。必要に応じて読み替えて下さい。

1.3. 設定ファイル

image-senderではSINETStreamライブラリを利用して Kafka ブローカへと画像を送信します。SINETStreamではアクセスするブローカのアドレス、トピック名などのパラメータを設定ファイル.sinetstream_config.ymlに記述しておく必要があります。設定ファイルの記述例を以下に示します。

video:
  topic: sinetstream.image.video
  brokers: kafka.example.org:9092
  type: kafka
  consistency: AT_LEAST_ONCE

brokers と topic の値を実行環境に合せて修正してください。他のパラメータの指定方法など .sinetstream_config.yml の記述方法の詳細については SINETStream - 設定ファイル を参照してください。

2. 実行

image-senderのコマンドライン引数の指定方法を以下に示します。

usage: image-sender -i INPUT_VIDEO [-s SERVICE] [-r FRAME_RATE] [-R SAMPLE_RATE]
  -i/--input-video    動画ファイル名
  -s/--service        サービス名
  -r/--frame-rate     フレームレート
  -R/--sampling-rate  サンプリングレート

-iに指定する入力ビデオファイル名は必須項目となります。

-sに指定するサービス名のデフォルト値は videoとなります。これは SINETStream設定ファイルの記述例 example_sinetstream_config.yml にあるサービス名に合せてあります。

-rで指定するフレームレートは Kafka ブローカに画像を送信するレートになります。デフォルトでは入力の動画ファイルのフレームレートと同じ値となります。

-Rで指定するサンプリングレートは、入力動画ファイルから画像を切り出す際にどの程度間引くかの指定となります。デフォルトでは動画に含まれるすべてのフレームを画像として切り出しKafkaブローカに送信します。