지원 지원 문의 | 시스템 상태 시스템 상태

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

이 항목에서는이 항목을 사용하는 방법을 CMS API 캡션이나 챕터 용 WebVTT 텍스트 트랙을 비디오에 추가 할 수 있습니다.

소개

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

  • 가져올 텍스트 트랙 Video Cloud동영상을 가져 오는 동적 인게이트 요청에 트랙을 포함시킬 수 있습니다. WebVTT 파일 가져 오기 자세한 내용은.
  • 텍스트 트랙이 일부 원격 위치에서 호스팅되는 경우에는 텍스트 트랙을 사용하여 비디오에 추가 할 수 있습니다. PATCH 동영상 메타 데이터 업데이트를 요청합니다. 자세한 내용은 CMS API 샘플 : 비디오 업데이트 업데이트 요청의 예입니다.

텍스트 트랙을 수집하거나 원격으로 처리 할 때 PATCH 텍스트 트랙과 관련된 메타 데이터를 업데이트하라는 요청 (예 : scrlang or label, 또는 텍스트 트랙이 default 동영상 용).

노트

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

원격 또는 섭취

권한 부여

에 대한 요청 CMS API 액세스 토큰을 포함하는 인증 헤더가 필요합니다. 클라이언트 자격 증명을 얻고 액세스 토큰을 검색하는 데 사용하는 방법에 대한 자세한 내용은 Brightcove OAuth 개요.

비디오 메타 데이터를 업데이트하는 데 필요한 작업은 다음과 같습니다. video-cloud/video/update or 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. 를 통해 기존 텍스트 트랙을 제거하십시오. CMS API 업데이트 (패치) :

    API 요청 (PATCH)

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

    본문 요청

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

    API 요청 (PATCH)

        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- 요청

    본문 요청

        {
            "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

12 년 2020 월 XNUMX 일에 마지막으로 업데이트 된 페이지