📔Utils - FreeLookCamera

MainCamera에 부착해서 사용

FreeLookCamera.cs

using UnityEngine;
using UnityEngine.InputSystem;

// MainCamera에 부착해서 사용합니다.
// WASD: 수평 이동 / Q·E: 수직 이동 / 마우스 우클릭 드래그: 시선 회전 / F: 초기 위치·각도 리셋

public class FreeLookCamera : MonoBehaviour
{
  // ===================================================================
  // Inspector 설정
  // ===================================================================

  [Header("초기 Transform")]
  public Vector3 initialPosition = new Vector3(0f, 5f, -12f);
  public Vector3 initialRotation = new Vector3(15f, 0f, 0f); // Euler 각도

  [Header("이동 설정")]
  public float moveSpeed = 10f;  // 기본 이동 속도
  public float moveSpeedBoost = 20f;  // Shift 누를 때 이동 속도
  public float moveSmoothing = 12f;  // 이동 보간 강도

  [Header("시선 회전 설정")]
  public float lookSensitivity = 0.3f; // 마우스 감도
  public float lookSmoothing = 16f;   // 회전 보간 강도
  public float pitchMin = -80f;
  public float pitchMax = 80f;

  // ===================================================================
  // 내부 상태
  // ===================================================================

  float _yaw;          // 현재 좌우 각도
  float _pitch;        // 현재 상하 각도
  float _targetYaw;
  float _targetPitch;

  Vector3 _velocity;         // 현재 이동 속도 벡터 (보간용)
  Vector3 _targetVelocity;   // 목표 이동 속도 벡터

  bool _isDragging;       // 우클릭 드래그 중 여부

  Mouse _mouse;
  Keyboard _keyboard;

  // ===================================================================
  // Unity 이벤트
  // ===================================================================

  void Start()
  {
    transform.position = initialPosition;
    transform.eulerAngles = initialRotation;

    _yaw = _targetYaw = initialRotation.y;
    _pitch = _targetPitch = initialRotation.x;

    _mouse = Mouse.current;
    _keyboard = Keyboard.current;
  }

  void Update()
  {
    // 장치 재연결 대비: 매 프레임 갱신합니다
    _mouse = Mouse.current;
    _keyboard = Keyboard.current;

    HandleLookInput();
    HandleMoveInput();
    HandleResetInput();

    ApplySmoothing();
  }

  // ===================================================================
  // 입력 처리
  // ===================================================================

  // 우클릭 드래그로 시선(Yaw·Pitch)을 조작합니다
  void HandleLookInput()
  {
    if (_mouse == null) return;

    if (_mouse.leftButton.wasPressedThisFrame) _isDragging = true;
    if (_mouse.leftButton.wasReleasedThisFrame) _isDragging = false;

    if (!_isDragging) return;

    Vector2 delta = _mouse.delta.ReadValue();

    _targetYaw += delta.x * lookSensitivity;
    _targetPitch -= delta.y * lookSensitivity;
    _targetPitch = Mathf.Clamp(_targetPitch, pitchMin, pitchMax);
  }

  // WASD·Q·E 키로 이동 방향 벡터를 계산합니다
  void HandleMoveInput()
  {
    if (_keyboard == null) return;

    // 입력 축 수집: -1 ~ 1 범위로 정규화합니다
    float h = (_keyboard.dKey.isPressed ? 1f : 0f) - (_keyboard.aKey.isPressed ? 1f : 0f);
    float v = (_keyboard.wKey.isPressed ? 1f : 0f) - (_keyboard.sKey.isPressed ? 1f : 0f);
    float u = (_keyboard.qKey.isPressed ? 1f : 0f) - (_keyboard.eKey.isPressed ? 1f : 0f);

    // 카메라 로컬 기준으로 이동 방향을 계산합니다
    // 수직 이동(Q·E)은 월드 Y축을 사용합니다
    Vector3 dir = transform.right * h
                + transform.forward * v
                + Vector3.up * u;

    // 방향 벡터 크기가 1을 초과하면 정규화해서 대각 이동 시 속도 증폭을 방지합니다
    if (dir.sqrMagnitude > 1f) dir.Normalize();

    // Shift 키: 고속 이동
    float speed = _keyboard.leftShiftKey.isPressed ? moveSpeedBoost : moveSpeed;

    _targetVelocity = dir * speed;
  }

  // F 키: 초기 위치·각도로 즉시 리셋합니다
  void HandleResetInput()
  {
    if (_keyboard == null) return;
    if (!_keyboard.fKey.wasPressedThisFrame) return;

    transform.position = initialPosition;
    transform.eulerAngles = initialRotation;

    _yaw = _targetYaw = initialRotation.y;
    _pitch = _targetPitch = initialRotation.x;

    // 잔류 속도 제거
    _velocity = Vector3.zero;
    _targetVelocity = Vector3.zero;
  }

  // ===================================================================
  // 보간 적용
  // ===================================================================

  void ApplySmoothing()
  {
    // 회전 보간
    _yaw = Mathf.LerpAngle(_yaw, _targetYaw, Time.deltaTime * lookSmoothing);
    _pitch = Mathf.LerpAngle(_pitch, _targetPitch, Time.deltaTime * lookSmoothing);
    transform.rotation = Quaternion.Euler(_pitch, _yaw, 0f);

    // 이동 보간 후 위치에 반영합니다
    _velocity = Vector3.Lerp(_velocity, _targetVelocity, Time.deltaTime * moveSmoothing);
    transform.position += _velocity * Time.deltaTime;
  }

  // ===================================================================
  // 기즈모
  // ===================================================================
#if UNITY_EDITOR
  void OnDrawGizmosSelected()
  {
    // 초기 위치를 에디터에서 확인할 수 있도록 표시합니다
    Gizmos.color = new Color(1f, 0.8f, 0f, 0.8f);
    Gizmos.DrawWireSphere(initialPosition, 0.3f);

    Gizmos.color = new Color(0.3f, 0.8f, 1f, 0.5f);
    Gizmos.DrawRay(initialPosition, Quaternion.Euler(initialRotation) * Vector3.forward * 2f);
  }
#endif
}