> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ja/chtoriaru/integrate-with-ignition/live-video.md).

# ライブ映像

Roboflow ストリームのライブ注釈付き映像を、Ignition Perspective のビューまたは Vision のウィンドウに表示します。

Roboflowエッジデバイス上の各ストリームは、デバイス上のURLで動画を配信します。Ignitionでは、オペレーターがすでに使用しているタグやコントロールの横に、その動画をPerspectiveビューまたはVisionウィンドウで表示できます。

<figure><img src="https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-d4ababd320d309a8ba954d7b15d6b24757e9885e%2Fignition-video-perspective.png?alt=media" alt="A Perspective view named Bottle Line 1 showing a live video of bottles on a conveyor with Roboflow detections and a count, next to a table of recent inspections"><figcaption><p>Perspectiveビュー内のRoboflowストリーム。</p></figcaption></figure>

## 前提条件

* ストリームを実行中のエッジデバイス。以下で管理します： [Deployment Manager](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager).
* デバイスのIPアドレス。Deployment Managerのデバイスページに表示されます。
* 動画を表示する各コンピューターから、ポート `8000`でデバイスにアクセスできる必要があります。動画はIgnitionゲートウェイではなく、オペレーターのブラウザーまたはVisionクライアントで読み込まれます。

{% hint style="info" %}
以下の手順とスクリーンショットはIgnition 8.1（Designer 8.1.55）を使用しています。メニュー名、ダイアログ、プロパティ名は、8.3を含む他のバージョンでは異なる場合があります。
{% endhint %}

## 動画URLを確認する

実行中の各ストリームでは、次のURLが提供されます。 `<stream>` をストリーム名に置き換えてください：

<table data-search="false"><thead><tr><th>URL</th><th>表示内容</th></tr></thead><tbody><tr><td><code>http://&#x3C;device-ip>:8000/inference_pipelines/&#x3C;stream>/output.mjpeg</code></td><td>Workflowの画像出力（例：ボックス、ラベル、カウント）のライブ動画</td></tr><tr><td><code>http://&#x3C;device-ip>:8000/inference_pipelines/&#x3C;stream>/input.mjpeg</code></td><td>カメラのライブ動画</td></tr><tr><td><code>http://&#x3C;device-ip>:8000/inference_pipelines/&#x3C;stream>/output.jpg</code></td><td>最新の出力フレームを1枚の画像として表示</td></tr><tr><td><code>http://&#x3C;device-ip>:8000/inference_pipelines/&#x3C;stream>/input.jpg</code></td><td>最新のカメラフレームを1枚の画像として表示</td></tr></tbody></table>

ストリーム名にスペースや記号が含まれる場合は、URLエンコードしてください（例： `Line%201`）。名前の一覧を確認するには、次を開きます： `http://<device-ip>:8000/inference_pipelines/list` 各 `pipeline_id`.

出力動画にアノテーションが表示されるのは、Workflowが画像を出力する場合のみです。可視化ブロック（例：Bounding Box Visualization）を追加し、その出力に `output_image`という名前を付けてください。画像出力がない場合、出力動画にはカメラフレームが表示されます。

トリガー式ストリームの場合、これらのURLには最後にトリガーされたフレームが表示されます。カメラ映像を表示するには、 `?source=live` を追加してください。

