> 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/to/vision-events/upload-a-vision-event-video.md).

# Vision Event ビデオをアップロード

動画クリップをワークスペースにアップロードし、Vision Event に添付すると、レビュー担当者がダッシュボードで再生できます。

## 概要

動画クリップには、次のような瞬間の前後で何が起きたかが映っています。 [Vision Event](https://docs.roboflow.com/deployment/ja/to/vision-events.md) 静止画像では捉えられないこともあります。各イベントには最大4本のクリップを添付できます。クリップはダッシュボードのイベント詳細ビューで再生されます（ [イベントの詳細を表示](https://docs.roboflow.com/deployment/ja/to/vision-events/query-events.md#view-event-details)).

動画はMP4またはMOV形式で、最大3 GBまでです。動画はプロジェクトではなくワークスペースにアップロードされます。ブラウザーで再生できるMP4ファイルはそのまま保存されます。それ以外の動画はH.264 MP4に変換されます。非常に長い動画は変換に失敗する場合があります。

[エッジデバイスのバックアップ](https://docs.roboflow.com/deployment/ja/to/vision-events/send-events.md#edge-device-backup) では、デバイス上で録画されたクリップが自動的にアップロードされます。REST API経由でイベントを送信する場合は、このページの手順に従ってください。

## HTTP API

動画の添付は、次の3つの手順で行います。

1. アップロードを準備します。 `videoId`、 `signedUrl`、および `requiredHeaders`.
2. 動画ファイルを、次の宛先に `PUT` リクエストで送信します。 `signedUrl`その際、 `requiredHeaders`に含まれるすべてのヘッダーを指定します。URLの有効期限は60分です。
3. [イベントを作成します。](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#http-api) その際、 `videoId` を `videos[].sourceId`.

イベントを作成する前に、Roboflowによる動画の処理が完了するのを待つ必要はありません。処理が完了すると、ダッシュボードでクリップを再生できるようになります。処理に失敗してもイベントは保持され、ダッシュボードには動画の処理失敗が表示されます。ファイルが送信されない場合、動画は `pending` のままとなり、ダッシュボードには処理中と表示され続けます。

必須スコープ： `vision-events:write` または `device:update` （アップロードの準備に必要）、および `vision-events:read` または `device:read` （ステータスの読み取りまたは再生URLの取得に必要）。

### アップロードを準備する

{% openapi src="/files/934e54fa9aa57656316a422a76238b867f081de5" path="/vision-events/videos/prepare-upload" method="post" %}
[openapi.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

次に、ファイルを `signedUrl`に送信します。 `requiredHeaders` の各ヘッダーをリクエストにコピーします。

```bash
curl -X PUT "SIGNED_URL" \
  -H "x-goog-content-length-range: 1,3221225472" \
  -H "x-goog-if-generation-match: 0" \
  --upload-file line-3-clip.mp4
```

PUT `の後に必要な操作はありません。`ファイルが届くと、Roboflowは動画の処理を開始します。

### 動画をイベントに添付する

イベントの `videoId` を `videos` 配列に指定して、 [Vision Eventを作成する](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#http-api) か、 [イベントを一括作成します](https://docs.roboflow.com/deployment/ja/to/vision-events/batch-create-vision-events.md).

このエンドポイントで準備した動画のみ添付できます。データセットへの動画アップロード、または別のワークスペースから取得した `videoId` はイベントに保持されますが、警告が返され、再生できません。

### アップロード状況を確認する

`status` は、 `pending` アップロードを準備した時点から、Roboflowによるファイルの処理が完了するまでの間は、 `uploaded` または `failed`になります。ファイルが届かなかった動画は、そのまま `pending`.

{% openapi src="/files/934e54fa9aa57656316a422a76238b867f081de5" path="/vision-events/videos/{videoId}" method="get" %}
[openapi.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

### 再生URLを取得する

[クエリ結果には](https://docs.roboflow.com/deployment/ja/to/vision-events/query-events.md#http-api) 各動画の `sourceId` と `label` のみが含まれます。動画を再生またはダウンロードするURLを取得するには、このエンドポイントを呼び出してください。URLの有効期間は60分で、 `null` から `status` が `uploaded`になるとURLが設定されます。このURLを持つ人は誰でも動画を再生できるため、キャッシュしたり共有したりしないでください。

{% openapi src="/files/934e54fa9aa57656316a422a76238b867f081de5" path="/vision-events/videos/{videoId}/url" method="get" %}
[openapi.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}
