> 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/consume-results.md).

# 結果を消費

Cloud Streaming の動画と JSON 結果を表示し、結果を webhook に送信し、スナップショットまたは短いクリップを保存します。

保持する内容に応じて、結果の取得方法を選択します。実行中のWorkflowを確認するには、ライブ動画と「Latest Result」が便利です。選択した結果をアプリケーションに送信するにはWorkflow sinkを使い、ある瞬間を保存するにはブラウザーキャプチャを使います。

## 結果の取得方法を選択する

<table data-search="false"><thead><tr><th>目的</th><th>使用するもの</th><th>制限</th></tr></thead><tbody><tr><td>カメラを見る</td><td>入力プレビュー</td><td>Workflowを実行したり、動画を保存したりすることはありません。</td></tr><tr><td>注釈付きの出力を見る</td><td>アプリプレーヤーまたはライブ出力の視聴許可</td><td>画像出力と有効な視聴リースが必要です。</td></tr><tr><td>現在の予測を確認する</td><td>アプリまたはAgentのLatest Result</td><td>現在の結果です。永続的な履歴や、キャプチャしたすべてのフレームではありません。</td></tr><tr><td>すべてのJSON結果をアプリケーションで受信する</td><td><a href="https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/live-results.md">ライブ結果フィード</a></td><td>接続前の結果は保存されません。</td></tr><tr><td>選択した結果を別の場所に送信する</td><td>Workflow sink</td><td>実行中のWorkflowで有効になっているブロックのみがデータを送信します。</td></tr><tr><td>スナップショットまたは短いクリップを保存する</td><td>ブラウザーキャプチャでAsset Libraryに保存</td><td>保存が完了するまで、ブラウザーを開いたまま接続しておく必要があります。</td></tr></tbody></table>

## Webアプリ

「Deployments」を開き、「Cloud Streaming」を選択して、ソースを選びます。ソースに複数の実行がある場合は、確認したいWorkflowの実行を選択します。

入力プレビューにはカメラ映像が表示されます。Workflowの出力には、選択した画像出力が表示されます。JSONのみを出力するWorkflowでは、再生できる動画はありません。

「Latest Result」タブを開くと、最新の結果を確認できます。画像出力は `image_ref` エントリとして表示されます。アプリに表示されるのは最近の結果のみです。

