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

NetworkBehaviour는 Unity MonoBehaviour 클래스를 상속 받아 다음 기능 확장

• Runner 속성으로 관련된 NetworkRunner 참조
• Object 속성으로 관련된 NetworkObject 참조
• 네트워크 속성(Networked Properties) 처리
• Rpc(Remote Procedure Calls) 처리
• 가상 이벤트 콜백 Spawned(), Despawned(NetworkRunner runner, bool hasState), FixedUpdateNetwork(), Render()
• 흐름 제어를 위한 권한 별칭(Aliases for authority) HasStateAuthority, HasInputAuthority, IsProxy

개수 상관없이 NetworkObject와 그 자식 transform에 컴포넌트로 삽입 가능

NetworkBehaviour 인스턴스는 삽입된 NetworkObject의 상태(Networked Properties) 및 시뮬레이션(FixedUpdateNetwork())의 일부

• NetworkBehaviour 컴포넌트가 가진 고유한 네트워크 식별자
• 네트워크 속성 or RPC 참조를 위해 네트워크로 전송 가능

• NetworkBehaviour에서 정의된 [Networked] 특성을 가진 속성
• NetworkObject 상태 표현 → State Authority Peer에서 다른 모든 Peer에게 복제
• [Server Mode] 서버가 항상 State Authority
• [Shared Mode] Player가 State Authority
• 별도의 작업없이 자동 구현된 속성(빈 {get; set;} 형태)
• NetworkBehaiour가 Spawned() 호출된 이후부터 접근 가능

구현 추가를 위해 오버라이드 할 수 있는 가상 Lifecycle 이벤트 함수

• FixedUpdateNetwork() Unity의 FixedUpdate() 대신 사용 Fusion의 고정 시간 단계 콜백. Simulation Tick당 한 번 호출됩니다. 핵심 게임 로직의 시뮬레이션에 사용됩니다
• Spawned() Start() 대신 사용 NetworkObject가 NetworkRunner에 연결된 후 호출됩니다. 네트워크 오브젝트가 초기화되고 네트워크 속성과 RPC를 사용할 수 있게 된 후 호출됩니다
• Despawned(NetworkRunner runner, bool hasState) OnDestroy() 대신 사용 네트워크 오브젝트가 소멸되기 전에 호출됩니다
  • NetworkRunner runner 이 네트워크 오브젝트가 속해 있던 NetworkRunner
  • bool hasState 동작의 상태가 여전히 접근 가능한지 여부
• Render() Update() 대신 사용 시뮬레이션 프레임 렌더링 후 콜백. 모든 시뮬레이션 단계(FixedUpdateNetwork)가 끝난 후 실행됩니다

• 사용자 정의 simulation 코드 구현하는 메서드
  • 사용자 건강 상태 예제

public class Health : NetworkBehaviour
{
    // 네트워크 속성 정의
    [Networked] public int CurrentHealth { get; set; }

    public override void FixedUpdateNetwork()
    {
        // 건강 상태를 변경하는 시뮬레이션 코드
        if (Object.HasInputAuthority)
        {
            if (Input.GetKey(KeyCode.Space))
            {
                CurrentHealth--;
            }
        }
    }

    public override void Spawned()
    {
        // 초기화 코드
        CurrentHealth = 100;
    }

    public override void Despawned(NetworkRunner runner, bool hasState)
    {
        // 소멸 전에 실행되는 코드
        Debug.Log("Object despawned");
    }

    public override void Render()
    {
        // 렌더링 후 실행되는 코드
    }
}

• 문제 Fusion은 고정 Tick 기반 네트워킹 엔진이므로 Unity FixedUpdate()와 유사하게 처리
• 해결 by Render() 직전 Tick과 현재 Tick에서 시뮬레이션(처리)된 스냅샷(결과) 사이를 선형 보간(lerp)하여 부드러운 렌더링 처리

특정 타이밍 이벤트를 위한 이벤트 구현 가능

• IAfterSpawned
• IBeforeTick
• IBeforeAllTicks
• IAfterTick
• IAfterAllTicks
• IStateAuthorityChanged
• IPlayerJoined
• IPlayerLeft

RPC를 통해 메시지 핸들러 선언/구현 가능

• NetworekBehaviour를 상속받는 제네릭 클래스 생성 가능
• [Networked] 속성 or RPC 제네릭 기본 클래스 or 이를 상속받는 모든 클래스에서 정의/구현 가능
  • 가능한 경우

// This is VALID
class ValidGenericClass_With_NonGenericProperty<T> : NetworkBehaviour {
    [Networked] public int Prop { get; set; }
}

• 불가능한 경우: Networked 속성에 사용되는 자료형이 기본형 or NetworkBehaviour를 상속받은 클래스인지 알 수 없음

// This is INVALID
class InValidGenericClass_With_GenericProperty<T> : NetworkBehaviour {
    [Networked] public T Prop { get; set; }
}

• bool InvokeRpc

• NetworkBehaviourId Id[get] The unique identifier for this network behaviour.

• GetInput< T > (out T input) Returns true if it a valid INetworkInput can be found for the current simulation tick (Typically this is used in FixedUpdateNetwork).