여러 오디오 트랙 구현

소개

하나의 제목으로 여러 오디오 트랙을 연결하는 기능은 몇 가지 주요 시나리오에서 유용 할 수 있습니다.

동일한 비디오를 다른 언어로 재생하여 전 세계에 걸쳐 광범위한 도달 범위 제공
시각 장애인을위한 설명과 함께 오디오 제공

Studio에서 오디오 트랙을 추가 할 수도 있습니다. 미디어 모듈을 사용하여 비디오에 오디오 트랙 추가 자세한 내용은.

지원되는 비디오 형식

여러 오디오 트랙이 지원됩니다. HLS V4+ 및 DASH - 유무에 관계없이 DRM 보호.

견본

다음은 여러 오디오 트랙이있는 비디오의 간단한 예입니다.

설정

에 대한 설정 Dynamic Ingest 요청은 비디오, 이미지, 오디오 트랙, WebVTT 파일 또는 이들 모두 :

요청 URL

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

인증

인증을 위해서는 액세스 토큰이 Bearer 토큰 Authorization 헤더:

      Authorization: Bearer {access_token}

토큰에 액세스하려면 클라이언트 신임장 (아래 참조). 액세스 토큰을 얻는 프로세스는 다음을 참조하십시오. 액세스 토큰 가져 오기.

S3에 대한 참고 사항

소스 파일이 보호 된 S3 버킷에서 가져온다면 버킷 정책을 허용하도록 설정해야합니다 Video Cloud 파일에 액세스 할 수 있습니다. 만나다 사용 Dynamic Ingest S3 자세한 내용은.

자격증 명 얻기

를 얻으려면 client_id 및 client_secretOAuth UI로 이동하여이 앱을 등록해야합니다.

API 인증 자격 증명 관리

필요한 사용 권한은 다음과 같습니다.

를 통해 자격 증명을 얻을 수도 있습니다. CURL or Postman - 참조 :

API에서 직접 자격 증명을 얻는 경우 필요한 권한은 다음과 같습니다.

      [
        "video-cloud/video/all",
        "video-cloud/ingest-profiles/profile/read",
        "video-cloud/ingest-profiles/account/read",
        "video-cloud/upload-urls/read"
      ]

워크 플로우

다음과 같은 두 가지 기본 사용 사례가 있습니다.

여러 오디오 트랙으로 새로운 비디오를 인제 스트

새로운 비디오 워크 플로우
기존 비디오에 여러 오디오 트랙 추가

기존 비디오 워크 플로우

아래 섹션에서 API 요청에 대한 세부 정보를 살펴 보겠습니다.

오디오 트랙 메타 데이터

오디오 트랙에 첨부 된 일부 메타 데이터 필드가 있습니다.이 중 일부는 트랙을 섭취 할 때 설정되고 다른 일부는 트랙을 만들 때 설정됩니다. Video Cloud. 이 필드 중 일부는 읽기 전용이며 다른 필드는 사용자가 업데이트 할 수 있습니다. 메타 데이터 입력란은 관련 API 요청의 맥락에서 아래에 자세히 설명되어 있지만 두 개의 특정 입력란은 설명이 필요합니다. Brightcove Player 여러 오디오 트랙을 처리합니다.

`language`

그리고, language 처리 중 각 트랙에 대해 설정되는 필드는 트랙의 언어를 지정합니다. 트랙이 비디오의 말의 덩어리 인 경우 중요합니다. 이 입력란의 값은 다음과 같은 두 자리 코드입니다. en or hi. 언어 코드의 전체 목록은 Subtag 값 http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry.

`variant`

그리고, variant 필드는 오디오 트랙의 종류를 설명합니다. 표준 의미와 함께 가능한 값은 다음과 같습니다.

main - 메인 트랙, 일반적으로 비디오 파일에 다중화 된 트랙
alternate - 대체 오디오 트랙
commentary - 비디오 트랙에 주석을 제공하는 오디오 트랙
dub - 다른 언어로 더빙 된 버전의 음성 단어가 수록된 트랙
descriptive - 트랙은 어떤 방식 으로든 비디오 내용을 설명합니다.

계정 기본값

에 대한 계정 기본값을 설정할 수 있습니다. language 및 variant 어떤 오디오 트랙이 Brightcove Player (기본값은 아래 섹션에서 볼 수 있듯이 트랙 메타 데이터를 업데이트하여 재정의 할 수도 있습니다). 계정의 기본값을 설정하려면, Brightcove 지원 문의.

