Network Project Config - cheona-thousand-man/Unity-myBasics-Wiki GitHub Wiki

개요

Photon Fusion 프로젝트에 영향을 미치는 다양한 정보와 매개변수를 포함하는 asset

• Version
• Peer Mode
• Default Player Count
• Network Condition Testing
• Encryption
• Prefab Inspection

Fusion Version

• 현재 사용 중인 Fucion Version 나열

Scene Setting

• Peer Mode
  • Single 서버, 호스트, 클라이언트 Peer를 단일 빌드 또는 에디터에서 실행하는 일반적인 사용 사례
  • Multiple 에디터에서 다중 Peer 허용
    • 피어 모드를 Multiple로 설정하면 빌드를 만들 필요 없이 게임 세션 내에서 여러 피어를 테스트하는 데 유용

지연 보상(Lag Compensation)

• 1인칭 슈팅 게임과 같은 빠른 속도의 게임에 유용
• 게임의 HitBox 스냅샷 세트를 저장하여 수행
  • 서버 모드 or 호스트 모드에서만 사용 가능
  • Hitbox Buffer Length In MS 히트박스 데이터가 밀리초 단위로 저장될 버퍼의 길이를 지정. 시간이 길수록 히트박스 스냅샷이 새 스냅샷으로 덮어쓰여지기 전에 더 오래 저장
  • Hitbox Defaulr Capacity 스냅샷당 저장되는 히트박스 값의 기본 수(최소값은 16)
  • Cached Static Colliders Size 기본 지연 보상 쿼리의 캐시된 정적 콜라이더(PhysX 또는 Box2D) 배열의 크기

Miscellaneous

• 불완전한 동기 스폰 대기열에 추가(Enqueue Incomplete Synchronous Spawns)
  활성화하면, 동기 불완전 스폰(Addressables 등)이 예외를 발생시키는 대신 대기열에 추가됩니다. 대신 Fusion.NetworkSpawnStatus.Queued를 반환하고 객체 스폰 시도가 다음 프레임에 발생합니다
• 배치 모드에서 렌더 호출(Invoke Render In Batch Mode)
  활성화하면 Fusion.SimulationBehaviour.Render 콜백이 배치 모드에서 게임을 플레이할 때 호출됩니다. 배치 모드는 Unity 빌드 실행 파일에 전달될 수 있는 -batchmode 매개변수를 나타냅니다. 이를 비활성화하면 배치 모드에서 실행되는 헤드리스 서버를 사용하는 게임에 유용할 수 있습니다
• 네트워크 ID가 객체 이름(Network Id Is Object Name)
  체크하면 새로 스폰된 객체의 이름에 네트워크 ID가 포함되도록 다음과 같이 수정: {[Network Id] 원래 객체 이름}
• 네트워크 객체 비활성 가드 숨기기(Hide Network Object Inactivity Guard)
  NetworkObjects 내에 중첩된 NetworkObjectInactivityGuard라는 이름의 GameObject가 활성화되기 전에 파괴된 NetworkObjects의 OnDestroy 메시지를 추적합니다. 이 옵션을 체크하면 이러한 가드가 계층 구조에 표시되지 않습니다

Simulation

• Replication Features
  • None 기본 설정이며 게임 플레이 중에 틱당 데이터 한도를 초과하지 않는 경우 이상적
  • Scheduling 서버가 클라이언트에게 네트워크 객체를 복제하지 않았을 때(데이터 틱 한도에 도달했기 때문) 서버는 해당 네트워크 객체의 우선순위를 다음 Tick 업데이트로 증가시킴
  • Scheduling and Interest Management 스케줄링 외에도 관심 관리(Area of Interest 및 Explicit Interest) 기능 활성화
• Input Transfer Mode 입력이 네트워크를 통해 전송되는 방식 결정
  • Redundancy 델타 압축 및 중복 입력을 전송하며, 대부분의 게임에 사용
  • Latest State 최신 입력 상태만 전송하며, 이는 머리와 손의 위치 데이터를 자주 포함하는 VR과 같은 대형 입력 구조체를 사용하는 게임에 유용
