Shaka Player 파헤치기 - MPD 매니페스트에서 오디오 트랙은 어떻게 선정되는가#

1// player.js — updateAbrManagerVariants_ (발췌)
2const playableVariants = shaka.util.StreamUtils.getPlayableVariants(
3    this.manifest_.variants);
4
5// Update the abr manager with newly filtered variants.
6const adaptationSet = this.currentAdaptationSetCriteria_.create(
7    playableVariants);
8const ret = this.abrManager_.setVariants(
9    Array.from(adaptationSet.values()), isLowLatency);

1// player_configuration.js — 기본 설정
2adaptationSetCriteriaFactory:
3    (...args) => new shaka.media.PreferenceBasedCriteria(...args),

1// preference_based_criteria.js — create()
2create(variants) {
3  const Class = shaka.media.PreferenceBasedCriteria;
4
5  // 1. 오디오 선호도 적용
6  let current = Class.applyAudioPreferences_(
7      variants, this.config_.preferredAudio,
8      this.config_.audioCodec, this.config_.activeAudioCodec);
9
10  // 2. 비디오 선호도 적용
11  current = Class.applyVideoPreferences_(
12      current, this.config_.preferredVideo);
13
14  // 3. 첫 번째 변형을 루트 삼아 AdaptationSet 조립
15  this.lastAdaptationSet_ = new shaka.media.AdaptationSet(current[0], current,
16      !supportsSmoothCodecTransitions);
17
18  return this.lastAdaptationSet_;
19}

1// preference_based_criteria.js — applyAudioPreferences_ (발췌)
2static applyAudioPreferences_(
3    variants, preferredAudio, audioCodec, activeAudioCodec) {
4  const Class = shaka.media.PreferenceBasedCriteria;
5
6  for (const pref of preferredAudio) {
7    let candidates = variants;
8
9    if (pref.language) {
10      const byLanguage = Class.filterByLanguage_(candidates, pref.language);
11      if (byLanguage.length) {
12        candidates = byLanguage;
13      } else {
14        continue;
15      }
16    }
17
18    if (pref.role) { /* ... 역할로 필터 ... */ }
19    if (pref.label) { /* ... 라벨로 필터 ... */ }
20    if (pref.channelCount) { /* ... 채널 수로 필터 ... */ }
21    // ... codec, spatialAudio 필터 ...
22
23    if (candidates.length) {
24      return candidates;
25    }
26  }
27  // ... 아무것도 매칭되지 않았을 때의 폴백 (뒤에서 설명) ...
28}

1// player.js — convertLegacyPreferences_ (발췌)
2const audioFields = {
3  'preferredAudioLanguage': 'language',
4  'preferredAudioRole': 'role',
5  'preferredAudioLabel': 'label',
6  'preferredAudioChannelCount': 'channelCount',
7  'preferSpatialAudio': 'spatialAudio',
8};
9const hasLegacyAudio = Object.keys(audioFields).some((f) => f in config);
10if (hasLegacyAudio) {
11  const pref = { language: '', role: '', label: '', channelCount: 0, codec: '' };
12  for (const [oldField, newProp] of Object.entries(audioFields)) {
13    if (oldField in config) {
14      warnLegacy(oldField, 'preferredAudio');
15      pref[newProp] = config[oldField];
16      delete config[oldField];
17    }
18  }
19  if (!config['preferredAudio']) {
20    config['preferredAudio'] = [pref];
21  }
22}

1// player_configuration.js — 기본 preferredAudio
2preferredAudio: [{
3  language: '',
4  role: '',
5  label: '',
6  channelCount: 2,
7  codec: '',
8}],

1// preference_based_criteria.js — filterByLanguage_
2static filterByLanguage_(variants, preferredLanguage) {
3  const LanguageUtils = shaka.util.LanguageUtils;
4
5  const preferredLocale = LanguageUtils.normalize(preferredLanguage);
6
7  const closestLocale = LanguageUtils.findClosestLocale(
8      preferredLocale,
9      variants.map((variant) => LanguageUtils.getLocaleForVariant(variant)));
10
11  // 가까운 로케일이 하나도 없으면 빈 배열
12  if (!closestLocale) {
13    return [];
14  }
15
16  // 가장 가까운 로케일을 쓰는 변형만 추린다
17  return variants.filter((variant) => {
18    return closestLocale == LanguageUtils.getLocaleForVariant(variant);
19  });
20}

1// language_utils.js — findClosestLocale (발췌)
2// Preference 1 - 정확히 일치. "en-US" == "en-US"
3for (const option of safeSearchSpace) {
4  if (option == safeTarget) { return option; }
5}
6// Preference 2 - 후보가 타깃의 부모. 선호 "en-US"에 대해 "en"
7for (const option of safeSearchSpace) {
8  if (LanguageUtils.isParentOf(option, safeTarget)) { return option; }
9}
10// Preference 3 - 후보가 타깃의 형제. 선호 "en-US"에 대해 "en-CA"
11for (const option of safeSearchSpace) {
12  if (LanguageUtils.isSiblingOf(option, safeTarget)) { return option; }
13}
14// Preference 4 - 후보가 타깃의 자식. 선호 "en"에 대해 "en-US"
15for (const option of safeSearchSpace) {
16  if (LanguageUtils.isParentOf(safeTarget, option)) { return option; }
17}
18return null; // 아무것도 못 찾음

1// language_utils.js — getLocaleForVariant (발췌)
2// 우선순위: 1. Variant  2. Audio Stream  3. Video Stream
3if (variant.language) { return normalize(variant.language); }
4if (variant.audio && variant.audio.language) { return normalize(variant.audio.language); }
5if (variant.video && variant.video.language) { return normalize(variant.video.language); }
6return 'und'; // 어디에도 언어가 없으면 'und'(undetermined)

1// preference_based_criteria.js — applyAudioPreferences_ 폴백부 (발췌)
2// 오디오 선호가 없거나 아무것도 매칭되지 않았을 때
3let current = variants;
4
5// (런타임 코덱 선호가 있으면 먼저 적용 — 생략)
6
7const byPrimary = current.filter((variant) => variant.primary);
8if (byPrimary.length) {
9  return byPrimary;
10}
11return current;

1// player.js (발췌)
2const hasPrimary = this.manifest_.variants.some((v) => v.primary);
3if (!this.config_.preferredAudio.length && !hasPrimary) {
4  shaka.log.warning('No preferred audio language set.  ' +
5      'We have chosen an arbitrary language initially');
6}

1// preference_based_criteria.js — filterVariantsByAudioChannelCount_ (발췌)
2return variants.filter((variant) => {
3  // 원하는 채널 수보다 많은 변형은 제외
4  if (variant.audio && variant.audio.channelsCount &&
5      variant.audio.channelsCount > channelCount) {
6    return false;
7  }
8  return true;
9}).sort((v1, v2) => {
10  // 원하는 값에 가장 가까운(채널 수가 큰) 변형이 앞에 오도록 정렬
11  // AdaptationSet이 첫 변형을 기준으로 집합을 구성하므로 중요하다
12  if (!v1.audio && !v2.audio) { return 0; }
13  if (!v1.audio) { return -1; }
14  if (!v2.audio) { return 1; }
15  return (v2.audio.channelsCount || 0) - (v1.audio.channelsCount || 0);
16});

1// adaptation_set.js — areAdaptable (발췌)
2// 언어가 다르면 서로 적응하지 않는다
3if (a.language != b.language) {
4  return false;
5}

1// hls_parser.js — EXT-X-MEDIA의 DEFAULT 속성이 primary가 된다
2const primary = defaultAttrValue == 'YES';