휴면 액터 깨우기: FlushNetDormancy, ForceNetUpdate, SetNetDormancy

FlushNetDormancy#

휴면 정책은 그대로 두고 휴면 상태만 잠깐 푼다. 휴면을 끄는 것이 아니라, 바뀐 값을 보내는 동안만 깨우는 것이다. 정책이 여전히 휴면이므로 액터는 변경을 보낸 뒤 스스로 다시 휴면한다. 계속 깨워 두려면 정책 자체를 바꾸는 SetNetDormancy를 쓴다.

DORM_Initial이면 DORM_DormantAll로 바꾸는데, 둘 다 휴면하는 값이라 휴면은 이어진다. 이 변경은 게임 NetDriver가 없어도 일어난다. 그다음 액터를 복제하는 모든 NetDriver에서 휴면 상태를 푼다.

레거시 복제와 Replication Graph는 휴면 중이던 연결마다 replicator를 현재 상태로 다시 만든다(Engine/Private/NetConnection.cpp). 복제 시점은 건드리지 않고, 연결마다 다음 과정을 거쳐 다시 휴면한다.

1. 다음 복제 검토에서 flush 뒤에 바뀐 값을 보낸다.
2. 그다음 검토에서 다시 비교해 바뀐 값이 없음을 확인한다.
3. 1에서 보낸 것이 ack되면 Actor channel을 닫고 휴면한다.

데이터가 나가는 것은 보통 한 번이다. 기본 설정에서 다시 휴면하는 시점은 두 번째 검토와 ack 중 늦은 쪽이고, 그 사이 값이 또 바뀌면 검토마다 보내고 다시 기다린다. Iris는 channel을 닫지 않는다. flush하면 다음 업데이트에 한 번 폴링한 뒤 바로 폴링 대상에서 빠진다.

ForceNetUpdate#

복제 시점을 다루는 함수다. NetUpdateFrequency 주기를 기다리지 않고 다음 복제 검토에 넣는다. Replication Graph는 우선순위도 올리지만 레거시 복제는 올리지 않는다.

보장하는 것은 검토 시점뿐이다. 관련성 검사, 대역폭 포화, 프로퍼티 비교는 그대로 거치고, Push Model의 마킹을 대신하지 않는다.

깨우는 것은 덤이다. 휴면 액터면 FlushNetDormancy도 부르는데, 휴면 중인 연결은 복제 검토에서 빠져 시점만 앞당겨서는 보낼 수 없기 때문으로 보인다. 이 flush에는 조건이 있다(아래 자주 하는 실수).

SetNetDormancy#

휴면 정책 자체를 바꾼다. DORM_Awake 이하로 바꾸면 각 NetDriver에서 휴면 상태도 푼다. 정책이 깨어 있으므로 다시 휴면하지 않고, 따로 FlushNetDormancy를 부를 필요도 없다. DORM_DormantAll로 되돌리면 보낸 것이 모두 ack됐고 바뀐 값이 없을 때 다음 검토 직후 휴면한다.

ForceNetUpdate가 flush하지 않는 경우#

ForceNetUpdate는 authority이고, 게임 NetDriver가 있고, 그 NetDriver가 서버일 때만 덤으로 flush한다.

1
void AActor::ForceNetUpdate()
2
{
3
  UNetDriver* NetDriver = GetNetDriver();
4

5
  if (GetLocalRole() == ROLE_Authority)
6
  {
7
    if (NetDriver && NetDriver->GetNetMode() < ENetMode::NM_Client)
8
    {
9
      NetDriver->ForceNetUpdate(this);
10

11
      if (NetDormancy > DORM_Awake)
12
      {
13
        FlushNetDormancy();
14
      }
15
    }
16
  }
17

18
  // (생략) 게임 NetDriver가 아닌 NetDriver에는 ForceNetUpdate만 전달한다.
19
}

데디케이티드 서버와 맵을 리슨 서버로 연 경우는 문제가 없다. UEngine::LoadMap이 Listen을 액터 초기화보다 먼저 호출하기 때문이다.

문제는 게임 NetDriver가 없는 월드다. 혼자 플레이하던 호스트가 맵을 다시 열지 않고 UWorld::Listen으로 친구를 받는 협동 게임에서, 맵에 배치된 문(DORM_Initial)을 연다고 하자.

Listen 전에는 게임 NetDriver가 없어 ForceNetUpdate가 아무것도 하지 않는다. 결과가 갈리는 것은 DORM_Initial과 DORM_DormantAll이 둘 다 휴면이지만 새로 접속한 연결을 다르게 다루기 때문이다.