• Player Count 1에서 255까지 범위 내에서 새 Fusion 세션을 시작할 때 기본으로 사용되는 플레이어 수

"다음 설정은 공유 모드(Shared Mode)에는 적용되지 않으며, 공유 모드에서는 클라이언트 Tick 레이트가 항상 32이고 클라이언트 전송 레이트가 항상 16입니다"

• Client Tick Rate 드롭다운을 통해 8에서 256까지의 값을 선택 가능
• Client Send Rate 클라이언트가 서버로 데이터를 전송하는 속도
  • 1/8 클라이언트 Tick 레이트가 240 이상인 경우에만 적용
  • 1/4 클라이언트 Tick 레이트가 4로 나누어 떨어지는 경우에만 적용
  • 1/2
  • 1:1 클라이언트 Tick 레이트와 동일한 값
• Server Tick Rate 서버가 업데이트되는 속도로, 클라이언트 전송 레이트와 동일한 선택지
• Server Send Rate 서버가 다른 클라이언트에게 데이터를 전송하는 속도로, 클라이언트 전송 레이트와 동일한 선택지를 가지지만 서버 틱 레이트보다 높을 수 없음

네트워크 (Network)

• 연결 시간 초과 (Connection Timeout)
  업데이트를 받지 못하면 연결이 끊어지기까지 걸리는 시간(초)입니다. 서버는 해당 클라이언트로부터 업데이트를 받지 못하면 클라이언트와의 연결을 끊고, 클라이언트는 서버로부터 업데이트를 받지 못하면 서버와의 연결을 끊습니다.
• 연결 종료 시간 (Connecting Shutdown Time)
  연결 상태가 종료로 변경된 후 연결 및 관련 참조가 해제되기까지의 시간(초)입니다.
• 신뢰할 수 있는 데이터 전송 모드 (Reliable Data Transfer Modes)
  신뢰할 수 있는 데이터 전송 모드를 결정합니다.
  • Client to Server
    클라이언트에서 서버로 데이터를 신뢰할 수 있게 전송할 수 있습니다.
  • Client to Client With Server Proxy
    서버를 프록시로 사용하여 클라이언트 간 데이터를 신뢰할 수 있게 전송할 수 있습니다.

호스트 마이그레이션 (Host Migration)

• 자동 업데이트 활성화 (Enable Auto Update)
  체크하면 호스트 마이그레이션이 자동으로 업데이트됩니다.
• 업데이트 지연 (Update Delay)
  호스트 마이그레이션 스냅샷이 Photon Cloud에 업로드되는 간격 시간(초)입니다.

암호화 (Encryption)

이 토글은 이 Fusion 프로젝트에 대해 암호화를 활성화하거나 비활성화할지를 설정합니다.

네트워크 조건 (Network Conditions)

네트워크 조건을 통해 사용자들은 지연 및 손실과 같은 다양한 네트워크 조건을 시뮬레이션하고 테스트할 수 있습니다.

• 활성화됨(Enabled) 체크하면 더 많은 옵션이 나타납니다.
• 지연 형태(Delay Shape) 지연 변동의 패턴을 설정
  • Noise
  • Sine
  • Square
  • Triangle
  • Saw
  • Reverse Saw
