> 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/connect-a-source.md).

# ソースを接続する

USB、RTSP、ONVIF、ウェブカメラ、スマートフォン、または直接 RTMP の動画を Cloud Streaming に接続し、各ソースのライフサイクルを理解します。

ソースはCloud Streamingに動画を供給します。接続してもワークフローは開始されません。ライブ動画を確認したら、 [ソースでワークフローを実行し、](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/run-a-workflow.md) ます。

<table data-search="false"><thead><tr><th>ソース</th><th>接続方法</th><th>有効期間</th></tr></thead><tbody><tr><td>USB、RTSP、またはONVIFカメラ</td><td>カメラのコンピューターまたはネットワーク上のVideo Connector</td><td>コネクターとカメラが利用可能な間は再利用できるソース</td></tr><tr><td>Roboflow Outpostアプリをインストールしたスマートフォン</td><td>スマートフォン上のアプリ</td><td>アプリがストリーミングしている間は再利用できるソース</td></tr><tr><td>コネクター上のローカルファイル</td><td>ファイルディレクトリを設定したVideo Connector</td><td>ループ再生されるライブテストソース。有限のバッチアップロードではありません</td></tr><tr><td>ブラウザーのウェブカメラまたはスマートフォンのQRコードセッション</td><td>ブラウザーのカメラパブリッシャー</td><td>一時的なセッション。プレビュー専用</td></tr><tr><td>RTMPまたはRTMPSパブリッシャー</td><td>アプリから取得した直接公開URL</td><td>再利用可能な直接ソース</td></tr></tbody></table>

## Webアプリ

### USBカメラ

