> 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/deployment/ja/roboflow-cloud/cloud-streaming/quickstart.md).

# Cloud Streaming クイックスタート

カメラを1台接続し、物体検出ワークフローのクラウド処理を開始して、Webアプリ、Roboflow Agent、またはHTTP APIで結果を確認します。

カメラを1台接続し、オブジェクトを検出して予測結果を描画するWorkflowを実行します。Web App、Roboflow Agent、またはHTTP APIの手順に従ってください。

## 始める前に

処理用クレジットがあるRoboflowワークスペースと、接続するカメラが必要です。RTSPカメラまたはUSBカメラを使用する場合は、カメラと同じネットワーク上のコンピューターを起動したままにし、 [Video Connectorをインストール](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/install-a-connector.md)します。コネクターはカメラとインターネットの両方に接続できる必要があります。

次の内容で [Workflow](https://docs.roboflow.com/workflows/build/create-a-workflow) を作成して保存します。

* 画像入力を1つ。
* 次の名前のObject Detection Modelブロック： `model`。ワークスペースで実行できるモデルを使用します（例： `rfdetr-nano`).
* 入力画像とモデルの予測結果を受け取るBounding Box Visualizationブロック。
* このガイドでは、 `predictions` 出力と、可視化ブロックからの画像出力に次の名前を付けます。 `bounding_box_visualization` 。

