개요

클립은 라이브 스트림에서 추출한 비디오입니다. S3 버킷, FTP 사이트 또는Video Cloud계정. 클립은 MP4 비디오로 생성되며 모든 경우에 대상으로 전송됩니다. 의 경우Video Cloud , MP4는 인제 스트 시스템에 의해 트랜스 코딩되며 비디오에 대해 생성되는 변환 유형은 사용 된 인제 스트 프로파일에 따라 다릅니다.

클립에 대한 정의는/vods끝점.

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

• 와stream_start_timecode및 / 또는stream_end_timecode라이브 스트림 이벤트에 대한 SMPTE 타임 코드에 정의 됨- 이를 위해서는 인코더가 타임 코드 정보를 전송해야합니다.
• 와start_time및 / 또는end_time시작 시간 ( stream_start_time ) 전체 실시간 스트림 이벤트
• 와start_time및 / 또는end_time Epoch (Unix) 시간 (초)으로 정의 됨
• 와duration
• VOD API는 암호화 또는 DRM 보호 작업과 함께 사용할 수 있습니다 . 현재 라이브 모듈은 이를 지원하지 않지만 향후 릴리스에서 지원할 예정입니다.

참고 사항

1. 클립을 가능한 한 빨리 사용할 수 있도록 먼저 세그먼트에 정확한 클립을 만든 다음 사용 가능한 즉시 프레임에 정확한 클립으로 교체합니다.
2. 지정하는 경우duration , 결과 클립은 다음과 같습니다.
   • 작업이 활성 상태이고 여전히 활성 상태 인 경우 : (요청 시간-기간) ~ (요청 시간)
   • 작업이 완료된 경우 : ( finished_at -기간) ~ ( finished_at )
3. 둘 다 지정하는 경우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의 자격 증명 작업을 사용하여 이러한 자격 증명을 만들 수 있습니다. 보다 Live 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
        }
      }
    }
  ]
}

이 예에서는 라이브 스트림이 시작된 후 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": ["http://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": ["http://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": ["http://myserver.com/api/notification_listener?type=jvod"]
    }
  ],
}

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