• 지연 최소값(Delay Min) 최소 지연 시간(초), 0에서 0.5까지의 범위.
• 지연 최대값(Delay Max) 최대 지연 시간(초), 0에서 0.5까지의 범위.
• 지연 주기(Delay Period) 지연이 Delay Min과 Delay Max 사이에서 변동하는 주기(초).
• 지연 임계값(Delay Threshold) 변동이 이 값 아래로 떨어지면(0에서 1 사이) 지연이 Delay Min으로 설정됩니다.
• 추가 지터(Additional Jitter) 변동기가 다음 지연 값을 결정한 후, 0에서 이 값 사이의 임의의 값(초 단위)이 지연에 추가됩니다.
• 손실 확률 형태(Loss Chance Shape) 손실 변동의 패턴을 설정합니다. 선택지는 지연 형태와 동일합니다.
• 손실 확률 최소값(Loss Chance Min) 손실이 발생할 최소 확률 값, 0(0%)에서 1(100%)까지의 범위.
• 손실 확률 최대값(Loss Chance Max) 손실이 발생할 최대 확률 값, 0(0%)에서 1(100%)까지의 범위.
• 손실 확률 임계값(Loss Chance Threshold) 변동이 이 값 아래로 떨어지면(0에서 1 사이) 지연이 Loss Chance Min으로 설정됩니다.
• 손실 확률 주기(Loss Chance Period) 손실 확률이 Loss Chance Min과 Loss Chance Max 사이에서 변동하는 주기(초).
• 추가 손실(Additional Loss) 변동기가 다음 손실 확률 값을 결정한 후, 추가로 0에서 이 값 사이의 임의의 값(정규화된 손실 확률 비율)이 손실 확률에 추가됩니다.

손실(Loss)은 지연 시간(초) 대신, 0%에서 100% 사이의 손실 확률을 시뮬레이션하기 위해 값을 결정하는 거의 동일한 설정을 가집니다.

힙 (Heap)

사용자들이 Fusion에서 사용할 사전 할당된 메모리 양을 정의할 수 있도록 하여 메모리 관리 최적화 및 효율성 향상을 돕습니다.

• 페이지 쉬프트(Page Shift) 각 힙 페이지의 크기를 결정하여 메모리 할당의 세밀도에 영향을 미칩니다. 1 KB에서 256 KB까지 2의 제곱수로 설정됩니다. 더 낮은 쉬프트는 더 작은 메모리 할당을, 더 높은 쉬프트는 더 큰 할당을 허용합니다.
• 페이지 수(Page Count) 힙을 위해 할당된 초기 페이지 수를 지정합니다. 16에서 4096까지의 범위로, 힙에 할당된 페이지 수와 초기 메모리 할당량에 영향을 줍니다.

위버 설정 (Weaver Settings)

다음은 Assembly-CSharp.dll에 저수준 네트워크 코드를 생성하고 삽입하는 Fusion IL Weaver에 영향을 미치는 설정입니다.

• 위빙할 어셈블리(Assemblies to Weave) 위빙될 어셈블리의 목록입니다. 대소문자를 구분하지 않습니다. 기본적으로 다음이 포함됩니다
  • Fusion.Unity
  • Assembly-CSharp
  • Assembly-CSharp-firstpass
  • Fusion.Addons.Physics (프로젝트가 Fusion의 물리 시스템을 사용하는 경우)
• 직렬화된 사전 사용(Use Serialized Dictionary) 체크하면 Fusion.SerializeableDictionary가 네트워크 속성의 초기 값을 저장하는 데 사용됩니다. 체크하지 않으면 weaver는 System.Generic.Dictionary를 사용합니다. 이 유형은 Unity에서 직렬화할 수 없지만, Odin과 같은 커스텀 직렬화기는 이를 지원할 수 있습니다. 네트워크 속성에 대한 null 검사(Null Checks for Networked Properties): 설정하면 weaver는 Networked 속성이 있는 모든 Fusion.NetworkBehaviour에 연결된 Fusion.NetworkObject가 있는지 확인하는 검사를 추가합니다.
• RPC 속성 사용 검사(Check Rpc Attribute Usage) 설정하면 weaver는 Fusion.RpcAttribute가 지원하지 않는 유형에서 사용되는지 확인합니다. 예를 들어, Fusion.RpcAttribute가 Unity.MonoBehaviour 메서드에 추가되고 이 옵션이 체크된 경우, RPC는 Fusion.NetworkBehaviour 및 Fusion.SimulatedBehaviours에만 추가될 수 있다는 경고가 기록됩니다. 그러나 모든 유형을 스캔해야 하므로 위빙 및 스크립트 컴파일 시간이 증가할 수 있습니다.
• 비어 있는 네트워크 속성 검사(Check Networked Properties Being Empty) 체크하면 사용자가 Fusion.NetworkedAttribute를 잘못 정의하려고 할 때 경고를 받습니다. 이러한 속성의 getter와 setter는 다음과 같이 비어 있어야 합니다

