概要

クリップは、ライブストリームから抽出された動画です。S3 バケット、FTP サイト、または Video Cloudアカウントに送信できます。クリップはMP4ビデオとして作成され、それはすべてのケースで宛先に送信されるものです。Video Cloud の場合、MP4 は取り込みシステムによってトランスコードされ、ビデオに対して作成されるレンディションの種類は、使用するインジェストプロファイルによって異なります。

クリップの定義は、/vodsエンドポイントを使用して作成されます。

クリップはいくつかの方法で作成できます。

• ライブストリームイベントの SMPTE タイムコードで、stream_start_timecodestream_end_timecodeおよび/または定義されている- これにはエンコーダが必要であることに注意してくださいタイムコード情報を送信する
• start_timeend_time開始時刻を基準に定義されたおよび/または定義 ( stream_start_time )ライブストリームイベント全体の
• エポック (Unix) 時間 (秒) start_timeend_timeで定義されたおよび/または定義
• でduration
• VOD API できると一緒に使用する暗号化またはDRM保護仕事。現在、Live Module はこれをサポートしていませんが、将来のリリースでは予定です。

備考

1. クリップをできるだけ早く使用できるようにするには、セグメント精度が高いクリップを最初に作成してから、使用可能な次第、フレーム精度のクリップに置き換えます。
2. を指定した場合duration、作成されるクリップは次のようになります。
   • ジョブがアクティブでまだ稼働している場合：（リクエスト時間-期間）～（リクエスト時間）
   • ジョブが終了した場合:( finished_at -duration) から ( finished_at )
3. [and] start_timeの両方を指定した場合end_time :
   • ジョブがアクティブでまだ生きている場合: created_atエポックタイムウィンドウが完全にリクエスト時間内に収まる限り、クリップが作成されます。
   • ジョブが終了した場合: created_atエポックタイムウィンドウが完全におよび内にある限りfinished_at、クリップが作成されます。
4. SSAI を使用したライブストリームのクリップには、広告は含まれません。
5. クリップは、イベントの 7 日後まで作成できます。SEP では、次のアクティベーションまで、または 7 日（どちらか短い方）まで作成できます。
6. VOD API は、ストリーム内に存在するコンテンツ以外のコンテンツを追加しません。300 秒の長さのライブストリームで 350 を指定すると、出力の長さは 300 秒になります。
7. ライブストリームはブロードキャストされた状態で保存され、イベント終了後の 7 日間すぐに利用できるため、クリッピング機能に DVR 対応のライブストリームを使用する必要はありません。
8. Brightcove Live クリッピングでは、最高解像度の出力と同じ解像度のクリップしか生成されません。ソース入力解像度とは一致しません（最高解像度の出力と同じでない限り）。

クリップを複数の宛先に送信することもできます。

• ビデオクラウドアカウント
• FTPサーバ
• S3 バケット

クリップを指定する場合、url出力にはデスティネーションまたは Video Cloud videocloudでのビデオの作成とクリップの取り込みを詳しく説明するオブジェクトです。

注: ライブストリームの実行中にクリップを作成できます。これを行うには、クリップの開始時間と終了時間をエポック時間、またはライブストリームの開始時刻を基準にして定義する必要があります。

認証情報

クリップの送信先でアクセスする認証情報が必要な場合は、Live API の認証情報操作を使用して認証情報を作成できます。詳細については、ライブ API の認証情報の管理を参照してください。

終点

クリップは、POST次の宛先にリクエストを送信して作成されます。

https://api.bcovlive.io/v1/vods

リクエスト本文- ビデオクラウド

例 1: ストリーム開始を基準とした開始/終了時間

リクエスト本文には、開始時刻と終了時刻、およびクリップを送信する場所の詳細が含まれます。ストリームの 3 分目のクリップを作成し、 Video Cloudアカウントに送信するサンプルリクエスト本文を次に示します。

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs by stream from min 2 to min 3",
      "stream_start_time": 120,
      "stream_end_time": 180,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
          "ingest": {
            "capture-images": true
        }
      }
    }
  ]
}

