Get Remote Role
ActorЧто это
Pure-функция класса Actor, возвращает значение роли удалённого клиента (Remote Role) для данного актора. Позволяет определить, как этот актор реплицируется на других машинах: Authoritative (авторитетный), AutonomousProxy (автономный прокси), SimulatedProxy (симулированный прокси) или None. Не требует exec-пинов, так как это pure-функция.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Actor Object Reference) — актор, для которого проверяется удалённая роль.
Выходы (данные):
- ReturnValue (ERemoteRole / ENetRole) — значение удалённой роли (enum: None, SimulatedProxy, AutonomousProxy, Authority).
Когда используется
- В мультиплеерных проектах для проверки, как данный актор будет вести себя на других клиентах (репликация движения, анимации и т.д.).
- Для разграничения логики между авторитетным сервером и клиентами: если ReturnValue == ROLE_Authority, значит объект на сервере; если ROLE_SimulatedProxy или ROLE_AutonomousProxy — на клиенте.
Типичные проблемы
- Путаница между GetLocalRole и GetRemoteRole: первая возвращает роль на текущей машине, вторая — роль на удалённой (противоположной) машине. Для клиента LocalRole = AutonomousProxy, RemoteRole = Authority (для принадлежащего ему актора); для сервера LocalRole = Authority, RemoteRole = AutonomousProxy.
- Неверная интерпретация enum:
None(не реплицируется),SimulatedProxy(только симуляция движения),AutonomousProxy(полный контроль вводом). Не все значения возможны для всех акторов — зависит от настройки Replication и Ownership.