오디오 트랙 구입

이제 앞에서 설명한 두 가지 유스 케이스의 오디오 트랙을 처리하는 API 호출을 살펴 보겠습니다.

여러 오디오 트랙이있는 새로운 비디오

비디오 객체 만들기 (CMS API)

비디오 객체를 만들 때 비디오 메타 데이터 항목을 여러 개 추가 할 수 있지만 최소값을 추가하면됩니다. name 비디오 :
```
      {
          "name": "YOUR_VIDEO_NAME"
      }
```
위의 JSON을 (동영상 이름으로 대체 된 자리 표시 자 텍스트와 함께) 요청 본문으로 제출하십시오. POST 요청하다 https://cms.api.brightcove.com/v1/accounts/YOUR_ACCOUNT_ID/videos
응답에서 많은 비디오 메타 데이터를 얻을 수 있지만 중요한 부분은 id (동영상 ID)가 필요하며 다음 단계에 필요합니다.

비디오 및 오디오 트랙 입력

다음으로 우리는 비디오 및 오디오 트랙을 섭취합니다 (이미지 및 텍스트 트랙 같은 다른 애셋을 추가 할 수 있지만 여기서 간단하게 유지할 것입니다). 조금 혼란스러운 점은 audio_tracks 요청 본문에 대해 JSON에 두 번 나타납니다.

An audio_tracks ~ 내의 개체 master 개체에는 비디오 파일에 포함 된 오디오 트랙에 대한 메타 데이터가 포함됩니다 (오디오 파일에 포함 된 경우라고도 함). 오디오 트랙은 이미 포함되어 있으므로 오디오 파일에 대한 URL이없는 메타 데이터 만 포함됩니다. 비디오 파일
최상위 레벨 audio_tracks 다른 오디오 트랙을 설명하는 개체 - 오디오 파일의 URL과 기타 메타 데이터를 포함합니다.

요청 본문에 전송 될 JSON 데이터는 다음과 같습니다.

      {
        "master": {
            "url": "https://learning-services-media.brightcove.com/videos/Great_Blue_Heron.mp4",
            "audio_tracks": [
                {
                    "language": "en",
                    "variant": "main"
                }
            ]
        },
        "audio_tracks": {
            "merge_with_existing": true,
            "masters": [
                {
                    "url": "http://learning-services-media.brightcove.com/audio/celtic_lullaby.m4a",
                    "language": "en",
                    "variant": "alternate"
                },
                {
                    "url": "http://learning-services-media.brightcove.com/audio/audio1.m4a",
                    "language": "en",
                    "variant": "commentary"
                }
            ]
        },
          "profile": "BoltIngestProfile",
          "capture-images": true,
          "callbacks": [
              "http://solutions.brightcove.com/bcls/di-api/di-callbacks.php"
          ]
      }

위의 JSON을 보내고 자리 표시 자의 URL을 대체하고 language 및 variant 값 POST 요청하다 https://ingest.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/ID/ingest-requests ( ID 다음은 비디오 객체를 생성하라는 요청에서 반환 된 비디오 ID입니다.)

기존 비디오에 오디오 트랙 추가

추가 오디오 트랙을 기존 비디오에 추가하려면 절차는 동일합니다. 단, 오디오 트랙에 대한 요청을하지 않아도됩니다. CMS API 이미 있기 때문에 비디오를 만들 수 있습니다. 그리고 요청에 Dynamic Ingest API를 사용하면 동영상 파일 또는 동영상 파일의 URL을 포함 할 필요가 없습니다. audio_tracks 아래에 master 오디오에 다중화 된 메타 데이터를 제공합니다. 그러나 기존 비디오에 오디오 트랙에 다중화 된 메타 데이터를 포함하려고합니다. 따라서 인제 스트 요청에 대한 JSON은 다음과 같습니다.

      {
        "audio_tracks": {
            "merge_with_existing": true,
            "masters": [
                {
                    "url": "http://learning-services-media.brightcove.com/audio/celtic_lullaby.m4a",
                    "language": "en",
                    "variant": "alternate"
                },
                {
                    "url": "http://learning-services-media.brightcove.com/audio/audio1.m4a",
                    "language": "en",
                    "variant": "commentary"
                }
            ]
        },
          "profile": "BoltIngestProfile",
          "capture-images": true,
          "callbacks": [
              "http://solutions.brightcove.com/bcls/di-api/di-callbacks.php"
          ]
      }

