> 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/roboflow/roboflow-jp/deploy/device-manager/making-changes/trigger-a-stream.md).

# Stream をトリガーする

「Triggered」モードに設定された Streams は、すべてのフレームで推論を実行しません。代わりに、カメラからフレームを継続的に取得し、明示的なトリガーを待って、最新のフレームに対して設定された Workflow を実行します。これは、推論コストが高い場合、結果が特定のタイミングでのみ必要な場合（たとえば、PLC が部品が所定の位置にあることを通知する場合）、または外部システムが検査の間隔を制御する場合に便利です。

ストリームは次の 2 つの方法でトリガーできます：

1. クラウドから、Deployment Manager ダッシュボードを使用して。
2. エッジから、デバイス上のローカル HTTP エンドポイントを呼び出して。

どちらの方法を使う場合でも、ストリームは「Triggered」モードに設定されている必要があります。あなたが [追加するとき](/roboflow/roboflow-jp/deploy/device-manager/setting-up/add-a-stream.md) または [デバイス構成を更新することで](/roboflow/roboflow-jp/deploy/device-manager/making-changes/update-device-configuration.md).

## クラウドトリガー

クラウドトリガーは Roboflow app から発行され、Deployment Manager によってデバイスへ転送されます。手動トリガー、デモ、またはトリガーを開始するシステムがインターネットに接続されているがデバイスのローカルネットワーク上にない場合に使用します。

Deployment Manager ダッシュボードで、ストリームをホストしている Device をクリックします。各 Triggered ストリームには「Trigger」ボタンがあります。「Trigger」をクリックすると、最新フレームに対して 1 回の推論実行が行われます：

デバイスがトリガーを処理している間、ストリームには「Waiting for device...」と表示されます。デバイスが結果を返すと、ステータスは「Inference complete」に更新され、レンダリングされたフレームが Workflow の出力で更新されます。

トリガーはデバイス上でコマンドとしてキューに入り、デバイスが次に Deployment Manager をポーリングしたときに処理されます（通常は数秒以内）。クラウドトリガーは高頻度のトリガー用途向けではありません。1 秒未満のレイテンシが必要な場合や、1 分あたり数回を超えるトリガーを発行する場合は、代わりにエッジトリガーを使用してください。

## エッジトリガー

エッジトリガーは、デバイス上で実行中の推論サーバーに直接送る HTTP 呼び出しです。PLC、ローカルスクリプト、またはデバイスと同じネットワーク上の任意のシステムから、本番環境でのトリガーに使用します。エッジトリガーは Deployment Manager を経由する往復を避けられ、レイテンシに敏感な連携に推奨される方法です。

デバイス上の推論サーバーは、実行中の各ストリームに対してトリガーエンドポイントを公開します：

```
POST http://<device-ip>:8000/inference_pipelines/{pipeline_id}/trigger
```

置き換えてください `<device-ip>` ネットワーク上のデバイスの IP アドレスを指定し、 `{pipeline_id}` トリガーしたいストリームの ID を指定します。pipeline ID は Deployment Manager のストリーム詳細で確認できます。

リクエスト本文は省略可能です。単一のトリガーでストリームに設定された Workflow パラメータを上書きするには、本文に含めます：

```json
{
  "workflows_parameters": {
    "confidence": 0.7
  }
}
```

トリガーが成功すると、取得したフレームに対する Workflow の出力が返されます：

```json
{
  "success": true,
  "data": {
    "frame_id": 1024,
    "timestamp": 1716220800.123,
    "workflow_output": [
      {
        "predictions": []
      }
    ]
  }
}
```

デバイスがまだフレームを取得していない場合、または pipeline が実行中でない場合、レスポンスは `success: false` 理由を説明するメッセージ付きで。

{% hint style="info" %}
エッジトリガーのエンドポイントにアクセスできるのは、デバイスのローカルネットワークからのみです。外部から呼び出すには、独自のネットワークインフラを通してデバイスを公開するか、クラウドトリガーを使用してください。
{% endhint %}

## Cloud と Edge のトリガーの選択

| ユースケース                                 | 推奨トリガー |
| -------------------------------------- | ------ |
| Roboflow app からストリームを手動で確認する           | クラウド   |
| Triggered ストリームのデモまたはテスト               | クラウド   |
| デバイスと同じネットワーク上の PLC、センサー、またはバーコードスキャナー | エッジ    |
| 同じリクエスト内で推論結果を返す必要があるローカルスクリプト         | エッジ    |
| 高頻度のトリガー（1 分あたり数回を超える場合）               | エッジ    |