ストリームを作成してデータを取り込む

アプリケーションで動画データを分析する最初のステップは、データの連続的な流れのためのパイプラインを作成することです。Streams では、リアルタイムの動画データを取り込むことができます。このデータは、モデルの入力として使用したり、Warehouse に保存したりできます。

ストリームを作成する

動画データをストリーミングするには、まずストリームを作成する必要があります。

新しいプロジェクトで初めてストリームを作成する場合、ストリームの作成に時間がかかることがあります。この時間は約 30 分です。この時間は、後続の計算のために計算クラスタを初期化する必要があるためです。

コンソール

Google Cloud コンソールでストリームを作成します。

  1. Gemini Enterprise Agent Platform Vision ダッシュボードの [Streams] タブを開きます。

    [ストリーム] タブに移動

  2. [登録] をクリックします。

  3. ストリーム名を入力し、リージョンを選択します。[行を追加] をクリックすると、複数のストリームを同時に登録できます。

  4. [登録] ボタンをクリックして、1 つ以上のストリームを作成します。

動画を取り込む

ストリームを作成したら、そのストリームを使用してデータの取り込みを開始できます。

取り込まれた動画には、いくつかの制限事項と考慮事項が適用されます。

  • 入力動画ソースは次の仕様を満たしている必要があります。

    動画がこれらの仕様を満たしていない場合、Gemini Enterprise Agent Platform Vision が入力を適切に処理できない可能性があります。

  • 取り込み中に音声がドロップされます。
  • ストリームがウェアハウスに接続されたアプリの一部である場合、動画パラメータ（FPS や解像度など）はストリーム全体で同じである必要があります。RTSP 動画データ パラメータやローカル動画データ パラメータのバリエーションは対象外です。
  • モデルの起動レイテンシにより、取り込まれた動画の最初の数秒間のコンテンツが欠落している場合があります。この時間は最大 15 秒に達することがあります。
  • 取り込みの終了は、接続が長時間（平均約 5 時間）続いた後に発生することがあります。vaictl ツールには再接続機能がないため、ユーザーが手動で再接続する必要があります。
  • vaictl は動画データの取り込みに役立つツールですが、ネットワーク エラーからの復旧を自動的に処理するわけではありません。これらのエラーは、データソース側または Cloud 取り込み側のいずれかで発生する可能性があります。予期しない vaictl オペレーションの終了を処理する再起動スクリプトを作成するのは、ユーザーの責任です。

Gemini Enterprise Agent Platform Vision SDK

既存のストリームを使用して動画データを取り込むリクエストを送信するには、Gemini Enterprise Agent Platform Vision SDK をインストールする必要があります。

次の変数を置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • LOCATION_ID: 地域 ID。例: us-central1詳細サポートされているリージョン。
  • LOCAL_FILE.EXT: ローカル動画ファイルのファイル名。例: my-video.mp4
  • STREAM_ID: クラスタで作成したストリーム ID（例: input-1）。
  • RTSP_ADDRESS: リアルタイム ストリーミング プロトコル（RTSP）フィードのアドレス。例: rtsp://my-ip-camera

ローカル動画データ:

# This command streams a video file to a stream. Streaming ends when the video ends.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send video-file to streams STREAM_ID --file-path LOCAL_FILE.EXT

ローカル動画データ（ループ）:

# This command streams a video file to a stream. Video is looped into the stream until you stop the command.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send video-file to streams STREAM_ID --file-path LOCAL_FILE.EXT --loop

リアルタイム ストリーミング プロトコル（RTSP）フィードデータ:

# This command will send an RTSP feed into the stream.
# This command has to run in the network that has direct access to the RTSP feed.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send rtsp to streams STREAM_ID --rtsp-uri RTSP_ADDRESS

取り込んだ動画を再生する

ストリームを作成して動画コンテンツをストリームに送信したら、動画コンテンツを再生できます。

ストリーム ビューのタブを 1 時間以上開いたままにすると、動画コンテンツの読み込みを続行するにはページを更新する必要があります。

コンソール

取り込んだ動画を Google Cloud コンソールで再生する。

  1. Gemini Enterprise Agent Platform Vision ダッシュボードの [Streams] タブを開きます。

    [ストリーム] タブに移動

  2. ストリームのリストからストリーム名をクリックします。

  3. 動画ストリームの詳細ページで、取り込まれた動画のライブビューが自動的に読み込まれます。