最近の結果をJSON Lines形式でダウンロードするには、ソースのメニューから「Logs」を開き、「Download results」をクリックします。この履歴はジョブが停止または再起動すると失われます。結果を保持するには、 [Workflow sink](#send-results-with-a-workflow-sink).

<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>

## Agent

次のように [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) に依頼すると、名前を指定したカメラのライブ入力または実行中のWorkflowの出力を表示できます。これらは別々の表示です。カメラを視聴してもWorkflowは開始されません。

構造化された出力を得るには、「視聴中のWorkflowから最新の結果を表示して」と依頼します。Agentが読み取るのは、視聴中の実行の現在の結果です。すべての予測履歴を取得するわけではありません。

### 保存せずに確認する

「荷捌き場のカメラを見て、ドアが開いているか教えて」と依頼します。動きを確認する場合は、「荷捌き場のカメラの3秒間のクリップを確認して」と依頼します。

Agentは、ブラウザーの入力プレビューから1フレーム、または1～10秒（既定値は3秒）のクリップを確認します。追加で依頼すると、同じキャプチャを再利用できます。

キャプチャはブラウザー内に5分間保持され、1回の会話につき最大5件までです。ページを再読み込みすると失われます。

### スナップショットまたはクリップを保存する

一時的な確認内容を保存するには、「そのキャプチャをそのままAsset Libraryに保存して」と依頼します。有効期限が切れている場合は、明示的に新しいキャプチャを取得してください。以前の時点の映像は復元できません。

新しいメディアを取得するには、次のいずれかを依頼します。

* 「荷捌き場のカメラからスナップショットを保存して。」
* 「荷捌き場のカメラを5秒間録画して、Asset Libraryに保存して。」

スナップショットはJPEGです。録画は音声なしのMP4で、長さは1～60秒（既定値は60秒）、サイズは最大128 MiBです。画質はブラウザーが受信するものになります。

保存が完了するまで、会話を開いたまま、1つのブラウザータブで接続を維持してください。録画の「started」という応答はキャプチャが始まったことを示すもので、ファイルが作成されたことを意味しません。Background Taskの完了まで確認し、返された保存済みアイテムを [Asset Library](https://docs.roboflow.com/platform/workspaces/asset-library).

フィードが途切れたり、ブラウザーがMP4録画に対応していなかったりすると、処理が完了しないことがあります。キャプチャに失敗した場合、再試行するとその後の時点が録画されます。これらのブラウザー操作は、公開録画APIでも継続録画サービスでもありません。

## HTTP API

ワークスペースの認証情報と必要なスコープを使用します [ワークスペースの認証情報と必要なスコープ](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys)。ライブ出力を動画として視聴したり、 [ライブ結果フィード](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/live-results.md)からすべてのJSON結果を読み取ったり、選択した予測結果を [Workflow sink](#send-results-with-a-workflow-sink)を使ってアプリケーションに送信したりできます。返された再生URLやトークンは、ログ、共有リンク、ソース管理に含めないでください。再生許可を使うと、ジョブの出力にアクセスできます。

### ライブ出力を視聴する

ジョブの [開始後](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/run-a-workflow.md#http-api)、実行状態になるまで待ってから、視聴許可をリクエストします。Workflowのインターフェースから画像を生成する出力を選択してください。JSON出力は動画として再生できません。

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

視聴時間に上限を設ける場合：

1. 現在のジョブを読み取り、視聴許可をリクエストします。
2. whepUrl `whepUrl` をWHEP対応のWebRTCプレーヤーに渡し、クエリ文字列全体をそのまま保持します。組み込みプレーヤーを使う場合は、前述のとおりWebアプリで実行中のジョブを開きます。
3. 視聴中は、同じ出力選択を指定して30秒ごとに視聴リクエストを繰り返します。各リクエストにより、公開リースの期限がそのリクエストから少なくとも60秒後まで延長されます。期限の追跡には `watch.requestedUntil` を使用します。
4. executionGeneration `executionGeneration` が変わった場合、ジョブが再起動しています。新しい視聴許可をリクエストして再接続してください。
5. 視聴セッションの終了時には、プレーヤーを閉じ、視聴許可の更新を停止します。

WHEP URLはシグナリングエンドポイントです。プレーヤーは `POST` でSDPオファーを送信し、SDPアンサーを使ってWebRTC再生を確立します。ブラウザーのアドレスバーに貼り付けると `GET` が送信され、「Method Not Allowed」が返される場合がありますが、これは再生に失敗したことを意味するわけではありません。RTSP専用プレーヤーではこのURLを使用できません。

RTSPクライアントでは、視聴レスポンスに含まれている場合は `rtspsUrl` を使用し、RTSPS（TLS経由のRTSP）に対応したクライアントで接続します。値が `null` の場合、ジョブの処理セルは公開RTSPSリスナーを公開していません。その場合はWHEPまたはアプリのプレーヤーを使用してください。RTSPSでもWHEPと同様に、視聴許可を更新する必要があります。

ジョブで一度に公開できる画像出力は1つです。別の視聴者が視聴リクエストを送ると、すべての視聴者に対して選択中の出力が変更されることがあります。ジョブを共有する場合は、出力の選択を調整してください。

{% hint style="info" %}
プレーヤーを閉じても、デプロイや課金は停止しません。プレビューは最後の視聴が終了してから約2分後に停止します。処理を終了するには、 [ジョブを停止します](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/manage-and-monitor.md#stop-processing).
{% endhint %}

## Workflow sinkで結果を送信する

選択したJSON結果をHTTPSエンドポイントに送信するには、 [Webhook Sink](https://docs.roboflow.com/workflows/blocks/blocks/data-storage/webhook-sink) を追加します。これはRoboflowのクラウドで実行されるため、 `localhost` やプライベートアドレスには接続できません。

検出アラートを設定する場合：

1. 必要なクラスと信頼度のしきい値で検出結果をフィルタリングします。
2. sinkが一致する検出結果を1件以上含む場合にのみ実行されるよう、 [Continue If](https://docs.roboflow.com/workflows/blocks/blocks/logic-and-branching/continue-if) 条件を追加します。
3. メソッドを指定してWebhook Sinkを追加します： `POST`、宛先、およびフィルタリングされた結果を含むJSONペイロード。
4. 設定します `cooldown_seconds` を設定して、送信の繰り返しを制限します。まずは `fire_and_forget` を `false` に設定し、制御されたテスト中にエラーを確認できるようにします。
5. 本番環境以外の受信先でテストし、ペイロードと送信頻度を確認してから、デプロイするWorkflowで目的のシンク設定を有効にしてください。

クールダウンは再起動時にリセットされ、配信は保証されません。

その他の宛先には、 [S3 Sink](https://docs.roboflow.com/workflows/blocks/blocks/data-storage/s3-sink) と [Slack Notification](https://docs.roboflow.com/workflows/blocks/blocks/notifications/slack-notification)があります。プロセッサー上に書き込まれたファイルは、ジョブの終了時に削除されます。

有効なシンクはプレビュー中もデータを送信し、シンクはデフォルトで有効になっています。 [プレビューを昇格すると、](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/run-a-workflow.md#promotion) そのシンク設定も引き継がれます。
