Spawning - cheona-thousand-man/Unity-myBasics-Wiki GitHub Wiki

개요

런타임에서 NetworkObject를 스폰하려면 Runner.Spawn() 메서드를 사용(Scene 오브젝트는 자동으로 스폰되므로 별도로 스폰할 필요X)

• NetworkObject는 Fusion에서 네트워크 전역에서 고유한 식별자를 할당하는 데 사용
• 모든 클라이언트가 각 인스턴스가 무엇인지에 대해 각 네트워크 객체의 상태를 올바르게 동기화할 수 있도록 작동
• Runner.Spawn() 메서드는 Fusion에게 새로운 객체 인스턴스를 집합적인 네트워크 상태에 언제 어떻게 추가할지 공지

중요!
Unity의 내장 GameObject.Instantiate() 메서드를 네트워크 객체에 사용하지 마세요. 이는 완전히 Fusion 시뮬레이션 루프와 분리된 로컬 게임 객체를 생성하며, 네트워크 상태가 손상됩니다.

Runner.Spawn

Fusion NetworkRunner 인스턴스의 Runner.Spawn() 메서드는 Unity의 GameObject.Instantiate() 메서드 모방

• NetworkObject 타입의 Prefab
• 위치 (position)
• 회전 (rotation)
• 객체에 대한 입력 권한을 식별할 PlayerRef (Host/Server 모드에서만 관련됨)
• 다른 인스턴스에 객체를 복제하기 전에 실행할 NetworkRunner.OnBeforeSpawned 타입의 델리게이트 (프리팹만 필수 매개변수이며, 나머지는 선택사항)

var obj = Runner.Spawn(prefab, Vector3.zero, Quaternion.identity, Runner.LocalPlayer, MyOnBeforeSpawnDelegate);

모든 클라이언트가 Runner.Spawn()을 호출할 수 있지만, 결과는 네트워크 모드에 따라 다름

• *Host 및 Server 모드 오직 Host/Server만 NetworkObject를 스폰할 수 있습니다. 클라이언트는 Host/Server에 스폰 요청 필요(예: RPC)
• *Shared 모드 어떤 클라이언트라도 NetworkObject를 스폰할 수 있습니다. NetworkObject를 스폰하면 자동으로 해당 클라이언트에게 StateAuthority가 할당

입력 권한 (Input Authority)

• 입력 권한은 메서드에 클라이언트의 PlayerRef를 전달하여 특정 클라이언트에게 할당(선택 사항)
• 입력 권한이 부여된 클라이언트는 객체에 대한 입력 데이터를 제공 / (Host나 Server와 함께) GetInput()에서 그 입력 구조를 조회 가능
• 객체에 입력이 필요 없거나 입력 권한을 가진 클라이언트가 없는 경우, null 전달

OnBeforeSpawned

NetworkRunner.OnBeforeSpawned 매개변수는 델리게이트에 맞는 메서드나 람다식을 받을 수 있음

public delegate void OnBeforeSpawned(NetworkRunner runner, NetworkObject obj);

이 델리게이트는 객체가 생성된 후, 모든 인스턴스에 동기화되기 전에 호출됩니다. 이를 통해 호출자는 시스템의 다른 부분이 객체에 접근하기 전에 추가적인 사용자 정의 초기화를 수행할 수 있습니다. 커스텀 네트워크 속성을 초기화하는 데 적합한 위치입니다.

private void MySpawnFunction() {
    Runner.Spawn(
        _objPrefab,
        Vector3.zero,
        Quaternion.identity,
        inputAuthority: null,
        InitializeObjBeforeSpawn,
        predictionKey: null
    );
}

private void InitializeObjBeforeSpawn(NetworkRunner runner, NetworkObject obj) {
    var objSB = obj.GetComponent<ObjSimulationBehaviour>();
    objSB.InitializeObjSettings(_currentExplosionForce);
}

람다 식을 사용하여 더 많은 매개변수를 전달할 수도 있습니다.

private void MySpawnFunction() {
    Runner.Spawn(
        _objPrefab,
        Vector3.zero,
        Quaternion.identity,
        inputAuthority: null,
        (Runner, NO) => NO.GetComponent<MyCustomBehaviour>().Init(myInt, myParameter),
        predictionKey: null
    );
}

Spawned

ISpawned.Spawned()는 NetworkRunner가 NetworkObject를 연결한 직후 호출
Spawned() 콜백은 Fusion의 Awake()에 해당 (객체가 연결되고 유효한 상태)

NetworkBehaviour는 빈 가상 Spawned() 메서드를 가진 ISpawned 인터페이스를 구현
(커스텀 NetworkBehaviour에 대해 Spawned()를 구현하려면 Spawned()를 오버라이드)

Spawned()에서 State Authority에서 Networked Property 값을 변경하면, 모든 다른 피어에서 그 NetworkObject의 모든 인스턴스에 대한 초기 값 설정
BUT 원격 피어는 항상 State Authority와 같은 Tick에서 객체를 생성하지 않을 수 있음(Area of Interest, Interest Management, 지연 입장, 우선순위 지정 등으로 인해)
→ NetworkObject가 State Authority보다 나중의 Tick에 원격으로 생성될 때는, State Authority가 해당 나중의 Tick에 가진 값으로 생성

• State Authority를 가진 피어에서의 생성은 Runner.Spawn() 호출 직후에 Spawned()가 호출
• Non-State Authority 피어에서는 NetworkRunner가 네트워크 상태를 받아서 로컬에 존재하지 않는 NetworkObject를 생성
  → NetworkRunner에 연결되기 전에 NetworkObject를 초기화해야 하는 경우, Runner.Spawn()에 제공된 OnBeforeSpawned 콜백 사용

IAfterSpawned

IAfterSpawned.AfterSpawned()는 NetworkObject의 배치가 완료되고 모든 ISpawned.Spawned() 콜백이 끝난 후 호출
Fusion의 Start()에 해당 NetworkBehaviour가 다른 NetworkBehaviour에서 값을 가져오거나 설정할 때, 실행 순서에 대한 걱정 없이 이 콜백을 사용

Despawn

네트워크 객체를 제거하려면, 객체에 대한 State Authority를 가진 피어가 Runner.Despawn() 호출 가능

Despawned

Runner.Spawn()이 ISpawned를 구현한 클래스에서 Spawned() 메서드 호출을 트리거하는 것처럼, Despawn()은 IDespawned를 구현한 클래스에서 Despawned() 메서드를 호출