[JWPlayer] Events - Audio Tracks

Audio Tracks

이 API 호출은 비디오에 여러 개의 오디오 트랙이 제공될 경우, 활성 오디오 트랙을 감지하거나 업데이트하는 데 사용됩니다.

.on(‘audioTracks’)

사용 가능한 오디오 트랙 목록이 업데이트될 때 트리거됩니다.
이 이벤트는 플레이리스트 아이템이 재생을 시작한 직후에 발생합니다.

{
  "tracks": [
    {
      "autoselect": true,
      "defaulttrack": true,
      "groupid": "aac",
      "language": "en",
      "name": "English",
      "hlsjsIndex": 0
    },
    {
      "autoselect": true,
      "defaulttrack": false,
      "groupid": "aac",
      "language": "sp",
      "name": "Spanish",
      "hlsjsIndex": 1
    },
    {
      "autoselect": false,
      "defaulttrack": false,
      "groupid": "aac",
      "language": "en",
      "name": "Commentary (eng)",
      "hlsjsIndex": 2
    }
  ],
  "currentTrack": 0,
  "type": "audioTracks"
}

• currentTrack (number)
  • 현재 활성화된 오디오 트랙의 인덱스
• tracks (array)
  • M3U8 매니페스트를 기반으로 한 트랙 정보
  • tracks[]
    • tracks.autoselect (boolean)
      • 명시적인 선호 설정이 없을 때 시스템 언어에 따라 자동 선택될 수 있음을 나타냅니다.
    • tracks.defaulttrack (boolean)
      • 기본으로 선택되어야 하는 트랙인지 여부를 식별합니다.
    • tracks.groupid (string)
      • HLS에서 동일한 콘텐츠의 다양한 오디오 버전을 구성·관리하기 위한 오디오 그룹 식별자
    • tracks.hlsjsIndex (number)
      • hls.js가 내부적으로 오디오 트랙을 추적하기 위해 사용하는 0부터 시작하는 인덱스 식별자
    • tracks.language (string)
      • 오디오 트랙의 두 글자 언어 코드
    • tracks.name (string)
      • 오디오 트랙에 지정된 라벨(표시 이름)
• type (string)
  • 플레이어 이벤트의 카테고리
  • 이 값은 항상 audioTracks 입니다.

.on(‘audioTrackChanged’)

활성 오디오 트랙이 변경될 때 트리거됩니다.
이 이벤트는 사용자가 트랙을 선택하거나, 스크립트에서 setCurrentAudioTrack()을 호출하여 트랙이 변경될 때 발생합니다.

{
  "tracks": [
    {
      "autoselect": true,
      "defaulttrack": true,
      "groupid": "aac",
      "language": "en",
      "name": "English",
      "hlsjsIndex": 0
    },
    {
      "autoselect": true,
      "defaulttrack": false,
      "groupid": "aac",
      "language": "sp",
      "name": "Spanish",
      "hlsjsIndex": 1
    },
    {
      "autoselect": false,
      "defaulttrack": false,
      "groupid": "aac",
      "language": "en",
      "name": "Commentary (eng)",
      "hlsjsIndex": 2
    }
  ],
  "currentTrack": 1,
  "type": "audioTrackChanged"
}

• currentTrack (number)
  • 현재 활성화된 오디오 트랙의 인덱스
• tracks (array)
  • M3U8 매니페스트를 기반으로 한 트랙 정보
  • tracks[]
    • tracks.autoselect (boolean)
      • 명시적인 선호가 설정되지 않은 경우, 시스템 언어를 기반으로 선택될 수 있음을 나타냅니다.
    • tracks.defaulttrack (boolean)
      • 기본으로 선택되어야 하는 트랙인지 여부를 나타냅니다.
    • tracks.groupid (string)
      • HLS에서 동일한 콘텐츠의 다양한 오디오 버전을 구성 및 관리하기 위한 오디오 그룹 식별자
    • tracks.hlsjsIndex (number)
      • hls.js가 오디오 트랙을 추적하기 위해 사용하는 0부터 시작하는 내부 식별자
    • tracks.language (string)
      • 오디오 트랙의 두 글자 언어 코드
    • tracks.name (string)
      • 오디오 트랙에 부여된 라벨(표시 이름)
• type (string)
  • 플레이어 이벤트의 카테고리
  • 이 값은 항상 audioTrackChanged 입니다.