DORM_Initial 배치 액터는 클라이언트도 레벨에서 이미 갖고 있다고 보고 복제 검토에서 아예 뺀다. 그래서 친구는 레벨에 저장된 닫힌 문을 보고, 다음 flush 전까지 상태가 어긋난다.

Standalone에서 리플레이를 녹화할 때도 같은 분기를 탄다.

FlushNetDormancy는 게임 NetDriver가 없어도 DORM_Initial을 DORM_DormantAll로 바꾸고, 데모 NetDriver를 포함해 액터를 복제하는 모든 NetDriver에서 휴면 상태를 푼다.

값을 바꾼 뒤 깨우면 FastArray 변경이 사라진다#

레거시 복제와 Replication Graph 기준이다. 휴면 액터의 FastArray에 항목을 추가한 뒤 깨우면 그 항목은 클라이언트로 가지 않는다.

1
void AChestActor::AddItem(const FChestItem& NewItem)
2
{
3
  FChestItem& Item = Items.Items.Add_GetRef(NewItem);
4
  Items.MarkItemDirty(Item);
5

6
  // 휴면 중이었다면 위 항목은 전달되지 않는다.
7
  ForceNetUpdate();
8
}

결과는 서버와 클라이언트의 배열 불일치다. 이후 같은 순서로 추가한 항목도 전달되지 않고, Push Model로 등록하고 마킹한 FastArray도 같다.

ForceNetUpdate가 덤으로 부르는 FlushNetDormancy도 값을 바꾼 뒤라 “변경 → flush” 순서가 된다. 레거시 복제와 Replication Graph는 기본 설정에서 flush할 때 휴면 중이던 연결마다 replicator를 현재 상태를 기준선으로 다시 만든다. 그래서 flush 전에 추가한 항목은 이미 보낸 것으로 취급되는 것으로 보인다.

일반 프로퍼티는 값을 바꾼 뒤 flush해도 지금은 전달되지만, Epic은 이를 기대면 안 되는 구현 세부로 본다(Actor Network Dormancy).

값을 바꾸기 전에 깨우면 된다.

1
void AChestActor::AddItem(const FChestItem& NewItem)
2
{
3
  FlushNetDormancy();
4

5
  FChestItem& Item = Items.Items.Add_GetRef(NewItem);
6
  Items.MarkItemDirty(Item);
7
}

이 뒤에 ForceNetUpdate를 더해도 변경은 그대로 전달된다.

Setter 패턴#

위 두 문제는 휴면할 수 있는 액터의 replicated property를 setter로만 바꾸면 막을 수 있다.

1
void ADoorActor::SetOpen(bool bNewOpen)
2
{
3
  check(HasAuthority());
4

5
  if (bOpen == bNewOpen)
6
  {
7
    return;
8
  }
9

10
  FlushNetDormancy();
11
  bOpen = bNewOpen;
12

13
  // 바로 보내야 하는 변경일 때만
14
  ForceNetUpdate();
15
}

• 같은 값이면 반환한다. 값이 그대로여도 flush는 휴면 중이던 연결을 깨우고 replicator를 다시 만든다. 값이 한동안 자주 바뀌면 변경마다 flush하지 말고 SetNetDormancy로 깨워 둔다.
• FlushNetDormancy를 직접, 값을 바꾸기 전에 부른다. 게임 NetDriver가 없는 월드와 FastArray 순서 문제를 함께 막는다.
• 프로퍼티를 private로 두고 setter만 공개한다.

Push Model과 함께 쓸 때#

마킹도 setter 안에서 값을 바꾼 직후에 한다. 마킹하지 않은 Push Model 프로퍼티는 flush해도 전달되지 않는다. 반대로 마킹은 dirty 표시일 뿐 액터를 깨우지 않으므로, 마킹했더라도 flush는 그대로 필요하다.

Push Model은 값이 그대로인 flush의 비용을 줄여 주지 않는다. 건너뛰는 것은 dirty가 아닌 프로퍼티의 비교뿐이고, 깨우고 다시 재우는 비용은 setter의 early-return으로 막는다. 이 패턴에서 Push Model의 역할은 비용보다 강제에 가깝다. 마킹 없이는 변경이 전달되지 않으니 값을 바꾸는 경로가 setter로 모이고, 그 setter가 flush 순서까지 고정한다.