웹VTT 파일 수집

Dynamic Ingest는 비디오와 함께 WebVTT 파일 (캡션, 자막, 챕터 등)을 수집하는 데 사용하거나 비디오를 수집 한 후에 별도로 사용할 수 있습니다. Dynamic Delivery 비디오의 경우 SRT, DFXP 또는 SCC 캡션을 수집할 수도 있습니다. 이 항목에서는 Dynamic Ingest API를 사용하여 동영상에 텍스트 트랙 파일을 추가하는 방법에 대해 자세히 설명합니다.

MP4 변환에 자막 추가

HLS 및/또는 DASH 변환에 텍스트 트랙을 추가하는 것 외에도 다음을 추가할 수 있습니다. 608 자막를 포함하여 프로그레시브 MP4 변환에"embed_closed_caption": true WebVTT 수집 요청에 플래그를 지정합니다.

수집 중인 비디오에 대한 자막을 포함하려면 하나 이상의 MP4 변환이 포함된 수집 프로필을 사용해야 합니다. 기존 비디오에 텍스트 트랙/선택 캡션을 추가하는 경우 MP4 변환이 하나 이상 있는지 확인하거나 MP4를 포함할 인제스트 프로필로 다시 코드 변환하십시오.

Cloud Playout을 사용하는 경우 이제 이러한 자막을 채널로 가져와 시청자에게 제공할 수 있습니다.

참고 사항

  • 608 포함된 캡션에 대해 현재 지원되는 언어는 다음과 같습니다. 영어, 스페인어, 프랑스어, 포르투갈어, 이탈리아어, 독일어 및 네덜란드어.
  • 포함된 608 캡션의 경우 에만 유럽(라틴) 문자만 지원됩니다. 중국어 및 일본어와 같은 더블바이트 언어는 지원되지 않습니다.
  • 소스 파일에 이미 608개의 폐쇄 캡션이 포함되어 있는 경우 해당 선택 캡션은 MP4 변환에보존되지 않습니다. 대신 인제스트된 캡션의 내용을 사용하여 새 선택 캡션이 포함됩니다 .
  • 현재 자막할 수 없다비디오를 다시 트랜스코딩하는 동안 추가해야 합니다. 비디오를 수집하거나 교체해야 합니다. 재트랜스코드 작업은 향후 릴리스에서 이 기능을 지원할 예정입니다.
  • 이 기능할 수 없다있을 때 사용자동 자막 요청 .
  • 계정이 Cloud Playout에 대해 활성화된 경우 채널에 비디오를 포함하여 자막이 추가되었는지 확인할 수 있습니다(Cloud Playout 채널은 항상 MP4 변환을 사용함).

설정

비디오, 이미지, WebVTT 파일 또는 이들 모두를 수집하든 동적 수집 요청에 대한 설정은 동일합니다. 요청 본문 필드에 대한 자세한 내용은 API 참조를 참조하십시오.

요청 URL
        https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
인증
인증에는 다음으로 전달된 액세스 토큰이 필요합니다. Bearer토큰Authorization머리글: 
        Authorization: Bearer {access_token}

S3에 대한 참고 사항

WebVTT를 보호 된 S3 버킷에서 가져 오는 경우 Video Cloud가 파일에 액세스 할 수 있도록 버킷 정책을 설정해야합니다. 자세한 내용은 S3에서의 동적 인제스트사용을참조하십시오.

WebVTT 파일 수집

WebVTT 캡션을 비디오에 추가하거나 Dynamic Ingest를 사용하여 기존 비디오에 업로드 할 수도 있습니다.

비디오 수집 중에 텍스트 트랙 추가

요청 URL

        https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests

방법

POST

샘플 요청 본문

{
  "master": {
      "url": "https://support.brightcove.com/test-assets/videos/Great_Blue_Heron.mp4"
  },
  "text_tracks": [
      {
          "url": "https://support.brightcove.com/test-assets/captions/herons.vtt",
          "srclang": "en",
          "kind": "captions",
          "label": "EN",
          "default": true,
          "status" : "published",
          "embed_closed_caption": true
      }
  ]
}

SRT 또는 DFXP 추가 / 변환

동적 전송 비디오의 경우에만동일한 방식으로 SRT 또는 DFXP 파일을 인제스트할 수 있습니다. Video Cloud 수집 시스템은 자동으로 WebVTT 형식으로 변환하여 비디오에 추가합니다.

{
  "text_tracks": [
    {
      "url": "https://media.brightcove.com/captions/Water.dfxp",
      "srclang": "fr",
      "kind": "captions",
      "label": "français",
      "default": true,
      "status" : "published",
      "embed_closed_caption": true
    }
  ]
}

기존 비디오를 추적하는 텍스트 추가

기존 비디오에 텍스트 트랙을 추가하는 것은 요청 본문에 비디오 정보나 프로필이 필요하지 않다는 점을 제외하면 정확히 동일합니다. MP4 변환에 자막을 추가하도록 요청하지 않는 한 - 이 경우 비디오를 교체해야 합니다.

요청 URL

        https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests

방법

POST

샘플 요청 본문 - 요청된 자막 없음

{
  "text_tracks": [
    {
      "url": "https://some.site.com/captions/for_video/Water-in-Motion.vtt",
      "srclang": "es",
      "kind": "captions",
      "label": "Español",
      "default": true,
      "status" : "published",
      "embed_closed_caption": false
    }
  ]
}

샘플 요청 본문 - 요청된 선택 자막

{
  "master": {
      "url": "https://support.brightcove.com/test-assets/videos/Great_Blue_Heron.mp4"
  },
  "text_tracks": [
      {
          "url": "https://support.brightcove.com/test-assets/captions/herons.vtt",
          "srclang": "en",
          "kind": "captions",
          "label": "EN",
          "default": true,
          "status" : "published",
          "embed_closed_caption": true
      }
  ]
}

원격 자산 비디오에 텍스트 트랙 추가

원격 에셋 비디오에 텍스트 트랙추가를 참조하십시오 .