実装実装

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

Live to VOD を実装する最も簡単な方法は、ジョブを作成するときに、"live_to_vod": trueリクエスト本文にフィールドを含めることです。

• videocloud最上位オブジェクト (VOD をリモートアセットとして作成するため)
• Video Cloud または S3 に出力する出力オブジェクト

ビデオクラウドに送信

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

1. videocloudジョブレベルのフィールドに含めれば、Video Cloud アカウントに動画が作成され、ライブが配信されますリモートアセットとしてストリーミングし、Video Cloud ライブラリに 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 の次のアクティブ化 (どちらか短い方) まで、標準期間使用できます。