Ignitionに追加する前に、オペレーターのコンピューターのブラウザーでURLを開いてください。そこで再生できれば、Ignitionでも再生できます。詳しくは、 [ローカル動画](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/monitoring/view-a-stream#local-video).

## Perspective

### Imageコンポーネントを追加する

1. DesignerでPerspectiveビューを開き、「Image」コンポーネントをビューにドラッグします。
2. 次の値を設定します： `props.source` を `output.mjpeg` のURLに設定します。
3. 次の値を設定します： `props.fit.mode` を `contain` に設定すると、動画がコンポーネントに合わせて拡大縮小されます。

<figure><img src="https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-fa851d2f0d33d2b3d45f8f48d352641497643841%2Fignition-designer-image-source.png?alt=media" alt="Ignition Designer with a Perspective view open, the live Roboflow stream playing in an Image component, and the Property Editor showing source and fit mode contain"><figcaption><p>次のように設定すると、Designerでストリームが再生されます： <code>props.source</code> に設定されています。</p></figcaption></figure>

すべての行で同じビューを使うには、ビューのパラメーター（例: `deviceHost` と `stream`）を追加し、 `props.source` を次の式にバインドします。

```
"http://" + {view.params.deviceHost} + ":8000/inference_pipelines/" + {view.params.stream} + "/output.mjpeg"
```

<figure><img src="https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-2e784017604201dfa476474fb3f442e74ba2a7b6%2Fignition-designer-video-expression.png?alt=media" alt="The Edit Binding dialog for LiveVideo.props.source with an Expression binding built from view.params.deviceHost and a binding preview of the resulting URL"><figcaption><p>プレビューに構築された URL が表示された、 <code>props.source</code>の式バインディング。</p></figcaption></figure>

「Video Player」コンポーネントも、 `props.liveFeed` が `true`の場合、ストリームを再生します。 `props.liveFeed` オフの場合は動画ファイルを想定し、「メディアの読み込みエラー: ファイルが無効です」と表示されます。

{% hint style="warning" %}
動画には「Inline Frame」コンポーネントを使用しないでください。カメラのサイズでストリームを再生し、拡大縮小せずにトリミングします。
{% endhint %}

### フレームを更新して帯域幅を節約する

各 Perspective セッションは、デバイスからカメラのフルサイズ、ストリームのフレームレートで独自の動画ストリームを開きます。多くのセッションで同じストリームを表示する場合や、ネットワークが遅い場合は、代わりに1秒ごとに更新されるフレームを表示します。 `props.source` を次の式にバインドします。

```
"http://" + {view.params.deviceHost} + ":8000/inference_pipelines/" + {view.params.stream} + "/output.jpg?t=" + toMillis(now(1000))
```

`now(1000)` は1,000ミリ秒ごとに式を再実行します。変化する `t` の値によって、ブラウザーはキャッシュされたフレームではなく、新しいフレームを読み込みます。

### HTTPS での Perspective

ブラウザーは、 `http://` の画像を、 `https://`で読み込まれたページ上でブロックします。Perspective セッションで HTTPS を使用している場合、動画は読み込まれません。デバイスの前段に HTTPS リバースプロキシを配置してその URL を使用するか、工場ネットワーク上で HTTP 経由でセッションを開いてください。 `https://` URL

## Vision

1. Designer で Vision ウィンドウを開き、「IP Camera Viewer」コンポーネントをドラッグして配置します。
2. Vision プロパティエディターで、「URL」に `output.mjpeg` の URL を設定します。ビューアーはほかに変更を加えなくても MJPEG を再生します。
3. 動画をトリミングせずにコンポーネントに合わせるには、「Scale Video」をオンにします。これはエキスパートプロパティです。すべてのプロパティを表示するには、プロパティエディターのツールバーにあるフィルターメニューを使用してください。

<figure><img src="https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-75ac74ce67b667195b91712c51fe40864eb599e4%2Fignition-vision-ip-camera-viewer.png?alt=media" alt="Ignition Designer with a Vision window showing the Roboflow stream in an IP Camera Viewer, and the Vision Property Editor with Scale Video set to true"><figcaption><p>「Scale Video」をオンにした IP Camera Viewer。</p></figcaption></figure>

動画の拡大縮小には、表示する各クライアントで CPU が使用されます。詳しくは、 [IP Camera Viewer](https://docs.inductiveautomation.com/docs/8.3/appendix/components/vision-components/display/ip-camera-viewer).

## トラブルシューティング

<table data-search="false"><thead><tr><th>問題</th><th>対処方法</th></tr></thead><tbody><tr><td>壊れた画像アイコン</td><td>同じコンピューター上のブラウザーで URL を開きます。そこで開けない場合、そのコンピューターはポート <code>8000</code>でデバイスに接続できないか、ストリーム名が間違っています。</td></tr><tr><td>ブラウザーでは URL が機能するが、HTTPS 経由の Perspective セッションでは機能しない</td><td>ブラウザーが混在コンテンツをブロックしています。「HTTPS での Perspective」を参照してください。</td></tr><tr><td>動画にボックスやラベルが表示されない</td><td>Workflowに画像出力がありません。次の名前の可視化ブロックを追加してください <code>output_image</code>.</td></tr><tr><td>「メディアの読み込みエラー：ファイルが無効です」</td><td>Video Playerで <code>props.liveFeed</code> を <code>true</code> に設定するか、Imageコンポーネントを使用してください。</td></tr><tr><td>画面を多数開くと動画がカクつく</td><td>それらの画面を更新されたフレームに切り替えてください。</td></tr><tr><td>トリガーされたストリームに古いフレームが表示される</td><td>URLに <code>?source=live</code> を追加してください。</td></tr></tbody></table>

## セキュリティ

動画のURLへのアクセスにログインは必要ありません。ポート `8000` を介してデバイスに接続できる人は誰でも、ストリームを視聴できます。デバイスは信頼できるネットワークに接続してください。詳しくは [デバイスサービス](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services).

## 関連項目

* [デバイスのHMIを埋め込む](https://docs.roboflow.com/workflows/ja/chtoriaru/integrate-with-ignition/embed-the-device-hmi.md)：動画を含むRoboflowオペレーター画面全体を、1つのコンポーネントに表示します。
* [ライブデータ](https://docs.roboflow.com/workflows/ja/chtoriaru/integrate-with-ignition/live-data.md)：Workflowの結果をOPC UA経由でIgnitionタグとして取得します。
* [履歴データ](https://docs.roboflow.com/workflows/ja/chtoriaru/integrate-with-ignition/historical-data.md)：画像付きのすべての検査結果。
