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