Client Update Multiple Levels Streaming Status
PlayerControllerЧто это
Client Update Multiple Levels Streaming Status — исполняемая (exec) функция PlayerController, отправляемая с сервера на клиент. Она обновляет статус стриминга сразу нескольких уровней, устанавливая для каждого флаги загрузки, видимости и блокировки. Используется в многопользовательских проектах для синхронизации состояний потоковых уровней на всех клиентах.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- LevelStatuses (Array of Level Streaming Status Structure) — массив структур, каждая задаёт Package Name (имя уровня) и три булевых флага:
- bShouldBeLoaded (загружено ли)
- bShouldBeVisible (видимо ли)
- bShouldBlockOnLoad (блокировать ли поток до завершения загрузки)
Выходы (данные):
- нет (void)
Когда используется
- После смены подуровней на сервере, когда нужно принудительно обновить состояние стриминга на всех клиентах (например, при загрузке новой зоны в мультиплеере).
- Для массового изменения флагов нескольких уровней одной отправкой, чтобы сократить число RPC-вызовов.
Типичные проблемы
- Вызов не на той стороне — функция помечена как
Client(RPC), поэтому она может быть вызвана только на сервере (и будет выполнена на соответствующем клиенте). Попытка вызвать её напрямую на клиенте не даст эффекта (вызов проигнорируется). - Некорректные имена уровней —
Package Nameдолжен точно совпадать с именем, под которым уровень добавлен вLevel Streaming(регистр важен). Использование неверного имени приведёт к игнорированию записи или ошибке лога. - Чрезмерный размер массива — отправка массива с десятками записей за один кадр может вызвать фрагментацию пакета или задержки. Рекомендуется группировать обновления логически, а не отправлять все уровни сразу.