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

• Player NetworkRunner를 가진 Peer
• [Dedicared Server가 아닌 경우] Fusion에 Player Input 제공

• PlayerRef Player Peer에 대한 Input을 제공할 수 있는 NetworkRunner의 고유 식별자
  • Plyer 식별자로만 사용되며, Player 특정 데이터를 포함X

1. Game Session에 동시에 연결될 수 있는 최대 플레이어 수
2. 기본 최대 PlayerCount는 NetworkProjectConfig asset 내 Simulation > Default Players에서 전역적으로 정의
3. [새 Game Session 생성 시] NetworkRunner.StartGame()에 전달된 nullable StartGameArgs.PlayerCount 값에 의해 결정
   (StartGameArgs.PlayerCount가 값이 할당되지 않을 경우(null) 새 Game Session은 NetworkProjectConfig의 기본 플레이어 수를 사용)

Dedicated Server는 PlayerRef를 가지지 않으며 플레이어로 간주되지 않으므로 PlayerCount 한도에 포함되지 않습니다.
ex) PlayerCount == 4인 Game Session은 다음을 지원

• 1 Host와 3 Clients
• 1 Dedicated Server와 4 Clients
• 4 Shared Mode 클라이언트

1. Player Object Game Session에서 PlayerRef를 특정 NetworkObject Avatar(캐릭터)와 연결하는 방법
2. 각 PlayerRef는 하나의 NetworkObject와 연관
3. 이 연관은 네트워크를 통해 모든 Client에 자동으로 복제
4. PlayerRef ↔ NetworkObject 연관은 NetworkRunner.SetPlayerObject(PlayerRef, NetworkObject) 메서드로 설정

• [Host & Server 모드] Player Object는 Host/Server만 설정 가능
• [Shared 모드] Player가 자신의 Player Object 연관만 설정 가능 / 해당 Player는 연관된 NetworkObject에 대한 State Authority 보유

어떤 Peer라도 NetworkRunner.TryGetPlayerObject(PlayerRef, out NetworkObject) 메서드를 통해 특정 PlayerRef와 연관된 NetworkObject 검색 가능

// INetworkRunnerCallbacks 인터페이스에 있는 기본 구현 콜백 OnPlayerJoined()
// 플레이어가 합류할 때, 플레이어 객체를 생성하고 정의합니다.
void OnPlayerJoined(PlayerRef player, NetworkRunner runner) {
    if (Object.HasStateAuthority == false) return;

    var plObject = runner.Spawn(PlayerObjectPrefab);
    var plData = plObject.GetComponent<PlayerData>();

    // SetData는 해당 NB에 대해 PlayerRef와 생명량을 정의합니다.
    plData.SetData(player, 3);

    runner.SetPlayerObject(player, plObject);
}

// 필요할 때, 플레이어 객체를 가져옵니다.
int GetPlayerLife(PlayerRef player) {
    if (Runner.TryGetPlayerObject(player, out var plObject)) {
        return plObject.GetComponent<PlayerData>().Lifes;
    }

    Debug.LogError("Player Object Not found");
    return 0;
}

1. NetworkObject는 StateAuthority로 PlayerRef와 연관
2. StateAuthority는 Networked Properties와 같은 NetworkObject의 상태를 제어
3. StateAuthority에서 Networked Property에 대한 변경 사항은 네트워크를 통해 다른 클라이언트에 복제

• Host/Server 모드 항상 서버/호스트가 상태 권한을 가지며, 게임 상태에 대한 권한을 가진 플레이어X
• Shared 모드 권한이 분산되어 플레이어 간에 공유
  • 상태 권한이 할당되지 않았거나 NetworkObject에 Allow StateAuthorityOverride가 true로 설정된 경우, 어떤 플레이어라도 상태 권한을 가질 수 있음
  • 객체가 스폰될 때 상태 권한이 할당될 수 있으며, NetworkObject.ReleaseStateAuthority() 및 NetworkObject.RequestStateAuthority()를 호출하여 권한을 변경 가능

[Share/Host 모드] NetworkObject는 입력 권한을 가질 수 있음

• 플레이어는 여러 NetworkObjects에 대해 입력 권한 보유 가능
• 플레이어가 NetworkObject에 대해 입력 권한을 가지고 있을 때,
  • 해당 Object에 대한 입력을 전송 가능
  • 서버는 특정 객체에 대한 입력을 찾을 때 이를 수신
  • Client → Server 주요 통신 방식

게임이 단일 NetworkRunner에서 여러 로컬 물리적 플레이어를 허용하는 경우(예: 온라인 플레이어와 결합된 소파 협동 게임),

• Fusion의 'Player' 개념과는 독립적으로 로컬 플레이어를 구분하는 게임 특정 로직이 필요
• 여러 로컬 플레이어의 모든 입력은 Fusion의 입력 시스템으로 통합
• 하나의 네트워크 입력 구조체를 사용하여 모든 로컬 플레이어 입력에 대한 데이터 포함

여러 로컬 플레이어를 사용하는 경우, SetPlayerObject 또는 OnPlayerJoined와 같은 PlayerRef에 의존하는 함수를 사용할 때 추가적인 사용자 정의 로직이 필요합니다.