この例では、1 分のデュレーションのクリップを作成し、 Video Cloudに送信しています。アカウントのデフォルトが使用されるように、再トランスコーディングの取り込みプロファイルを指定せずに、クリップに名前といくつかのタグを付けて、 Video Cloudにサムネイルをキャプチャするように指示しています。トランスコーディング中のクリップからのポスター画像。

例 2: エポック時間での開始/終了時間

リクエスト本文には、開始時刻と終了時刻をエポック時間で表し、クリップを送信する場所の詳細が含まれます。ストリームの 3 分目のクリップを作成し、 Video Cloudアカウントに送信するサンプルリクエスト本文を次に示します。

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
    "outputs":[
      {
        "label": "60 secs - epoch time",
        "start_time": 1516652694,
        "end_time": 1516652754,
        "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
        "videocloud": {
          "video": {
          "name": "One Minute Clip",
          "tags": ["live", "clip"]
          },
            "ingest": {
            "capture-images": true
        }
      }
    }
  ]
}

この例では、特定のエポック時間（この例では 2018 年 1 月 22 日 08:24:54 GMT）に 1 分のデュレーションのクリップを作成します。

例 3: ストリームの開始を基準とした開始時間を持つ期間

リクエスト本文には、デュレーションと stream_start_time、およびクリップを送信する場所の詳細が含まれます。ストリームの 3 分目のクリップを作成し、 Video Cloudアカウントに送信するサンプルリクエスト本文を次に示します。

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs from start time",
      "stream_start_time": 300,
      "duration": 60,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
        "ingest": {
        "capture-images": true
        }
      }
    }
  ]
}

この例では、ライブストリームの開始から 5 分後に開始する 1 分間のクリップを作成します。

例 4: 開始時間または終了時間がない期間

リクエスト本文には、開始時刻と終了時刻をエポック時間で表し、クリップを送信する場所の詳細が含まれます。ストリームの 3 分目のクリップを作成し、 Video Cloudアカウントに送信するサンプルリクエスト本文を次に示します。

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs - duration",
      "duration": 60,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
        "ingest": {
          "capture-images": true
        }
      },
      "notifications": ["http://myserver.com/api/notification_listener?type=jvod"]
    }
  ]
}

この例では、1 分のデュレーションのクリップを作成します。開始時間や終了時間を指定していないため、クリップはライブストリームの最後の 60 秒から取得されます。

例 5: stream_start_timecodeおよびを使用するstream_end_timecode

リクエスト本文には、HH: MM: SS: FF タイムコードの開始時間と終了時間/フレーム、およびクリップを送信する場所の詳細が含まれます。タイムコードを使用するには、エンコーダがタイムコードを送信している必要があります。ストリームの 50 分のクリップを作成し、 Video Cloudアカウントに送信するリクエスト本文の例を次に示します。

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "Clipping using Timecode from-01:10:18:15 to-01:11:08:15",
      "stream_start_timecode": "01:10:18:15",
      "stream_end_timecode": "01:11:08:15",
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
          "name": "Fifty Minute Clip",
          "tags": ["live", "clip"]
        },
        "ingest": {
        "capture-images": true
        }
      }
    },
    "notifications": ["http://myserver.com/api/notification_listener?type=jvod"]
  ]
}

Video Cloud へのクリップ送信に関する一般情報

videoingestおよびオブジェクトに含めることができるフィールドについては、動的取り込みを参照してください。APIリファレンス。

{
  "live_job_id":"",
  "outputs":[
    {
      "label": "last_30",
      "duration": 30,
      "url": "s3://YOUR_BUCKET_NAME/file_name.mp4",
      "credentials": "s3-credentials",
      "notifications": ["http://myserver.com/api/notification_listener?type=jvod"]
    }
  ],
}

{
  "vod_jobs": [
    {
      "jvod_id": "9582606c50d84be5ad4bc104f2aa3360",
      "label": "last 60 secs of live job"
    }
  ],
  "live_job_id": "88ba5d87b61a4ef3a6dddabd0c38d319"
}