Get Track Language
MediaPlayerЧто это
Pure-функция класса MediaPlayer. Возвращает строку с кодом или названием языка указанного трека (аудио, субтитры и т.д.) по его типу и индексу. Не требует exec-соединения — вызывается как источник данных.
Пины
Exec-входы:
– нет (pure)
Exec-выходы:
– нет (pure)
Входы (данные):
- Target (MediaPlayer) — медиаплеер, для которого выполняется запрос
- TrackType (EMediaPlayerTrack) — тип трека (Audio, Caption, Video, Metadata, Script, Subtitle)
- TrackIndex (Integer) — индекс трека в списке треков данного типа (начиная с 0)
Выходы (данные):
- Return Value (String) — строка с идентификатором языка (например, "en", "ru", "English")
Когда используется
Для построения UI выбора языка аудиодорожки или субтитров, а также для автоматического переключения на предпочтительный язык при открытии медиа.
Типичные проблемы
- Индекс трека выходит за пределы (меньше 0 или >= количества треков данного типа) — возвращается пустая строка. Всегда проверяйте количество треков через GetNumTracks.
- Неправильный тип трека (например, Video не имеет языка) — возвращает пустую строку или undefined.
- Медиаплеер не открыт (не вызван Open Source) — функция всё равно выполнится, но вернёт пустую строку. Убедитесь, что плеер готов.