一般的なワークフロー

標準のテスト動画をインポートします。

例、スモークテスト、またはマルチストリーム検証のために、繰り返し使用できるメディアが必要な場合は、標準のビデオセットを使用してください。

https://artifacts.sima-neat.com/assets/videos/720p16/video01.mp4
...
https://artifacts.sima-neat.com/assets/videos/720p16/video16.mp4

https://artifacts.sima-neat.com/assets/videos/480p30/video01.mp4
...
https://artifacts.sima-neat.com/assets/videos/480p30/video16.mp4

手動で利用する場合は、必要なファイルをダウンロードし、メディアソースからアップロードしてください。

APIを利用した設定の場合は、Insight にメディアファイルがすでに存在するかどうかを確認してください。

curl -k https://127.0.0.1:9900/api/media-files

メディアライブラリが空の場合、標準の動画をダウンロードしてアップロードしてください。

tmpdir="$(mktemp -d)"
curl -fL "https://artifacts.sima-neat.com/assets/videos/480p30/video01.mp4" \
  -o "${tmpdir}/video01.mp4"
curl -k -F "file=@${tmpdir}/video01.mp4" \
  https://127.0.0.1:9900/api/upload/media

追加のファイルについても同様の手順を繰り返すか、より多くのメディアファイルをまとめてアップロードする場合は、アーカイブとしてアップロードしてください。

単一ストリームのビジョンアプリを検証します。

Insight を開きます。
「メディアソース」にアクセスし、短いテスト動画をアップロードしてください。
「ストリーミングソース」に移動し、ビデオをsrc1に割り当ててください。
開始します src1。
正しい RTSP URL を使用してアプリケーションを実行してください。
- SDKコンテナ内：rtsp://127.0.0.1:8554/src1
- DevKit または外部マシンで：rtsp://<sdk-host-ip>:<rtsp.tcp hostPortStart>/src1
ビデオビューアーを開き、チャンネル0をご覧ください。
アプリがメタデータを送信する場合、ビデオにオーバーレイが表示されることを確認してください。
「Stats」プレースホルダーを使用して、次回のリリースでシステム負荷の診断情報がどこに表示されるかを確認してください。

ライブウェブカメラでアプリケーションを検証する

録画ファイルではなく実際のカメラでアプリケーションをテストするには、このワークフローを使います。ウェブカメラはボードではなくブラウザーを実行しているコンピューターに接続します。ブラウザーが Insight へ配信し、Insight は通常の RTSP ソースとして提供するため、アプリケーションはファイルと同じように利用します。

HTTPS で Insight を開き、ブラウザーが証明書を信頼していることを確認します。
Media Sources の ローカルカメラ で カメラアクセスを有効化 を選択します。ブラウザーの要求を許可すると、カメラが一覧に表示されます。
Streaming Sources の src1 ドロップダウンで カメラ グループからカメラを選びます。選択すると行に [CAM] マーカーが表示されます。
src1 を開始し、スロットが Live と表示され、プレビューにカメラが映ることを確認します。
ファイルソースと同じ RTSP URL でアプリケーションを実行します。Insight はウェブカメラを、ファイルソースと同じ規則的なキーフレームを持つベースライン H.264 に正規化します。ボードのハードウェアデコーダーと GStreamer の rtspsrc は追加の手順なしで利用でき、手動の ffmpeg や別の経路は不要です:
- SDK コンテナー内: rtsp://127.0.0.1:8554/src1
- DevKit または外部マシン: rtsp://<sdk-host-ip>:<rtsp.tcp hostPortStart>/src1
Video Viewer を開き、チャンネル 0 を確認します。

ウェブカメラの配信中はブラウザータブを表示し、前面に置いてください。タブが Insight へビデオを送信しており、ブラウザーは非表示やバックグラウンドのタブを制限するため、ストリームが途切れます。タブを閉じる、カメラを取り外す、または停止を選択するとストリームは終了します。

Insight が SDK 内で動作する場合、ブラウザーはアプリケーションが使う RTSP ポートに加え、neat --json の webrtcWhip ホストポートにも接続できる必要があります。ポートとネットワークの動作を参照してください。

複数の入力ストリームを検証する

