라이브 API: VOD 라이브 이벤트에서

이 항목에서는 이벤트가 완료된 후 라이브 스트리밍 이벤트에서 VOD (주문형 비디오)를 만드는 방법을 알아 봅니다.

서문

짧은 라이브 스트리밍 이벤트의 경우 이벤트가 완료된 후Video Cloud계정에서 이벤트 녹화를 VOD (VOD) 로 사용할 수 있도록 하는 것이 좋습니다. 라이브 작업을생성할 때 VOD에 대한 일부 구성을 추가하면 이 작업을 쉽게 수행할 수있습니다.

Fast Live to VOD를 사용하면 세그먼트 정확도로 클립을 빠르게 게시 할 수 있으며 고객에게 완전히 투명한 백엔드 프로세스는 클립 경계를 정리하고 다시 게시합니다.

그 결과 원하는 클립 경계로 자동으로 다시 게시되는 클립을 사용하여 시장 출시 시간을 단축 할 수 있습니다.

중요 :

  • 라이브 스트리밍 이벤트가 완료되면 인코더를 중지하지만하지 마라취소작업 . 작업을 취소하기 전에 VOD 클립이 생성 될 때까지 기다리십시오. 그렇지 않으면 성공적으로 생성되지 않습니다.
  • 실시간 작업 기간이 만료될 때까지 VOD 생성이 시작되지 않습니다. reconnect_time
  • 라이브 이벤트 기간이 24 시간을 초과하면 마지막 24 시간 만 VOD에 캡처됩니다.

빠른 VOD 옵션

빠른 VOD 옵션을 사용하면 라이브 이벤트의 VOD 버전을 더 빨리 얻을 수 있습니다. Fast Live to VOD는세그먼트 정확도가 높은 라이브 렌디션을 (트랜스먹스 사용)게시합니다.

고속 VOD output필드는 다음과 같습니다.

  • live_to_vod로 설정true
  • mode (빠른 VOD의 경우 필요) - 빠른 VOD의 경우 값은instant
  • playlist_label (선택 사항)-인스턴트 모드 VOD에만 적용됩니다. 라이브 작업에서 VOD 출력을 만드는 데 사용할 재생 목록을 나타냅니다. 라이브 작업 생성시 사용자 지정 재생 목록이 정의 된 경우에만 필요합니다.

구현

라이브 작업을 생성할 때

Live to VOD를 구현하는 가장 간단한 방법은 작업을 생성할 때 요청 본문에 다음 중 하나를 사용하여"live_to_vod": true필드를 포함하는 것입니다.

  • 최상위videocloud객체 (VOD를 원격 자산으로 만들기 위해)
  • 비디오 클라우드 또는 S3로 출력하는 출력 객체

전송 대상Video Cloud

새 라이브 작업을 만들 때videocloud객체가 사용되는 두 가지 방법이 있다는 점에 유의하십시오.

  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 개체는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"
    		}
    	},
      "outputs": [
        { "videocloud": {
            "video": {
                "name": "video name",
            },
            "ingest": {
                "profile": "valid-ingest-profile-name"
            }
        },
        "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL"
        }
      ]
    }

    참고: 계정에 대한 기본 수집 프로필을 사용하려면 수집 - 프로필 필드를 생략하십시오.

출력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경우 계정의 사용자 지정 또는 표준 인제스트 프로필 이름을 대체할 수 있습니다. 가지고있는 표준 프로필은 계정에서 Dynamic Delivery를 사용할 수 있는지 여부에 따라 다릅니다. 동적 전달 및 컨텍스트 인식 인코딩을 위한표준 인제스트 프로파일또는 레거시 트랜스코딩을 위한표준 인제스트 프로파일을 참조하십시오 .

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": "https://httpbin.org/post?vodStateChange"
        },
        {
          "url": "https://httpbin.org/post?vodFinished",
          "event": "output_finished"
        }
      ]
    }
  ]
}

개방형 비디오 클립으로 VOD 만들기

라이브 이벤트용 VOD를 얻는 또 다른 방법은 종료 시간이 없는 VOD 클립을 만드는 것입니다. 자세한 내용은 클리핑 문서를 참조하십시오.

제한 사항

  • VOD가 생성되기 전에 라이브 작업을중지 (취소)하면 라이브 작업이 생성되지 않습니다. 대신 인코더를 중지하여 VOD 생성을 시작하고 작업을 중지하기 전에 완료 될 때까지 기다리십시오.
  • 정적 엔트리 포인트스트림의경우에만완료 시 스트림을 보관하도록 Live to VOD를 설정할 수 없습니다.

    대안:

    • 클리핑을 사용하여 전체 라이브 이벤트를 VOD로 보관하세요. 클리핑 창은 이벤트 후 또는 SEP의 다음 활성화 (둘 중 더 짧은 기간) 까지 표준 기간 동안 사용할 수 있습니다.