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

개요

• NetworkObject 컴포넌트를 가진 GameObject
• 룸(Room) 내에서 단일 네트워크 엔티티
• Spawning이나 Scene Object 로딩으로 생성

NetworkId

• NetworkId 서버에서 NetworkObject 컴포넌트에 할당하는 Room 내 고유 정수 식별자
• 모든 Peer 간 일관성 / 네트워크에서 Object 참조에 사용

Spawning Network Objects

Object가 서버에 생성되고, Network Object & State가 연관된 모든 Peer에게 복제

• Runner.Spawn() 호출
  • NetworkObject 컴포넌트가 있는 GameObject 생성
  • Spawn 액션이 네트워크에 복제
  • (Runner.StartGame()에 전달된) INetworkObjectProvider 인스턴스화 된 Prefab, 기존 객체 복제, 코드로 새로운 사용자 Object 생성, Pool에서 객체 가져오기 등 spawned Object 구현 포함
• Network Object가 포함된 Scene 로드

A. Runner.Spawn()으로 NetworkObject 생성

• [Host Mode] 서버에서만 호출
• [Shared Mode] 생성된 객체의 상태 권한을 가질 클라이언트에서 호출
• 호출 시,
  • 지정된 Prefab 인스턴스화
  • NetworkObject 컴포넌트 NetworkRunner에 연결
  • 연관된 모든 Client에 복제

B. Prefab / Object Table

• Prefab의 네트워크 Spawn을 위해서는 Fusion에 등록 필요
  • 일반적으로 Fusion toolset에서 Prefab 자동 감지/등록
  • Unity Inspector에서 NetworkProjectConfig에서 Rebuild Object Table을 눌러 감지 작업 수동 트리거

C. 런타임 시 NetworkBehaviour 추가/제거

• Network Object Spawn 이후 NetworkBehaviour 추가/제거 불가
• Spawn 이전 NetworkBehaviour을 런타임에서 추가/제거 가능
  • NetworkObject 네트워킹 사용 준비(bake)
    • NetworkBehaviour 유효성 검사
    • Rpc 및 콜백 등록
    • 네트워킹 데이터 구조 생성
    • Prefab 정보 저장
  • INetworkObjectProvider 구현을 통해 인스턴스화

Scene Network Object 로드

• ISceneManager 인스턴스로 Scene 로드
  • Scene 내 활성화된 NetworkObject 서버(Server Mode) or 마스터 클라이언트(Shared Mode)에 첨부
  • [Server/Master Client] 각 Scene Object에 할당된 NetworkId가 모든 Client에 전달
  • [Client] 로드된 Scene Objcet 첨부 & NetworkId 할당

첨부(Attaching)

• Attaching when NetworkObject Spawn or Load with Scene
  • Network Object에 NetworkId 할당
  • NetwrokBehaviour 컴포넌트의 네트워크 속성을 위한 메모리 할당
  • 모든 관련된 NerworkBehaviour를 초기화 하는 과정
• After attaching
  • Network Object는 모든 자식 NetworkBehaviour에서 Spawned() 호출
  • 이후 Network Object 유효함 → 네트워크 속성 / Rpc 메서드 접근 가능
  • FixedUpdateNetwork() / Render() 같은 모든 관련 이벤트 메서드&인터페이스 호출 시작

State Authority

• PlayerRef에 의해 모든 Attached Network Object has (명시적or암시적) State Authority
• [Runner.StateAuthority == PlayerRef.None] 서버 Peer가 암시적 State Authority 보유

A. 서버 모드(Host/Dedicated/Single)

• Runner.StateAuthority == PlayerRef.None(서버가 항상 상태 권한 보유)
• 상태 권한 변경 불가

B. 공유 서버 모드

NetworkObject.StateAuthority는 유효한 PlayerRef

• 상태 권한은 할당 불가
  • (현재 상태 권한이 있더라도)플레이어는 상태 권한을 다른 플레이어에게 할당 불가
• 상태 권한은 획득 가능
  • 플레이어의 Object.RequestStateAuthority() 호출로 권한 획득 시도 가능
• RequestStateAuthority() 성공 조건(둘 중 하나)
  • NetworkObject.AllowStateAuthorityOverrider == ture
  • 이전 상태 권한 소유자가 Object.ReleaseStateAuthority()를 호출한 경우

C. Input Authority

• 서버 모드(Host/Dedicated/Single)에서만 적용(공유 서버 모드 적용X)
• GetInput() 호출 시, 해당 객체에 대해 반환될 Player 입력

D. NetworkObject의 [Networked] Property에 대한 접근 권한 설정

GetComponent().Flags |= NetworkObjectFlags.MasterClientObject;

• 호스트-클라이언트 모드 Host만 해당 오브젝트에 있는 [Networked] 속성 읽기/쓰기 권한 보유
• 공유 모드 Master Client만 해당 오브젝트에 있는 [Networked] 속성 읽기/쓰기 권한 보유
• 일반 클라이언트 Local Client는 해당 오브젝트에 있는 [Networked] 속성 읽기 권한만 보유 / non-Networked 속성의 경우 로컬 인스턴스별로 변경가능

Replication(복제)

• when NetworkObject attached
  • 각 Tick과 함께 시뮬레이션
  • State Authority는 결과 상태를 다른 모든 Peer에게 복제

Interest Management

• NetworkObject 복제 대상 Player 제한 가능
  • Area Of Interest를 활용한 특정 Player Object 업데이트 제외

Netsting(중첩)

• NetworkObject 충접 지원
  • NetworkObject가 계층 구조에서 다른 Object의 자식이 되는 것

주요 속성/프로퍼티/메서드

1. 속성

• NetworkId Id The unique identifier for this network entity.
• NetworkRunner Runner The NetworkRunner this entity is associated with.

2. 프로퍼티

• HasInputAuthority[get] Returns if Simulation.LocalPlayer is the designated Input Authority for this network entity.
• HasStateAuthority[get] Returns if Simulation.LocalPlayer is the designated State Authority for this network entity.
• IsValid[get] Returns if this network entity is associated with its NetworkRunner, and that runner is not null.
• Name[get] The ID + Unity GameObject name for this entity.
• PlayerRef StateAuthority[get] Returns the PlayerRef that has State Authority over this network entity. PlayerRefs are assigned in order from 0 to MaxPlayers-1 and are re-used as players join and leave. The only caveat is that the server player (if one exists), always gets the last index no matter how many clients are connected.

3. 메서드

• ReleaseStateAuthority ()
• RemoveInputAuthority () Removes input authority from whichever player has it for this object. Only valid when called on a Host or Server peer.
• RequestStateAuthority ()