[Networked]
public int NetworkedProperty {get; set;}

프리팹 (Prefabs)

이 두 가지 설정은 프리팹이 어떻게 언로드되는지 처리합니다

• 마지막 인스턴스 해제 시 프리팹 언로드(Unload Prefab On Releasing Last Instance) true로 설정하면, 마지막 인스턴스가 해제될 때 프리팹이 언로드됩니다.
• 종료 시 프리팹 언로드(Unload Prefabs On Shutdown) true로 설정하면, 종료 시 모든 프리팹이 언로드됩니다.

프리팹을 더 이상 필요하지 않게 되면 언로드하면 메모리 사용량이 개선될 수 있지만, 다시 필요할 경우 재로드해야 합니다.

자동 생성 (Auto-Generated)

이 섹션은 자동으로 생성된 정보를 보여줍니다.

• 네트워크 프리팹 검사기 표시(Show Network Prefab Inspector) 이 버튼을 클릭하면 창이 열리며, Fusion.NetworkObject 컴포넌트를 포함하고 Fusion.NetworkObject.IsSpawnable이 활성화된 프로젝트의 다양한 프리팹을 볼 수 있습니다.
• 프리팹(Prefabs) 앞서 언급한 버튼 아래에는 프로젝트의 NetworkObject 프리팹 목록이 드롭다운 리스트로 표시됩니다. 이 목록은 사용자가 직접 업데이트할 수 없지만, 추가 프리팹은 런타임에서 Fusion.NetworkPrefabTable.TryAddSource를 통해 등록할 수 있습니다.
• 행동 메타(Behaviour Meta) 프로젝트의 모든 Fusion.SimulationBehaviours에 대한 메타 정보를 자동으로 생성하여 목록화한 것입니다. 실행 순서와 같은 정보를 포함합니다.

네트워크 프리팹 검사기(Network Prefabs Inspector)

앞서 언급한 바와 같이, 네트워크 프리팹 검사기를 사용하면 Fusion.NetworkObject 컴포넌트를 포함하고 Fusion.NetworkObject.IsSpawnable이 활성화된 프리팹을 자세히 검사할 수 있습니다.

• 네트워크 프리팹 검사기 예시 네트워크 프리팹 검사기의 예시 뷰입니다

이 창의 주요 툴바에는 다음과 같은 기능이 있습니다

• 새로 고침(Refresh) 리스트를 새로 고치고 새로운 프리팹이 추가된 경우 업데이트합니다
• 선택 동기화(Sync Selection) 켜지면, Unity는 창에서 강조된 프리팹 자산을 선택합니다
• 로드된 항목만(Loaded Only) 켜지면, 현재 로드된 프리팹만 표시됩니다

각 행은 다른 프리팹을 나타내며, 이 창의 각 열은 다음을 표시합니다

• 상태(State) 프리팹이 현재 로드되었는지 여부를 표시합니다
• 유형(Type) 이 객체가 어떤 종류의 프리팹인지, 즉 어떻게 로드될 것인지에 대해 설명합니다
• R Resources 폴더에 배치된 프리팹
• SL Resources 폴더 외부에 배치된 정적 프리팹
• A 주소 지정 가능한 프리팹 (화면에는 표시되지 않음)
• PrefabId Fusion에서 프리팹에 할당한 ID
• 경로(Path) 프리팹의 파일 경로