[コネクターをインストールして起動し、](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/install-a-connector.md) そのコンピューターでカメラへのアクセスを許可します。検出された対応USBカメラは、"Cloud Streaming" に表示されます。キャッシュされたサムネイルだけでなく、ソースのライブプレビューを確認してください。解像度、フレームレート、ビットレートを変更するには、ソースページの "Capture Settings" を使用します（詳しくは [キャプチャとコーデックの設定](#capture-and-codec-settings)).

### RTSPおよびONVIFカメラ

"Cloud Streaming" でコネクターを開き、"RTSP Cameras" を探します。または、"Add Video Source"、"Connect a Camera" の順にクリックし、"Add to an existing connector" でカメラのネットワーク上にあるコネクターを選択します。 [コネクターを更新](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/install-a-connector.md#preserve-state-when-updating) アプリから求められた場合は更新してください。この方法で1つのコネクターに最大50台のカメラを追加できます。

既知のストリームを追加するには、"Add by RTSP URL" をクリックし、名前とカメラの完全なRTSP URLを入力します。ユーザー名とパスワードはそれぞれ専用の欄に入力し、"Add camera" をクリックします。

"Cameras found on the network" のカメラの横にある "Add" をクリックし、"Username" と "Password" を入力してから、"Add camera" をクリックします。カメラが認識されたら、ドロップダウンからプロファイルを選択します。

処理を開始する前に、"Applied" とライブソースが表示されるまで待ちます。パネルに "Rejected by the connector" と表示された場合は、理由を確認して設定を修正し、もう一度保存してください。

カメラを編集すると、ストリームが中断されることがあります。カメラを削除して再追加すると、新しいソースが作成されます。保存済みのパスワードを読み返すことはできません。

### スマートフォンアプリ

スマートフォンを常設カメラとして使用するには、"Add Video Source"、"Phone" の順にクリックします。スマートフォンのストア（App StoreまたはGoogle Play）用のコードをスキャンし、Roboflow Outpostアプリをインストールします。サインインしてワークスペースを選択し、ストリーミングを開始します。スマートフォンがソースとして表示されます。アプリはバックグラウンドでもストリーミングを続け、自動的に再接続します。

* [iOS版Roboflow Outpost](https://apps.apple.com/us/app/roboflow-outpost/id6813159424)
* [Android版Roboflow Outpost](https://play.google.com/store/apps/details?id=com.roboflow.connector)

### URLによるカメラ接続

インターネットからの接続を受け付けるカメラには、コネクターは必要ありません。"Add Video Source" の "Camera URL" タブを選択し、RTSPまたはRTSPSのURL、あるいはHLSプレイリストのURLを入力します。詳しくは [URLによるカメラの追加](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/add-cameras-by-url.md).

### Verkadaカメラ

"Add Video Source" の "Verkada" タブを選択して、APIキーでVerkada組織に接続し、カメラを追加します。詳しくは [Verkadaカメラ](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/verkada.md).

### 一時的なウェブカメラおよびスマートフォンのセッション

Workflowエディターの実行パネルからウェブカメラの映像をストリーミングするか、Agentで "Use Webcam" または "Use Your Phone" を選択します。スマートフォンの場合はQRコードをスキャンし、"Start Camera" をタップします。コードは1回のみ使用でき、有効期限は5分です。セッションを終了するには、"Stop Streaming" をタップします。

ストリームを停止せずにレンズを切り替えるには、スマートフォンのページにあるカメラメニューを使用します。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-ba4bedba2138e02567e1476891df3c69ce2c548f%2Fcloud-streaming-shot08-webcam.png?alt=media" alt="Agent test-source picker with File, Webcam and Stream options."><figcaption><p>Webcamを選択すると、一時的なブラウザーカメラのプレビューが開始されます。</p></figcaption></figure>

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-560ab41d13a8aa8d52bf271ee8ec30dd87418903%2Fcloud-streaming-shot08-phone.png?alt=media" alt="Connect your phone panel with QR pairing instructions and an expiry timer."><figcaption><p>スマートフォンのペアリングコードをスキャンし、セッション中は公開ページを開いたままにしてください。</p></figcaption></figure>

パブリッシャーの切断またはセッションの停止によって、セッションとそのジョブが終了します。プレビューは、スマートフォンからの公開が続いていても、制御しているブラウザーを閉じると終了します。一時ソースはプレビュー専用で、昇格できません。継続的に処理するには、コネクターまたは直接ソースを使用してください。

### 直接 RTMP および RTMPS

{% hint style="info" %}
直接取り込みは「RTMP Stream」と表示され、「Pilot」ラベルが付きます。「Manage Source Video」権限が必要で、現時点では EU リージョンでは利用できません。
{% endhint %}

1. 「Add Video Source」を開き、「RTMP Stream」を選択して、「Source Name」を入力し、「Create stream source」をクリックします。
2. プロトコルを選択します。配信元が対応している場合は RTMPS をおすすめします。RTMP では映像とストリームキーが暗号化されずに送信されます。
3. 「Server URL」と「Stream Key」をカメラまたはエンコーダーにコピーします。アドレスを 1 つしか指定できない場合は、「Copy full URL」を使い、キー欄は空のままにします。
4. 配信を開始し、ライブ映像が表示されるまで待ってから、「Run a Workflow」を選択します。

Workflow ジョブがキューに入っているか実行中でない限り、作成から 24 時間以内に映像を受信しなかった直接ソースは Roboflow によって削除されます。配信元の準備ができてからソースを作成してください。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-648c95ce19005239e05a99053e061050d3322773%2Fcloud-streaming-shot09-rtmp-pilot.png?alt=media" alt="RTMP Stream Pilot setup with RTMPS selected and a masked stream key."><figcaption><p>表示された配信情報をエンコーダーにコピーします。ストリームキーは他人に知られないようにしてください。</p></figcaption></figure>

ホスト名を組み立てたり、URL スキームを自分で変更したりせず、アプリから返された URL を使用してください。

詳細をもう一度確認するには、ソースのメニューから「Connection Settings」を選択します。「Rotate key」を実行すると配信が切断されるため、配信元を更新して再度配信してください。「Set custom key」には、英字、数字、ハイフン、アンダースコアを 8～128 文字で指定します。

切断された後、 [再開しない場合は、Workflow を再起動してください](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/run-a-workflow.md#restarts) 。

## キャプチャとコーデックの設定

USB カメラの場合は、ソースのメニューから「Capture Settings」を選択し、カメラが対応しているモードを選びます。「Applied」と表示されるまで待ちます。「Settings rejected」と表示された場合、カメラは以前の設定を維持しています。設定を適用すると、ストリームが再起動することがあります。

RTSP カメラでは通常、再エンコードせずにカメラ独自のエンコード済みストリームを使用します。コネクターの USB 設定を変更しても、RTSP カメラの解像度、FPS、帯域幅は下がりません。代わりにカメラのプロファイルまたはエンコーダーの設定を変更してください。

幅広いブラウザーで再生できるようにするには、B フレームなしの H.264 を使用し、できればベースラインプロファイルを選択してください。H.265 または B フレームを含む H.264 はリレーまでは届いても、ブラウザーで再生できないことがあります。転送方式だけを変更しても、互換性のないコーデックの問題は解決しません。対応するカメラプロファイルを使用するか、処理能力のあるホストで意図的にトランスコードしてください。

## コネクター CLI

### ローカルファイルをループ再生する

ローカルディレクトリ内の動画を登録するには、次のようにします。

```sh
~/.rfv-connector/rfv-connector \
  --api-key "$ROBOFLOW_API_KEY" \
  --files-dir ./videos
```

コネクターは、フォルダー内の各動画ファイル（サブフォルダー内は対象外）をライブソースとしてループ再生します。ライブ処理ではフレームがスキップされる場合があります。ファイルを最後まで処理するには、次を使用してください。 [バッチ処理](https://docs.roboflow.com/deployment/ja/roboflow-cloud/batch-processing.md).

### サムネイルを制御する

コネクターはカメラを検出したときに各カメラの静止画を撮影し、その後は 1 日に 1 回撮影します。このとき、カメラのライトが一時的に点灯することがあります。

今後の撮影を停止するには、コネクターのページで「Camera thumbnails」をオフにするか、次のオプションを指定して起動します。 `--no-thumbnails` ローカル設定として適用されます。撮影を無効にしても、既存のサムネイルは削除されません。サムネイルはライブ映像でも録画でもなく、処理が実行中であることを示す証拠でもありません。

## HTTP API

パスで指定したワークスペースの認証情報を使って、 [API 認証](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api) を行います。インターネット経由で到達可能なカメラを追加するには、 [URL によるカメラ API](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/add-cameras-by-url.md#http-api)を参照してください。RTSP カメラをコネクターに追加する、コネクターを設定する、直接 RTMP ソースを作成する、配信キーをローテーションする場合は、Roboflow アプリを使用してください。これらの操作に対応する API エンドポイントはありません。

### 登録済みソースの一覧を取得する

ジョブを開始する前に、接続済みソースの ID をコピーしてください。

{% 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 %}

### ソース映像をプレビューする

モデルを実行せずにカメラの映像を確認できます。プレーヤーを開いたまま、再度呼び出してください。URL は他人に知られないようにしてください。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-sources/v1/{sourceId}/preview" 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 %}

### 一時セッションを割り当てる

返された WHIP URL に 2 分以内に映像を配信してください。Idempotency-Key は同じリクエストを再試行する場合にのみ再利用します。 `Idempotency-Key` は、同じリクエストを再試行する場合にのみ再利用してください。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-sources/v1/temporary" 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 %}

一時セッションのジョブはプレビュー専用です。配信セッションとそのジョブの所有者は、それぞれ異なる有効期間を持ちます。詳しくは、 [一時プレビューの所有権](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/run-a-workflow.md#hold-a-temporary-preview).

### 一時セッションを停止する

キャプチャが完了したら、セッションを停止してください。これにより配信アクセスが取り消され、関連するジョブがキャンセルされます。Workflow ジョブだけを停止することと、ソースセッションを終了することは異なります。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-sources/v1/{sourceId}/stop-session" 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 %}
