> 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/depuroi/video-processing.md).

# Workflowsによる動画処理

管理された Cloud Streaming をライブカメラ用に選択するか、自己ホスト型の推論サーバーで Web カメラ、カメラフィード、動画ファイルを処理します。

管理対象のライブカメラ処理には、 [Cloud Streaming](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming)を使用します。これは、カメラソースをRoboflow管理のコンピューティング上のWorkflowジョブに接続します。以下の [クイックスタート](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/quickstart) に従って、接続、プレビュー、デプロイ、結果の表示、処理の停止を行ってください。

使用する [バッチ処理](https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing) 有限のジョブとして完了させる必要がある保存済みメディア向けです。代わりに、Cloud Streaming内のコネクターローカルファイルはライブテストソースとしてループします。

## セルフホスト型ビデオ

以下のInference SDK WebRTCクライアントは、お使いのInference Server上でWorkflowを介してビデオを実行します。フレームの処理中は1つのセッションを開いたままにし、トラッカーやカウンターなどのステートフルブロックをサポートし、フレームごとに個別のHTTPリクエストを行う必要がありません。

以下を起動します [Inference Server](https://docs.roboflow.com/deployment/self-hosted/inference-server) を、クライアントを実行する前に起動してください。処理を自分のハードウェアまたはネットワーク内に留める必要がある場合は、セルフホスティングを使用してください。以下を参照してください [ビデオ構成](https://docs.roboflow.com/deployment/self-hosted/inference-server/configuration/video-configuration) ワーカー制限とサーバー側メディア参照については、を参照してください。

以前の [Serverless Video Streaming API](https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api/serverless-video-streaming-api) は非推奨です。既存のレガシーリファレンスは引き続き利用できますが、Cloud Streamingで説明されているマネージドライブの方法ではありません。移行はAPI URLの置き換えではありません。

## SDKをインストールする

```bash
pip install "inference-sdk[webrtc]"
```

## Workflowをストリーミングする

この例では、ウェブカメラからビデオをキャプチャし、 `予測` 保存済みWorkflowからの出力を表示します:

```python
from inference_sdk import InferenceHTTPClient, InferenceConfiguration
from inference_sdk.webrtc import StreamConfig, WebcamSource

client = InferenceHTTPClient(
    api_url="http://localhost:9001",
    api_key="ROBOFLOW_API_KEY",
).configure(InferenceConfiguration(api_key_transport="header"))

session = client.webrtc.stream(
    source=WebcamSource(),
    workflow="workflow-id",
    workspace="workspace-name",
    config=StreamConfig(data_output=["predictions"]),
)

@session.on_data("predictions")
def handle_predictions(predictions, metadata):
    print(f"Frame {metadata.frame_id}: {predictions}")

session.run()
```

以下を置き換えてください `workflow-id`, `workspace-name`、および `ROBOFLOW_API_KEY` をお使いの値に置き換えてください。 `api_url` をセルフホスト型サーバーに指定します。

次の名前は `data_output` で定義される出力と、Workflowで定義された出力が一致している必要があります。画像出力をビデオとして受信するには、それを次に追加します `stream_output` し、次の `on_frame` ハンドラーを登録します。以下を参照してください [WebRTCストリーミングのリファレンス](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc#stream-a-workflow) 完全な例については、を参照してください。

## ビデオソースを選択する

次を変更します `source` に渡される `client.webrtc.stream()` を、ビデオの取得元に応じて変更します:

<table data-search="false"><thead><tr><th>ソース</th><th>使用する場面</th></tr></thead><tbody><tr><td><code>WebcamSource()</code></td><td>カメラがクライアントマシンに接続されている場合。</td></tr><tr><td><code>RTSPSource("rtsp://...")</code></td><td>Inference ServerがRTSPカメラに到達できる場合。</td></tr><tr><td><code>LocalStreamSource("rtsp://...")</code></td><td>RTSPまたはRTMPストリームに到達できるのがクライアントのみの場合。</td></tr><tr><td><code>VideoFileSource("video.mp4")</code></td><td>保存済みのビデオファイルを処理したい場合。</td></tr><tr><td><code>ManualSource()</code></td><td>アプリケーションが個々のフレームを提供する場合。</td></tr></tbody></table>

については、 `RTSPSource`では、Inference ServerがカメラURLに到達できる必要があります。次を使用してください `LocalStreamSource` は、到達できるのがクライアントのみの場合に使用します。管理対象のCloud Streamingでは、カメラのRTSPポートをパブリックインターネットに公開するのではなく、Video Connectorを介してカメラを接続してください。

以下を参照してください [WebRTCビデオソース](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc#video-sources) ソース構成については、また [結果の利用](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc#consuming-results) コールバック、イテレーター、セッションクリーンアップについては、を参照してください。

## 1つのモデルをストリーミングする

1つのモデルだけが必要な場合は、Workflowを構築する必要はありません。次を渡します `model_id` の代わりに `workflow` および `workspace`:

```python
session = client.webrtc.stream(
    source=WebcamSource(),
    model_id="rfdetr-nano",
)
```

以下を参照してください [モデルをストリーミングする](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc#stream-a-model) タスクタイプ別の予測処理について。

## 次のステップ

* 以下でフレームおよびデータ出力を構成する [WebRTCストリーミングのリファレンス](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc).
* 以下を開始して構成する [セルフホスト型Inference Server](https://docs.roboflow.com/deployment/self-hosted/inference-server).
* 以下を使用して管理対象のライブカメラを接続する [Cloud Streaming](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming).