メディアソースに複数の動画をアップロードするか、準備してください。
ストリーミングソースを使用する Auto Assign 動画をソーススロットにマッピングします。
アプリケーションで処理するソースの数を開始するには、Bulk Start を使用します。
対応するsrcNストリームのURLに対してアプリケーションを実行してください。
指定されたチャンネルでビデオビューアーを開きます。
ビューアーの診断機能を使用して、ストリームのボトルネックがないか確認してください。このバージョンでは、統計ビューはプレースホルダーとして提供されており、次回のバージョンでランタイムのボトルネック診断機能を追加する予定です。

アプリケーションがSDKコンテナー外で実行される場合、テストを開始する前に、neat --jsonからRTSP、ビデオUDP、およびメタデータUDPのホストポートを解決してください。

SDKのポートマップからアプリケーションのエンドポイントを設定します。

アプリケーションがDevKit上で動作し、InsightがSDK内で実行される場合に、このワークフローを使用してください。

SDK内で、Insight が実行されていることを確認してください。
```
insight-admin status
```
SDK ポートマップを入手してください。
```
neat --json
```
insight.webUiUrl から SDK ホストの IP アドレスを確認するか、SDK のセットアップ手順で表示されるホスト IP アドレスを使用してください。
exposedPortsの中から、rtsp.tcp.hostPortStart、videoUDP.hostPortStart、およびmetadataUDP.hostPortStartを見つけてください。

次の方法でアプリケーションの入力ストリームを設定します。

rtsp://<sdk-host-ip>:<rtsp.tcp hostPortStart>/src1
rtsp://<sdk-host-ip>:<rtsp.tcp hostPortStart>/src2

チャンネルごとにアプリケーションの出力ポートを設定します。

video channel N:    <sdk-host-ip>:<videoUDP hostPortStart + N>
metadata channel N: <sdk-host-ip>:<metadataUDP hostPortStart + N>

アプリケーションを起動し、「ビデオビューアー」を開きます。
視聴者が動画を表示しない場合は、/api/ingest/statsを使用してください。これにより、ブラウザまたはWebRTCの動作をデバッグする前に、RTPとメタデータがInsightに正常に送信されているかどうかを確認できます。

動画やオーバーレイが表示されない問題をデバッグします。

以下の手順で問題を特定してください。

アプリケーションが実行されており、正しいInsightホストをターゲットにしていることを確認してください。
アプリケーションが SDK コンテナー内で実行されているか、それとも外部のコンピューターで実行されているかを確認してください。
外部の場合、neat --json からマッピングされた videoUDP および metadataUDP のホストポートが使用されていることを確認してください。
SDKコンテナ内に存在する場合、出力ビデオポートが9000-9079にあることを確認してください。
使用している場合は、メタデータポートがメタデータ内の対応するチャンネルになっていることを確認してください。 UDP 範囲。
ビデオビューアーを開き、目的のチャンネルが表示されているか確認してください。
システム情報を参照して、Insight がデフォルトポートを使用しているか、SDKでマッピングされたポートを使用しているかを確認してください。
システム情報とログを使用して、デバイスの状態を確認してください。現在、統計情報はプレースホルダーであり、次回のリリースでは、デバイスの負荷とランタイムの健全性に関する情報を提供する予定です。

動画は表示されるものの、オーバーレイが表示されない場合は、メタデータパスに注目してください。オーバーレイの表示が遅れたり、同期がずれたりする場合は、ビューアーのメタデータ遅延設定を調整してください。

ヒント

新しいアプリのループを構築する際に、短いメディアクリップを使用してください。これにより、ソースの準備と繰り返し検証が迅速になります。
HTTP経由でmultipart MJPEGを送信するカメラをシミュレートする必要がある場合は、HTTP MJPEGソースを使用してください。
チャンネル番号を統一してください。ビデオがチャンネルNに送信される場合、同じNのメタデータポートにメタデータを送信してください。
ワークスペースビューを使用して、ファイルを環境からコピーする前に、生成されたモデルとプロファイリングの成果物を確認してください。
新しい開発者にツールを紹介する際に、Insight UI の右上にある「クイックツアー」機能を使用してください。
ポートに問題があると判断する前に、システム情報を確認してください。SDK を使用したデプロイメントでは、ブラウザがアクセスするポートと、内部サービスが使用するポートが異なる場合があります。

標準のテスト動画をインポートします。​

単一ストリームのビジョンアプリを検証します。​

ライブウェブカメラでアプリケーションを検証する​

複数の入力ストリームを検証する​

SDKのポートマップからアプリケーションのエンドポイントを設定します。​

動画やオーバーレイが表示されない問題をデバッグします。​

ヒント​