라이브 API: VOD 클립 만들기

개요

클립은 라이브 스트림에서 추출한 비디오입니다. S3 버킷, FTP 사이트 또는Video Cloud계정으로 전송할 수 있습니다. 클립은 MP4 비디오로 생성되며 모든 경우에 대상으로 전송됩니다. 의Video Cloud경우 인제스트 시스템에서 MP4를 트랜스코딩하며 비디오에 어떤 종류의 렌디션이 생성되는지는 사용된 인제스트 프로필에 따라 달라집니다.

클립에 대한 정의는/vods끝점을 사용하여 생성됩니다.

클립은 여러 가지 방법으로 만들 수 있습니다.

• 라이브 스트림 이벤트의 SMPTE 타임코드 포함stream_start_timecode및/또는stream_end_timecode정의됨 - 이를 위해서는 인코더에서 타임코드 정보를 전송해야 한다는점에 유의하십시오.
• 와 함께start_time및/또는end_time시작 시간( stream_start_time ) 전체 실시간 스트림 이벤트의
• Epoch (Unix) 시간 포함start_time및/또는end_time정의 시간 (초 단위)
• 와 함께duration
• 라이브 API와 라이브 모듈 모두 암호화 또는 DRM 보호 작업에서 클립 생성을 지원합니다.

참고 사항

1. 클립을 가능한 한 빨리 사용할 수 있도록 먼저 세그먼트에 정확한 클립을 만든 다음 사용 가능한 즉시 프레임에 정확한 클립으로 교체합니다.
2. 지정한duration경우 결과 클립은 다음과 같습니다.
   • 작업이 활성 상태이고 아직 실행 중인 경우: (요청 시간 - 기간) ~ (요청 시간)
   • 작업이 완료된 경우: ( finished_at - 기간) ~ ( finished_at )
3. AND start_time를end_time모두 지정하는 경우
   • 작업이 활성 상태이고 아직 실행 중인 경우: Epoch 시간 창이 완전히 요청 시간 내에created_at있으면 클립이 만들어집니다.
   • 작업이 완료되면: Epoch 시간 창이 완전히 시간 범위 내에created_at있으면 클립이 만들어집니다. finished_at
4. SSAI를 사용하는 실시간 스트림 클립에는 광고가 포함되지 않습니다.
5. 클립은 이벤트 후 최대 7 일까지 생성 할 수 있습니다. 의 경우SEP , 다음 활성화 시점이나 7일 (둘 중 더 짧은 날짜) 까지 등록할 수 있습니다.
6. VOD API는 스트림에있는 것 이외의 콘텐츠를 추가하지 않습니다. 300 초 길이의 라이브 스트림에 350을 지정하면 출력 길이는 300 초가됩니다.
7. 라이브 스트림은 방송되는 그대로 저장되고 이벤트 종료 후 7 일 동안 즉시 사용할 수 있으므로 클리핑을 위해 DVR 지원 라이브 스트림을 사용할 필요가 없습니다.
8. Brightcove Live 클리핑은 최고 해상도 출력과 동일한 해상도의 클립 만 생성합니다. 소스 입력 해상도와 일치하지 않습니다 (최고 해상도 출력과 동일하지 않은 경우).

클립을 여러 대상으로 보낼 수도 있습니다.

• Video Cloud어카운트
• FTP 서버
• S3 버킷

클립을 지정하면 출력 ~ 해야 하다포함하다어느 하나ㅏurl목적지또는ㅏvideocloud비디오 생성 및 클립 수집을 자세히 설명하는 객체Video Cloud .

참고: 라이브 스트림이 실행되는 동안 클립을 만들수있습니다. 이렇게 하려면 클립의 시작 및 종료 시간을 Epoch 시간으로 정의하거나 실시간 스트림의시작시간을 기준으로 정의해야 합니다.

자격 증명

클립을 보내는 대상에 액세스하는 데 자격 증명이 필요한 경우 Live API의 자격 증명 작업을 사용하여 이러한 자격 증명을 만들 수 있습니다. 보다라이브 API에 대한 자격 증명 관리상세 사항은.

끝점

클립은 다음 주소로POST요청을 전송하여 생성됩니다.

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

요청 본문- Video Cloud

예 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전송합니다. 클립에 이름과 몇 개의 태그를 지정하고ingest profile재트랜스코딩에 사용할 값을 지정하지 않으므로 계정 기본값이 사용되고 트랜스코딩 중에 클립에서 썸네일과 포스터 이미지를Video Cloud캡처하도록 지시합니다.

예 2: Epoch 시간의 시작/종료 시간

요청 본문에는 Epoch 시간의 시작 및 종료 시간과 클립을 보낼 위치에 대한 세부 정보가 포함됩니다. 다음은 스트림의 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
        }
      }
    }
  ]
}

이 예시에서는 특정 Epoch 시간 (이 예에서는 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,
        "profile": "valid-ingest-profile-name"
        }
      }
    }
  ]
}

이 예시에서는 실시간 스트림이 시작된 지 5분 후부터 시작하여 길이가 1분인 클립을 만들고 있습니다.

예 4: 시작 또는 종료 시간이 없는 기간

요청 본문에는 Epoch 시간의 시작 및 종료 시간과 클립을 보낼 위치에 대한 세부 정보가 포함됩니다. 다음은 스트림의 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": ["https://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": ["https://myserver.com/api/notification_listener?type=jvod"]
  ]
}

클립 전송에 대한 일반 정보Video Cloud

video및ingest객체에 포함할 수 있는 필드를 보려면 를 참조하십시오Dynamic Ingest API Reference .

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

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