본문으로 건너뛰기

[Client]

[Client] 속성은 해당 메서드를 클라이언트에서만 실행할 수 있도록 지정합니다.

주요 특징

  • 클라이언트에서만 실행됩니다
  • 서버에서 호출하면 경고가 발생합니다
  • Unity의 게임 루프 메서드(Start, Update 등)와 일반 메서드에서 모두 사용할 수 있습니다
  • 상속받은 메서드에서 사용할 경우 override 메서드에도 속성을 명시해야 합니다

사용 예시

기본 사용법

public class PlayerController : NetworkBehaviour
{
[Client]
void Update()
{
// 클라이언트에서만 실행되는 로직
// 예: 플레이어 입력 처리
if (Input.GetKeyDown(KeyCode.Space))
{
Jump();
}
}

[Client]
private void Jump()
{
// 점프 관련 로직
// 실제 이동은 Command를 통해 서버에 요청
}
}

상속된 메서드에서 사용

public abstract class BasePlayer : NetworkBehaviour
{
[Client]
protected virtual void HandleInput()
{
// 기본 입력 처리 로직
}
}

public class SpecificPlayer : BasePlayer
{
[Client]
protected override void HandleInput()
{
base.HandleInput();
// 추가 입력 처리 로직
}
}

상태 검사와 함께 사용

public class PlayerUI : NetworkBehaviour
{
[Client]
private void UpdateUI()
{
// 클라이언트 체크
if (!isClient)
{
Debug.LogWarning("UI 업데이트는 클라이언트에서만 가능합니다");
return;
}

// UI 업데이트 로직
UpdateHealthBar();
UpdateAmmoDisplay();
}

private void UpdateHealthBar()
{
// 체력바 업데이트 로직
}

private void UpdateAmmoDisplay()
{
// 탄약 표시 업데이트 로직
}
}
노트
  1. [Client] 속성이 있는 메서드는 클라이언트에서만 실행되어야 하는 로직을 포함해야 합니다.
  2. 실제 게임 상태 변경은 [Command]를 통해 서버에 요청해야 합니다.
  3. UI 업데이트, 입력 처리, 시각/음향 효과 등이 대표적인 사용 예시입니다.