섭취를위한 오디오 트랙 필드

오디오 트랙 필드
분야	거래증명방식	설명
`master.audio_tracks`	목적[]	오디오에서 다중화 된 메타 데이터
`master.audio_tracks.language`	끈	에있는 하위 태그의 오디오에 다중화 된 언어 코드 http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
`master.audio_tracks.variant`	끈	오디오 트랙의 종류 : `main`\|`alternate`\|`dub`\|`commentary`\|`descriptive` (`main` 일반적으로 오디오에 혼합되어 사용됩니다)
`audio_tracks`	목적	추가 오디오 트랙에 대한 정보
`audio_tracks.merge_with_existing`	부울	이러한 트랙을 기존 트랙에 병합할지 아니면 대체할지 여부
`audio_tracks.masters`	목적[]	개별 오디오 트랙 정보
`audio_tracks.masters.url`	끈	오디오 트랙 파일의 URL
`audio_tracks.masters.language`	끈	에있는 하위 태그의 오디오 트랙에 대한 언어 코드 http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
`audio_tracks.masters.variant`	끈	오디오 트랙의 종류 : `main`\|`alternate`\|`dub`\|`commentary`\|`descriptive` (`main` 일반적으로 오디오에 혼합되어 사용됩니다)

알림

하나 이상을 지정하면 콜백 URL (위의 인제 스트 요청에 대한 샘플 JSON 에서처럼) Video Cloud 귀하가 수집 한 각 오디오 트랙에 대한 알림을 보냅니다. 알림은 다음과 같습니다.

      {
        "entity": "default/audio128",
        "entityType": "DYNAMIC_RENDITION",
        "version": "1",
        "action": "CREATE",
        "jobId": "0f703adb-0f17-4a35-8395-21c7fcdd2649",
        "videoId": "5298468208001",
        "dynamicRenditionId": "default/audio128",
        "accountId": "1910141565001",
        "status": "SUCCESS",
        "language" : "en",
        "variant" : "alternate"
      }

오디오 트랙에 대한 알림을 확인하려면 language 및 variant 필드에 표시됩니다. 그만큼 "action": "CREATE" 및 "status": "SUCCESS" 필드는 트랙이 성공적으로 섭취되었음을 나타냅니다.

오디오 트랙 관리

오디오 트랙을 입수 한 후에는 CMS API.

비디오에 대한 모든 오디오 트랙 메타 데이터 가져 오기

비디오와 관련된 모든 오디오 트랙의 메타 데이터를 검색하려면 GET 요청 :

      https://cms.api.brightcove.com/v1/accounts/account_id/videos/video id/audio_tracks

응답은 각 오디오 트랙에 대한 메타 데이터가 포함 된 객체 배열입니다. 자세한 내용은 아래의 응답 필드 테이블을 참조하십시오.

      [
        {
          "id": "en_alternate",
          "language": "en",
          "variant": "alternate",
          "duration": 86100,
          "encoding_rates": [
            64000,
            96000,
            127000
          ]
        },
        {
          "id": "en_commentary",
          "language": "en",
          "variant": "commentary",
          "duration": 34203,
          "encoding_rates": [
            10000,
            13000,
            15000
          ]
        },
        {
          "id": "en_main",
          "language": "en",
          "variant": "main",
          "duration": 31488,
          "encoding_rates": [
            62000,
            94000,
            125000
          ]
        }
      ]

미디어 모듈에서 비디오를보고 Studio에서이 정보를 볼 수도 있습니다.

하나의 오디오 트랙에 대한 메타 데이터 가져 오기

비디오와 관련된 하나의 오디오 트랙에 대한 메타 데이터를 검색하려면 GET 요청 :

      https://cms.api.brightcove.com/v1/accounts/account_id/videos/video id/audio_tracks/audio_track_id

응답은 각 오디오 트랙에 대한 메타 데이터가 포함 된 객체입니다. 자세한 내용은 아래의 응답 필드 테이블을 참조하십시오.

오디오 트랙 메타 데이터 업데이트

오디오 트랙에 대한 쓰기 가능한 메타 데이터 필드를 업데이트하려면 PATCH 요청 :

      https://cms.api.brightcove.com/v1/accounts/account_id/videos/video id/audio_tracks/audio_track_id

요청 본문에 수정할 필드를 포함하십시오. 예를 들면 다음과 같습니다.

      {
          "language": "es",
          "is_default": true
      }

