Media Services Tracks API

  • 아티클

Media Services 로고 v3

경고

Azure Media Services는 2024년 6월 30일에 사용 중지됩니다. 자세한 내용은 AMS 사용 중지 가이드를 참조하세요.

Media Services 자산에는 연결된 Azure Storage 계정의 미디어 파일이 포함됩니다. 이러한 파일에는 오디오, 비디오 및 텍스트 트랙에 대한 데이터가 포함됩니다. 트랙 API를 사용하면 자산에 있는 트랙을 이해하고 관리할 수 있습니다. 트랙은 DASH 또는 HLS 비디오 플레이어가 오디오, 비디오 및 자막 또는 캡션(텍스트)을 청중에게 제공하는 데 사용됩니다. Media Services 스트리밍 엔드포인트는 요청 시 DASH 매니페스트 또는 HLS 재생 목록을 통해 트랙에 대한 정보를 플레이어에게 전달합니다.

Tracks API를 사용하면 다음을 수행할 수 있습니다.

  • 자산의 오디오, 비디오 및 텍스트 트랙 목록을 가져옵니다.
  • 텍스트 트랙을 추가하거나 제거합니다.
  • 오디오 트랙을 추가하거나 제거합니다.
  • 텍스트 또는 오디오 트랙의 접근성 특성을 지정합니다.
  • Azure Portal 트랙을 편집하거나 다운로드한 다음 자산에 다시 업로드합니다.
  • 비디오 플레이어에서 텍스트 트랙을 표시하거나 숨깁니다.

참고

VOD(주문형 비디오) 자산에서만 텍스트 트랙을 추가하거나 업데이트할 수 있습니다. 또한 오디오 지연 바인딩은 라이브 스트리밍 자산에 대해 지원되지 않습니다.

텍스트 트랙

로컬로 생성된 미디어와 함께 텍스트 트랙 사용

로컬로 비디오를 제작하고 캡션을 내보낸 후에는 해당 캡션을 주문형 미디어가 포함된 자산에 업로드할 수 있습니다.

로컬로 생성된 텍스트와 함께 텍스트 트랙을 사용하기 위한 일반 워크플로:

  1. 비디오를 만들고 캡션을 VTT 또는 TTML 형식의 파일로 내보냅니다.
  2. VTT 또는 TTML 파일을 번역하거나 편집하고 다음을 위해 복사본을 저장합니다.
    1. 접근성 요구 사항을 충족하기 위해 설명 텍스트가 있는 추가 언어에 대한 트랙입니다.
    2. 감독의 해설에 대한 추가 텍스트에 대한 트랙입니다.
  3. 중요: 클라이언트 플레이어에 올바른 언어를 표시하려면 VTT 헤더에 언어 지정자를 추가해야 합니다. 예를 들면 다음과 같습니다.
    WEBVTT
Language: en-us
  4. Media Services에 비디오를 업로드합니다.
  5. 비디오를 인코딩하는 변환 및 작업을 만듭니다.
  6. 추가 텍스트 트랙을 업로드합니다.

라이브 대화 내용 기록과 함께 텍스트 트랙 사용

라이브 이벤트에 대한 라이브 전사가 켜져 있으면 시청자가 라이브 비디오 플레이어에서 볼 수 있는 실시간 라이브 전사 트랙 외에도 추가 WebVTT 텍스트 트랙이 만들어집니다. 이 WebVTT 파일에는 부분적인 실시간 결과 대신 전체 문장이 포함된 최상의 라이브 대본 버전이 포함되어 있습니다. 전체 대본을 사용할 수 있고 라이브 출력이 삭제된 후 .vtt 파일을 다운로드할 수 있습니다.

경고

최종 자동 생성된 라이브 전사 VTT 파일은 처리를 위해 지연됩니다. 라이브 출력을 삭제하기 전에 몇 분 동안 기다리지 않으면 파일의 콘텐츠가 잘립니다. 또한 라이브 이벤트에 대한 여러 입력 스트림과 함께 라이브 전사를 사용할 수 없습니다.

라이브 전사 텍스트 트랙을 사용하기 위한 일반 워크플로:

  1. 라이브 전사를 사용하도록 설정하고 원본 언어가 선택된 라이브 이벤트를 만듭니다.
  2. 라이브 이벤트가 끝나면 몇 분 동안 기다린 다음 라이브 출력을 삭제합니다. 보관된 자산은 주문형 스트리밍에 사용할 수 있습니다. 유효한 스트리밍 URL은 여전히 뷰어에 액세스할 수 있습니다.
  3. 보관된 자산의 트랙을 나열하거나 포털에서 볼 수 있습니다. NBest 전사를 포함하는 WebVTT 파일이 있습니다. .vtt 확장이 있습니다. 파일 이름은 auto-generated-best_XXX.vtt로 지정됩니다.
  4. Azure Portal VTT 파일을 편집하거나 다운로드하여 편집합니다.
  5. 여러 언어로 텍스트 트랙을 표시하려면 원본 텍스트 트랙을 해당 언어로 번역하고 .vtt 확장을 사용하여 각 언어에 대한 별도의 파일로 저장합니다.
  6. 원본 언어 트랙과 각 언어에 대한 텍스트 트랙을 업로드합니다.
  7. Azure Portal 사용하여 파일을 업로드하지 않는 경우 .ism 파일을 편집(또는 업데이트)하여 플레이어에게 사용할 텍스트와 레이블 지정 및 표시 유형을 알려줍니다.
    1. 트랙 API를 사용하여 SDK 또는 CLI 중 하나를 사용하여 프로그래밍 방식으로 매니페스트를 업데이트합니다.
      1. Node.JS
      2. Python
      3. .Net
      4. CLI

중요

.ism 파일을 업데이트할 때 라이브 전사 텍스트 트랙을 숨기고 뷰어에 적합한 언어로 텍스트 트랙을 표시해야 합니다.

오디오 트랙

자산에 오디오 트랙을 추가하여 뷰어에게 다양한 언어로 오디오를 제공하거나, 접근성을 위해 설명 오디오를 추가하거나, 디렉터의 해설을 추가할 수 있습니다.

오디오 트랙에 대한 일반 워크플로

  1. 라이브 이벤트에 대한 추가 오디오 트랙을 만듭니다. 다른 언어로 된 오디오 또는 접근성에 사용되는 설명이 포함된 오디오일 수 있습니다. 또한 감독의 해설에 오디오 트랙을 사용할 수 있습니다.
  2. 오디오 트랙을 보관된 자산에 업로드합니다.
  3. 포털에서 매니페스트 파일을 편집하거나 REST 또는 SDK를 사용하여 트랙 데이터를 업데이트하여 트랙 데이터를 업데이트합니다.

참고

오디오 또는 텍스트 트랙이 제거되면 기본 파일이 스토리지 컨테이너에서 제거되지 않습니다. Media Services는 비디오 플레이어가 요청한 매니페스트 또는 재생 목록에 트랙에 대한 정보를 표시하지 않도록 동적 패키지러(스트리밍 엔드포인트)를 설정합니다.

자세한 Tracks API 단계는 아래 샘플을 참조하세요.

샘플

방법, 자습서 및 빠른 시작

도움말 및 지원 보기

다음 방법 중 하나로 Media Services에 문의하거나 업데이트를 따를 수 있습니다.