ライブAPI：VODクリップの作成

概要

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

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

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

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

注

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

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

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

クリップを指定すると、出力しなければならない含むまた NS url行き先また NS videocloudビデオの作成とクリップの取り込みを詳細に説明するオブジェクトビデオクラウド。

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

認証情報

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

終点

クリップは、POST次の宛てにリクエストを送信することによって作成されます。

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

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

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

リクエスト本文には、開始時刻と終了時刻、およびクリップを送信する場所の詳細が含まれます。これは、ストリームの3分の1分のクリップを作成し、それをに送信するサンプルリクエスト本文です。ビデオクラウドアカウント：

{
  "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分間のクリップを作成し、に送信しています。ビデオクラウド。クリップに名前といくつかのタグを付けていますが、取り込みプロファイルアカウントのデフォルトが使用されるように再トランスコーディングし、指示しますビデオクラウドトランスコーディング中にクリップからサムネイルとポスターの画像をキャプチャします。

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

リクエスト本文には、開始時刻と終了時刻をエポック時間で表し、クリップを送信する場所の詳細が含まれます。これは、ストリームの3分の1分のクリップを作成し、それをに送信するサンプルリクエスト本文です。ビデオクラウドアカウント：

{
  "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分の1分のクリップを作成し、それをに送信するサンプルリクエスト本文です。ビデオクラウドアカウント：

{
  "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分の1分のクリップを作成し、それをに送信するサンプルリクエスト本文です。ビデオクラウドアカウント：

{
  "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分のクリップを作成し、それをに送信するサンプルリクエスト本文です。ビデオクラウドアカウント：

{
  "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とingestオブジェクト、を参照してくださいDynamic Ingest 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"
}