ライブAPI：ライブイベントのVOD

実装

ライブジョブを作成するとき

ライブをVODに実装する最も簡単な方法は、"live_to_vod": trueジョブを作成するときのリクエスト本文のフィールドは、次のいずれかです。

• トップレベルvideocloudオブジェクト（VODをリモートアセットとして作成するため）
• VideoCloudまたはS3に出力する出力オブジェクト

に送るビデオクラウド

videocloud新しいライブジョブを作成するときにオブジェクトを使用する方法は 2 つあります。

1. 含むvideocloudの中にジョブレベルのフィールドでビデオを作成しますビデオクラウドライブストリームをリモートアセットとして取得し、VideoCloudライブラリにVODを作成するアカウント：

   {
       "live_stream": true,
       "region": "us-west-2",
       "reconnect_time": 2400,
       "live_dvr_sliding_window_duration": 30,
       
         "videocloud": {
           "video": {
             "name": "test_live_stream"
           },
           "live_to_vod": true
           }
       

2. 含んでいるvideocloudプロパティ内のオブジェクトoutputsクリップまたは完全なVODオブジェクトは、ビデオクラウドクリップのビデオ-クリップはに取り込まれますビデオクラウドそしてVODライブラリの一部になります：

   {
     "live_stream": true,
     "region": "us-west-2",
     "reconnect_time": 2400,
     "live_dvr_sliding_window_duration": 30,
   	"videocloud": {
   		"video": {
   			"name": "test_live_stream"
   		}
   	},
     "outputs": [
       { "videocloud": {
           "video": {
               "name": "video name",
           },
           "ingest": {
               "profile": "valid-ingest-profile-name"
           }
       },
       "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL"
       }
     ]
   }

   注：アカウントのデフォルトの取り込みプロファイルを使用するには、ingest--profileフィールドを省略します。

を含めることもできますvideocloud出力オブジェクト内のオブジェクト（この場合、必要はありません）live_to_vod分野）：

{
  "live_stream": true,
  "region": "us-west-2",
  "reconnect_time": 600,
  "ad_insertion": false,
  "outputs": [
    { OTHER_JOB_OUTPUT_OBJECT },
    { OTHER_JOB_OUTPUT_OBJECT_2 },
    { "videocloud": {
        "video": {
            "name": "video name",
            "description": "video description",
            "long_description": "long description",
            "tags": [
            "tag1", "tag2"
            ],
            "schedule":
            { "starts_at": "2017-01-01T12:00:00-04:00", "ends_at": "2099-01-01T12:00:00-04:00" }
            ,
            "custom_fields": {
                "someCustomField": "value"
            },

        },
        "ingest": {
            "profile": "valid-ingest-profile-name"
        }
    },
    "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL"
    } 
  ]
}

ビデオメタデータには、CMS API の [ ビデオの作成 ] 操作にリストされたフィールドを含めることができます。

取り込みプロファイルは、VOD 用に作成されるレンディションを定義します。ではvalid-ingest-profile-name、アカウントのカスタムまたは標準取り込みプロファイルの名前に置き換えることができます。どの標準プロファイルを持っているかは、アカウントが動的配信が有効になっているかどうかによって異なります。ダイナミック配信およびコンテキスト認識エンコーディングの標準インジェストプロファイル、またはレガシートランスコーディングの標準インジェストプロファイルを参照してください。

S3 に送信

イベントの VOD バージョンを S3 バケットに保存するには、強調表示された出力のバージョンを以下に含めます。

{
  "live_stream": true,
  "region": "us-west-2",
  "reconnect_time": 600,
  "ad_insertion": false,
  "outputs": [
    { OTHER_JOB_OUTPUT_OBJECT },
    { OTHER_JOB_OUTPUT_OBJECT_2 },
    {
      "url":"s3://YOUR_BUCKET/path/filename.mp4",
      "credentials": "YOUR_CREDENTIAL_LABEL",
      "notifications": [
        {
          "url": "http://httpbin.org/post?vodStateChange"
        },
        {
          "url": "http://httpbin.org/post?vodFinished",
          "event": "output_finished"
        }
      ]
    }
  ]
}

オープンエンドのビデオクリップとしてVODを作成する

ライブイベントのVODを取得する別の方法は、 VODクリップを作成する終了時間なし。詳細については、クリッピングドキュメントを参照してください。

制約事項

• VOD が作成される前にライブジョブを停止 (キャンセル) した場合、そのジョブは作成されません。代わりに、エンコーダを停止して VOD の作成を開始し、ジョブを停止する前にその終了を待ってください。
• 静的エントリポイントストリームのみの場合、Live to VODは、完了時にストリームをアーカイブするように設定できません。

  選択肢:

  • クリップを使用して、ライブイベント全体を VOD としてアーカイブします。クリッピングのウィンドウは、イベントの後、または SEP の次のアクティブ化 (どちらか短い方) まで、標準期間使用できます。