Client Travel Internal
PlayerControllerЧто это
Exec-функция PlayerController, выполняющая внутреннее перемещение клиента на другой уровень (карту). Используется для смены игровой локации с возможностью выбора типа перехода (абсолютный/относительный), бесшовной загрузки и указания суффикса карты. В отличие от высокоуровневых аналогов (Client Travel), предоставляет прямой доступ к параметрам путешествия.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения после завершения перехода
Входы (данные):
- URL (String) — адрес целевого уровня (например, путь к карте)
- Travel Type (TravelType) — тип путешествия: Absolute (абсолютный путь) или Relative (относительный)
- Seamless (Boolean) — флаг бесшовной загрузки (true — без экрана загрузки, false — с экраном)
- Map Suffix (String) — суффикс, добавляемый к имени карты (опционально, используется для вариаций одной карты)
Выходы (данные):
нет (void)
Когда используется
- Переключение между уровнями в мультиплеерных или одиночных проектах, когда требуется точный контроль над типом перехода и суффиксом карты.
- Реализация кастомной системы путешествий (например, телепортация между локациями) с возможностью бесшовной загрузки.
Типичные проблемы
- Некорректный URL — если строка адреса не соответствует ожидаемому формату (например, отсутствует префикс или карта не найдена), переход не выполнится.
- Неверный Travel Type — путаница между Absolute и Relative приводит к неправильному разрешению пути (особенно при использовании относительных ссылок).
- Забытый Map Suffix — если суффикс не указан, но карта ожидает его наличие, загрузка может завершиться ошибкой или загрузиться не та версия карты.