Open Source With Options
MediaPlayer
0
Что это
Exec-функция, которая начинает открытие медиа-источника (MediaSource) с дополнительными настройками (MediaPlayerOptions). Возвращает true, если операция инициирована успешно, но не гарантирует готовность к воспроизведению — фактическое открытие асинхронно.
Пины
Exec-входы:
- execute (exec) — запуск открытия
Exec-выходы:
- then (exec) — продолжение выполнения после вызова
Входы (данные):
- Target (MediaPlayer) — медиаплеер, в который загружается источник
- Media Source (MediaSource Object Reference) — объект медиа-источника (например, FileMediaSource, StreamMediaSource)
- Options (MediaPlayerOptions Structure) — структура с дополнительными параметрами (зацикливание, время начала, громкость и др.)
Выходы (данные):
- Return Value (Boolean) —
true, если плеер успешно начал попытку открытия;falseпри ошибке параметров или недоступности плеера
Когда используется
- Загрузка видео/аудио из файла, URL или потокового источника с тонкой настройкой (например, принудительное зацикливание или пропуск начала).
- Если нужна только загрузка без дополнительных опций — используйте «Open Source».
Типичные проблемы
- Возврат
trueне означает готовность к воспроизведению. Медиа может открываться с задержкой — дожидайтесь событияOnMediaOpenedили проверяйтеIsReady(). - Некорректный MediaSource. Если источник не инициализирован (например, не задан путь к файлу), функция вернёт
falseбез разъяснения причины. - Пустые Options. Структура
MediaPlayerOptionsимеет значения по умолчанию — забывать её передавать не опасно, но неявное переопределение (например,Loopбез явной установки) может привести к неожиданному поведению.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.