오디오 트랙 삭제

오디오 트랙을 삭제하려면 DELETE 요청을 다음으로 보냅니다.

      https://cms.api.brightcove.com/v1/accounts/account_id/videos/video id/audio_tracks/audio_track_id

삭제 프로세스는 비동기 적이며 즉시 완료되지 않을 수 있기 때문에 성공 응답 코드는 202 (내용 없음) 대신 204 (허용) 일 수 있습니다.

오디오 트랙 메타 데이터 필드
분야	거래증명방식	읽기 전용	설명
`id`	끈	예	이드는 다음과 같이 형성된 트랙을 위해 language_variant -이 값이 변경되면 ID가 변경 될 수 있습니다.
`language`	끈	아니	에있는 하위 태그의 오디오 트랙에 대한 언어 코드 http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
`variant`	끈	아니	오디오 트랙의 종류 : `main`\|`alternate`\|`dub`\|`commentary`\|`descriptive` (`main` 일반적으로 오디오에 혼합되어 사용됩니다)
`duration`	번호	예	밀리 초 단위의 트랙 길이
`encoding_rates`	번호[]	예	이 트랙의 사용 가능한 인코딩 목록 (bps)
`is_default`	부울	아니	true이면 재생을위한 기본 트랙이 사용됩니다 (계정 수준 기본값을 재정의 함).

재생

Brightcove 웹 및 SDK 방법에 대한 정보 player여러 오디오 트랙을 처리합니다.

알려진 문제

오디오 마스터가 저장되지 않음

Video Cloud 의지 지원 오디오 마스터 저장
비디오 마스터에서 비디오를 다시 트랜스 코딩하면 추가 오디오 트랙이 손실되므로이 오디오 트랙을 사용하여 다시 추가해야합니다. 기존 비디오에 오디오 트랙 추가 위에서 설명한 방법

오디오 전용 파일을 사용해야합니다.

오디오 트랙은 비디오 트랙이없는 오디오 전용 파일이어야합니다.

HLSv3, HLS 동일한 세그먼트의 오디오 및 비디오 포함

재생 API가 반환되지 않습니다. HLSv3 명단
All HLS 매니페스트에는 de-muxed 비디오 / 오디오가 포함됩니다.

부드러운 스트리밍

Smooth Streaming URL은 사용할 수 없습니다.

Social 분포

배포 할 오디오 트랙을 선택할 수 없습니다. 비디오 소스에 포함 된 트랙 (오디오에 다중화 된 트랙)이 항상 사용됩니다.

스튜디오

Studio에서 오디오 트랙에 대한 정보를 표시합니다.
Studio를 사용하여 오디오 트랙을 추가하려면 다중 오디오 트랙

하나의 "기본"트랙 이상으로 오디오 트랙 순서 지정

기본 오디오 트랙을 선택할 수 있습니다. CMS API 제목을 설정하여 is_default ~에 필드 true
지원에 의해 설정할 수있는 계정 기본값이 있습니다.
이것은 HLS 매니페스트의 "기본"트랙에만 영향을 미칩니다.
다른 주문은 불가능합니다.

단일 소스에서 하나 이상의 오디오 트랙 가져 오기

우리는 지원 하나의 오디오 트랙은 ".master", 각 소스에 대해 하나씩 ".audio_tracks.masters".

오디오 만 포함 된 비디오의 DRM 보호

비디오 트랙이 추가 되 자마자 DRM 보호가 활성화됩니다.

최종 사용자에게 친숙한 라벨

오디오 트랙에 대한 사용자 지정 레이블을 지원하지 않습니다. 필요한 경우 클라이언트 측에서 다음을 통해 변경해야합니다. Player API.

경우에 따라 트랙을 전환하면 Brightcove Player 불안정 해지다

모든 오디오 세그먼트를 다운로드하기 전에 트랙 전환
Silverlight 플러그인 (10 미만의 IE 버전 또는 Window 버전이 8 미만인 모든 버전의 IE에서)을 사용하여 비디오를 재생할 때 - 여러 오디오 트랙은 지원 Silverlight에서 지원됩니다.
오디오와 비디오의 길이가 다른 경우 player 더 짧은 것이 다 떨어질 때마다 중지됩니다.

비디오 "duration"

비디오 duration 카탈로그 /Playback API 오디오 트랙의 길이가 다른 경우 올바르지 않을 수 있습니다.