Set Desired Player Name
MediaPlayerЧто это
Exec-функция класса MediaPlayer, которая задаёт имя желаемого медиаплеера (например, "WMF" для Windows, "AVF" для macOS/iOS). Выбор влияет на то, какой бэкенд будет использоваться при открытии медиа-источника. Выполняется немедленно, но вступает в силу при следующем вызове Open Source.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (MediaPlayer Object Reference) — медиаплеер, которому задаётся имя
- PlayerName (Name) — имя желаемого плеера (например,
"WMF","AVF","AndroidMediaPlayer")
Выходы (данные):
- нет (void)
Когда используется
- Принудительный выбор конкретного медиа-бэкенда на платформах, где доступно несколько вариантов (например, Windows — WMF или Bink).
- Тестирование и отладка: быстрое переключение между плеерами без изменения проекта.
Типичные проблемы
- Неверное имя плеера (опечатка или несуществующий идентификатор) — функция отработает, но плеер не изменится, и будет использован системный по умолчанию.
- Вызов после открытия медиа — изменение имени не повлияет на уже открытый источник; нужно переоткрыть его заново.
- Имя может быть недоступно на текущей платформе — рекомендуется проверять доступные плееры через
GetAvailablePlayerNamesили обрабатывать отсутствие черезOnMediaOpenFailed.