ライブカメラに接続する前に、動画でWorkflowをテストしてください。モデルが認識できるシーンの短い動画をフォルダーに入れ、コネクターを次のオプション付きで起動します。 `--files-dir` を指定すると、 [ファイルをライブソースとしてループ再生](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/connect-a-source.md#loop-a-local-file)できます。ファイルは、Workflowを実行できるソースとして表示されます。

エディターの実行パネルでは「Enable Sinks」がデフォルトでオンになっています。Workflowから外部システムへの書き込みが必要な場合を除き、テスト中はオフにしてください。

デプロイする前にWorkflowを公開してください。プレビューでは未公開の変更も実行できます。

## Web App

### カメラを接続する

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-44a2b7bba5beaaf8fa2c978b23a07c03db50fdc3%2Fcloud-streaming-shot01-source-list.png?alt=media" alt="Cloud Streaming source list with offline sources and Add Video Source."><figcaption><p>Cloud Streamingを開いてソースを確認し、カメラを追加します。この例のソースはオフラインです。</p></figcaption></figure>

1. 「Deployments」を開き、「Cloud Streaming」を選択します。
2. 「Add Video Source」をクリックし、「Connect a Camera」を選択します。
3. ワークスペースにコネクターがすでにある場合は、「Add a new connector」をクリックします。カメラに接続できるコンピューターで「Install and run the connector」の手順に従ってください。コマンドに含まれるAPIキーは秘密にしてください。
4. 「Confirm it's connected」にコネクターがオンラインと表示されたら、「Done」をクリックします。
5. ソース一覧からカメラを選択します。ネットワークカメラの場合は、 [RTSP URLを追加するか、ONVIFプロファイルを選択します](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/connect-a-source.md#rtsp-and-onvif-cameras)。対応プラットフォームでは、USBカメラは自動的に表示されます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-891a6980b60e4b2db8de7e19117ee9619ea1f59a%2Fcloud-streaming-shot02-connector-connected.png?alt=media" alt="Connector setup dialog with its API key redacted and a successful connection."><figcaption><p>コネクターを実行し、接続確認が表示されるまで待ちます。</p></figcaption></figure>

ソースのプレビューに目的のカメラが表示されていることを確認します。サムネイルは古い静止画の場合があるため、ライブ映像の確認にサムネイルだけを使わないでください。

### 処理を開始する

1. ソースを開き、「Run a Workflow」を選択します。
2. 「Workflow」で保存済みのWorkflowを選択します。
3. フォームにオプションが表示される場合は、Workflowのオプションを設定します。「Workflow Inputs」の必須項目を入力し、任意項目はデフォルト値を使用する場合は空欄のままにします。「Visual Preview Output」は最初の画像出力を選択します。Workflowに画像出力が複数ある場合は、 `bounding_box_visualization` を選択してください。
4. 処理の見積もりと表示される確認内容を確認してから、「Start Processing」をクリックします。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0bf2c75abf6814c079de99ed98e7758ca5ded6f2%2Fcloud-streaming-shot03-start-processing.png?alt=media" alt="Run a Workflow panel with a selected Workflow, visual output and Start Processing."><figcaption><p>開始する前に、Workflowと画像出力を選択してください。この例に示す出力名と料金は説明用です。</p></figcaption></figure>

アプリはWorkflow内のモデルに基づいてGPUサイズを選択します。Workflowに必要なGPUメモリがそのサイズを超える場合、アプリはより大きなGPUへ自動的に切り替え、それに応じて時間単価も変わります。プロセッサーがモデルを読み込むため、開始まで時間がかかることがあります。見積もりは時間単価であり、固定の合計金額ではありません。詳細は、 [料金と制限](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/pricing-and-limits.md).

### 結果を確認する

ソースページには入力とWorkflowの出力が表示されます。期待するオブジェクトにボックスが表示されていることを確認してください。処理メトリクスでパフォーマンスを確認し、「Latest Result」で最新の構造化出力を、「Activity」でライフサイクルイベントを確認できます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-39b4835b92704ef19fac1eb2a7e87d3c51374acd%2Fcloud-streaming-shot04-running-results.png?alt=media" alt="Running Workflow with annotated video and Latest Result."><figcaption><p>入力動画と注釈付き出力を比較し、Latest Resultを確認します。表示価格は参考値です。</p></figcaption></figure>

注釈付き動画には画像出力が必要ですが、JSONのみのワークフローでは必要ありません。出力の配信と外部連携については、 [結果の利用](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/consume-results.md) をご覧ください。

ページを離れたりプレーヤーを閉じたりしても、実行は処理を続けます。実行の追跡については、 [実行の管理と監視](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/manage-and-monitor.md) をご覧ください。

### ワークフローエディターから開始する

ワークフローエディターで「Deploy」をクリックする方法（または、Agentでワークフローを開いて「Use」をクリックする方法）もあります。「Cloud Streaming」を選び、接続済みのソースを選択してください。同じフローに進みます。

未公開の変更をテストするには、代わりにエディターで「Run」をクリックし、ストリームを選択します。変更は短時間だけ実行され、実行中のデプロイはそのまま継続します。プレビューを継続実行にする前に、 [ワークフローのライフサイクル](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/run-a-workflow.md#workflow-lifecycle) をご確認ください。

## Roboflow Agent

1. Agentを開き、「カメラの接続と、物体検出ワークフローのプレビューを手伝ってください」と尋ねます。
2. 既存のカメラを選ぶか、「Network Streams」を使ってコネクターを設定します。コネクターを使わずに短時間テストする場合は、「Webcam」または「Phone」を選び、カメラまたはQRコードの設定を完了してください。
3. Agentに、選択したカメラで保存済みワークフローのドラフトをプレビューするよう依頼します。動画と予測を確認してください。プレビューによって現在のデプロイが置き換わることはありません。
4. コネクターまたはRTMP経由で接続されたカメラの場合は、チャットボックスの上にある「Deploy Stream」をクリックするか、「この実行中のプレビューを継続的にデプロイしてください」と依頼します。価格を確認して確定してください。デプロイでは、プレビュー時のワークフロー、状態、シンク設定がそのまま引き継がれます。ドラフトが公開されたり、無効になっているシンクが再び有効になったりすることはありません。

ブラウザーのWebカメラやスマートフォンのQRセッションは、デプロイに昇格できません。一時的なプレビューを使用する間は、操作しているブラウザーを開いたままにしてください。継続的に使用するには、代わりにコネクターまたはRTMP経由でカメラを接続します。プレビューの切断だけを依頼した場合でも、別のデプロイは実行を続けます。

## HTTP API

次のスコープを持つワークスペースAPIキーを使用します： `video-inference-job:create`, `video-inference-job:read`, `workflow:read`および `model:infer` 。詳しくは、 [API認証](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api)をご覧ください。ワークスペースとワークフローのスラッグは、ワークフローエディターのURLに含まれています： `app.roboflow.com/YOUR_WORKSPACE/workflows/edit/YOUR_WORKFLOW_SLUG`.

### ソースを探す

ソースを一覧表示し、 `id` が次のカメラのIDをコピーします： `status` が `connected`.

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-sources/v1" method="get" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### ワークフローの入力と出力を確認する

次の出力を選択します： `isImage: true` （例： `bounding_box_visualization`）。これにより注釈付き動画を取得できます。その他の入力は `workflowParameters`で設定します。画像入力はカメラから提供されます。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-sources/v1/workflow-interface" method="get" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### ジョブを開始する

実行ごとに新しい `Idempotency-Key` を送信します。 `workflowUrl`だけを指定すると、ジョブはSmall GPU上のデプロイとして実行され、スクリプトの終了後も動作し続けます。追加する `processorSize` より大規模なモデル向け（ [GPU サイズ](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/pricing-and-limits.md#gpu-sizes)).

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-sources/v1/{sourceId}/jobs" method="post" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### ジョブを確認する

ジョブの `state` が `running`.

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-jobs/v1/{jobId}" method="get" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### 結果を取得する

画像出力用の視聴許可をリクエストし、 `whepUrl` を WHEP 対応プレーヤーで開きます。視聴中は30秒ごとにリクエストを繰り返してください。これらのURLは非公開にしてください。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-jobs/v1/{jobId}/watch" method="post" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

予測結果を独自のアプリケーションに送信するには、ワークフローに [Webhook Sink](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/consume-results.md#send-results-with-a-workflow-sink) を追加します。
