다국어 오디오 트랙이 포함된 비디오 입수

비디오 개체 만들기

Video Cloud 비디오 라이브러리에서 새 비디오 객체를 만들려면 다음을POST요청하십시오.

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

최소한 동영상이 포함된 요청 본문을 포함해야 합니다name .

{
“이름”: "내 동영상 제목"
} 

추가 비디오 메타데이터 ( CMS API 참조 참조 ) 를 포함할 수도 있지만 나중에 Studio에서 또는 CMS API를 통해 추가할 수도 있습니다.

응답은 많은 비디오 속성을 포함하는 JSON 개체입니다. 첫 번째는 동영상이며id , 인제스트 요청을 하려면 이 값이 필요합니다.

비디오 인제스트

비디오 개체를 생성하고 검색한 후id , 비디오를 전송하여 Video Cloud에 비디오를 수집할 수 있습니다. POST요청:

 https://ingest.api.brightcove.com/v1/accounts/  {account_id} /videos/  {video_id} /ingest-request

요청 본문

먼저 세 개의 오디오 트랙이 포함된 비디오의 간단한 예를 살펴보겠습니다. 요청 본문은 다음과 같습니다.

{
  "master": {
    "url": "{source_url}",
    "audio_tracks": [
      {
        "language": "eng",
        "variant": "main"
      },
      {
        "language": "spa",
        "variant": "main"
      }
    ]
  },
  "profile": "multi-platform-extended-static-with-mp4"
}

이제 비디오에 여러 오디오 트랙이 포함되어 있고 별도의 파일에 있는 몇 가지 추가 오디오 트랙을 추가하는 보다 복잡한 예를 살펴보겠습니다.

{
  "주인": {
    “url”: " {소스_url}“,
    "audio_tracks": [
      {
        "언어": "eng",
        "변형": "메인"
      },
      {
        "언어": "프라",
        "변형": "메인"
      },
      {
        "언어": "스파",
        "변형": "메인"
      }
    ]
  },
  "프로필": "MP4로 확장된 멀티플랫폼",
  "audio_tracks": 
    {
      "merge_with_existing": 참,
      "마스터": [
        {
          "url": "https://some.site.com/audio/alternate-en.m4a",
          "언어": "eng",
          "변형": "대체"
        },
        {
          "url": "https://some.site.com/audio/commentary-es.m4a",
          "언어": "스파",
          "변형": "주석"
        }
    }
  ]
}

이 예에서:

• masterurl >는 소스 비디오 파일의 위치입니다.
• master >는 비디오에 포함된 오디오 트랙에 대한 정보를audio_tracks제공합니다.
• 언어 코드는 https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry 에서 가져와야 합니다.
• profile는 사용할 인제스트 프로필의 이름입니다. 이 이름을 생략하면 계정의 기본 프로필이 사용됩니다.
• 추가audio_tracks배열에는 추가 오디오 트랙으로 사용할 별도의 외부 호스팅 오디오 파일에 대한 정보가 들어 있습니다.
• merge_with_existing“내장된 오디오 트랙 외에 원격 오디오 트랙을 사용”을 의미합니다true (또는 포함된 트랙을 원격 트랙으로 교체하는 경우false ).

• variant필드는 오디오 트랙의 종류를 설명합니다. 표준 의미로 가능한 값은 다음과 같습니다.

  • main -메인 트랙, 일반적으로 비디오 파일에 다중화 된 트랙
  • alternate -대체 오디오 트랙
  • commentary -비디오 트랙에 대한 해설을 제공하는 오디오 트랙
  • dub -다른 언어로 된 더빙 버전의 음성 단어가 포함 된 트랙
  • descriptive -트랙은 어떤 방식 으로든 동영상 콘텐츠를 설명합니다.

추가 참고 사항:

• 이미지 및 텍스트 트랙 추가와 같은 수집 요청에 대한 추가(모두 선택 사항) 필드가 있습니다. 자세한 내용은 Dynamic Ingest API 참조를 참조하세요.
• 모든 비디오 자산을 한 번에 수집할 필요는 없습니다. 예를 들어 위의 예에서 오디오 트랙이 포함된 비디오를 먼저 인제스트한 다음 별도의 요청을 제출하여 추가 원격 오디오 트랙을 추가할 수 있습니다.