Get Num Tracks
MediaPlayer
0
Что это
Pure-функция, возвращающая количество треков (дорожек) в текущем медиафайле, загруженном в MediaPlayer. Не изменяет состояние плеера.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (MediaPlayer Object Reference) — ссылка на плеер, у которого запрашивается количество треков
Выходы (данные):
- Return Value (Integer) — количество треков (0, если медиа не загружено или не содержит треков)
Когда используется
- Перед перебором треков (например, в цикле For Loop) для получения их свойств (продолжительность, тип и т.д.).
- Для проверки, загружен ли контент (если Return Value > 0, плеер содержит данные).
Типичные проблемы
- Вызов функции до того, как медиафайл полностью загружен (например, сразу после Open Source без ожидания события OnMediaOpened) — возвращает 0, что может быть ошибочно интерпретировано как отсутствие треков.
- Использование pure-функции в последовательности exec-нод без учёта того, что она не гарантирует порядок выполнения относительно других операций (если требуется синхронизация, нужно использовать exec-цепочку с другими нодами).
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.