Mark Property Dirty From Rep Index
NetPushModelHelpersЧто это
Exec-функция, помечает свойство объекта как требующее репликации (dirty) по его индексу в схеме репликации (RepIndex). Используется в системе Net Push Model для ручного управления репликацией — движок не будет повторно отправлять свойство, пока его не отметят этой функцией. Требует вызова на сервере.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (Object) — объект, свойство которого нужно отметить как dirty
- RepIndex (Integer) — индекс свойства в
FRepLayout(0-based)
Выходы (данные):
- нет (void)
Когда используется
- В многопользовательских проектах с Net Push Model, когда нужно принудительно реплицировать свойство, не дожидаясь автоматической репликации (например, после изменения состояния, которое не было обнаружено стандартным
Dirty-механизмом). - Вместо
MarkPropertyDirty(по имени свойства), когда известен только индекс свойства (например, при работе с динамическими реплицируемыми массивами).
Типичные проблемы
- Неверный RepIndex — индекс должен совпадать с порядком свойства в структуре репликации родительского класса. После изменения C++ или перекомпиляции блюпринта индексы могут сдвинуться, что приведёт к помечанию не того свойства.
- Вызов на клиенте — функция работает только на сервере (
HasAuthority). Вызов на клиенте игнорируется, что часто вводит в заблуждение. - Отсутствие
ForceNetUpdate— отметка dirty не гарантирует немедленной отправки, если пакет ещё не ушёл. В некоторых случаях требуется дополнительно вызватьForceNetUpdateнаActorChannel.