지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    WebVTT 캡션 추가 (텍스트 트랙)

    이 항목에서는CMS API비디오에 캡션 또는 챕터 용 WebVTT 텍스트 트랙을 추가합니다.

    서문

    WebVTT 캡션 (텍스트 트랙)은 POST 요청을 사용하여 비디오를 처음 만들 때 추가 할 수 없습니다.

    • Video Cloud에서 텍스트 트랙을 수집하려면 트랙을 Dynamic Ingest 요청에 포함하여 비디오를 수집 할 수 있습니다. WebVTT 파일 수집자세한 내용은.
    • 텍스트 트랙이 일부 원격 위치에서 호스팅 될 예정이면 다음을 사용하여 비디오에 추가 할 수 있습니다. PATCH비디오 메타 데이터 업데이트를 요청합니다. 참조 CMS API 샘플 : 비디오 업데이트업데이트 요청의 예입니다.

    텍스트 트랙이 수집되었는지 원격인지에 관계없이PATCH텍스트 트랙과 관련된 메타 데이터 업데이트 요청 (예 : scrlang또는label , 또는 텍스트 트랙이default비디오).

    참고

    • Dynamic Delivery 비디오에서 텍스트 트랙을 업데이트하면 프로세스가 비동기식이므로 응답 상태 코드는202 ACCEPTED , 업데이트가 즉시 발생하지 않습니다.
    • 동영상 당 텍스트 트랙은 1000 개로 제한됩니다.
    • 캡션의 텍스트는 일본어 및 한국어와 같은 2 바이트 언어로 올바르게 표시되도록 UTF-8로 인코딩되어야합니다.

    원격 또는 수집

    권한

    에 대한 요청은 액세스 토큰이 포함 된 인증 헤더가CMS API필요합니다. 클라이언트 자격 증명을 획득하고 이를 사용하여 액세스 토큰을 검색하는 방법에 대한 자세한 내용은브라이트코브 OAuth 개요를참조하십시오.

    비디오 메타 데이터를 업데이트하는 데 필요한 작업은 다음과 같습니다. video-cloud/video/update또는video-cloud/video/all .

    구문

    요청

                  https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_ID}

    요청 본문:

    요청 본문은 텍스트 트랙 배열이 포함 된 JSON 객체입니다.

        {"text_tracks" : [ {
          "src" : "http://learning-services-media.brightcove.com/captions/bc_smart_ja.vtt",
          "srclang" : "ja",
          "label" : "日本人",
          "kind" : "captions",
          "mime_type" : null,
          "default" : false
        }, {
          "src" : "http://learning-services-media.brightcove.com/captions/bc_smart_es.vtt",
          "srclang" : "es",
          "label" : "español",
          "kind" : "captions",
          "mime_type" : null,
          "default" : false
        }, {
          "src" : "http://learning-services-media.brightcove.com/captions/bc_smart_de.vtt",
          "srclang" : "de",
          "label" : "Deutsch",
          "kind" : "captions",
          "mime_type" : null,
          "default" : false
        }, {
          "src" : "http://learning-services-media.brightcove.com/captions/bc_smart_fr.vtt",
          "srclang" : "fr",
          "label" : "français",
          "kind" : "captions",
          "mime_type" : null,
          "default" : false
        }, {
          "src" : "http://learning-services-media.brightcove.com/captions/bc_smart.vtt",
          "srclang" : "en",
          "label" : "English",
          "kind" : "captions",
          "mime_type" : null,
          "default" : true
        }
        ]}

    텍스트 트랙 교체

    기존 텍스트 트랙 (업로드 또는 원격)을 교체하는 것은 두 단계로 이루어집니다.

    1. a를 통해 기존 텍스트 트랙을 제거CMS API업데이트 (PATCH) :

      API 요청 (패치)

          https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id

      요청 본문

          {
                "text_tracks": []
            }
    2. 원격 텍스트 트랙을 추가하는 경우 다른 트랙을 통해 추가하십시오. CMS API업데이트 (PATCH) (선택 사항-텍스트 트랙을 업로드하는 경우 다음 단계로 건너 뛰기) :

      API 요청 (패치)

          https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id

      요청 본문

          {
              "text_tracks": [
                  {
                    "src": "https://learning-services-media.brightcove.com/vtt/sample.vtt",
                    "srclang": "en",
                    "label": "EN",
                    "kind": "captions",
                    "mime_type": "text/webvtt"
                  },
                  {
                    "src": "https://learning-services-media.brightcove.com/vtt/sample-es.vtt",
                    "srclang": "es",
                    "label": "ES",
                    "kind": "captions",
                    "mime_type": "text/webvtt"
                  }
              ]
          }
    3. 대신 새 텍스트 트랙을 업로드하는 경우 POST 요청을 통해 Dynamic Ingest API에 추가합니다.

      API 요청 (POST)

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

      요청 본문

          {
              "text_tracks": [
                  {
                      "url": "http://solutions.brightcove.com/bcls/assets/vtt/sample.vtt",
                      "srclang": "en",
                      "kind": "captions",
                      "label": "EN",
                      "default": true
                  },
                  {
                      "url": "http://solutions.brightcove.com/bcls/assets/vtt/sample-ar.vtt",
                      "srclang": "ar",
                      "kind": "captions",
                      "label": "AR",
                      "default": false
                  }
              ]
          }
    4. GET 요청을CMS API새 텍스트 트랙이 비디오와 연결되어 있는지 확인하려면 :
                    https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id