Files
MyCharacterAgent/Assets/02_Scripts/Character/ProceduralIdle.cs
2026-08-26 03:39:36 +09:00

135 lines
5.0 KiB
C#

using UnityEngine;
/// <summary>
/// 애니메이션 클립 없이 T포즈를 자연스러운 대기 자세로 바꾼다.
///
/// 왜 필요한가: VRM 은 모델만 담고 애니메이션은 담지 않는다. 사용자가 임의의 VRM 을
/// 넣는 구조에서는 클립이 딸려 온다는 보장이 없으므로, 최소한의 대기 자세는
/// 코드로 만들어 두어야 한다. 나중에 실제 클립을 넣으면 이 컴포넌트를 끄면 된다.
///
/// 구현 노트 1: 본의 로컬 축은 리그마다 제각각이라 로컬 오일러로 돌리면 모델에 따라
/// 엉뚱하게 꺾인다. 캐릭터 루트의 축을 기준으로 월드 회전을 덧씌워 리그에 무관하게 만든다.
///
/// 구현 노트 2: VRM 컨트롤 리그는 Vrm10Instance.LateUpdate 에서 실제 본으로 반영되므로
/// 그보다 먼저 실행돼야 한다. HeadLookAt 과 같은 이유로 실행 순서를 앞당긴다.
/// </summary>
[DefaultExecutionOrder(-100)]
public class ProceduralIdle : MonoBehaviour
{
[Header("참조")]
[Tooltip("비우면 자식에서 자동 탐색")]
[SerializeField] Animator animator;
[Header("팔 내리기 (T포즈 해소)")]
[Tooltip("위팔을 몸쪽으로 내리는 각도. 70 전후가 자연스럽다")]
[Range(0f, 90f)]
[SerializeField] float upperArmDown = 70f;
[Tooltip("아래팔을 조금 더 내려 팔이 늘어지게 한다")]
[Range(0f, 40f)]
[SerializeField] float lowerArmDown = 10f;
[Tooltip("팔을 몸에서 살짝 띄운다. 0 이면 몸에 붙는다")]
[Range(0f, 20f)]
[SerializeField] float armOutward = 5f;
[Header("호흡")]
[SerializeField] bool breathing = true;
[Tooltip("가슴이 오르내리는 각도")]
[Range(0f, 5f)]
[SerializeField] float breathAmplitude = 1.2f;
[Tooltip("한 번 호흡하는 데 걸리는 시간(초)")]
[SerializeField] float breathPeriod = 4f;
[Header("체중 이동")]
[SerializeField] bool weightShift = true;
[Tooltip("좌우로 기우는 각도")]
[Range(0f, 5f)]
[SerializeField] float swayAmplitude = 1.2f;
[Tooltip("한 번 왕복하는 데 걸리는 시간(초). 호흡과 주기를 다르게 해야 기계적으로 안 보인다")]
[SerializeField] float swayPeriod = 7f;
Transform root;
Transform hips, chest, leftUpperArm, rightUpperArm, leftLowerArm, rightLowerArm;
float phaseOffset;
void Awake()
{
root = transform;
if (animator == null) animator = GetComponentInChildren<Animator>();
if (animator == null || !animator.isHuman)
{
Debug.LogWarning("[ProceduralIdle] 휴머노이드 Animator 가 없어 비활성화합니다.");
enabled = false;
return;
}
hips = animator.GetBoneTransform(HumanBodyBones.Hips);
chest = animator.GetBoneTransform(HumanBodyBones.Chest)
?? animator.GetBoneTransform(HumanBodyBones.Spine);
leftUpperArm = animator.GetBoneTransform(HumanBodyBones.LeftUpperArm);
rightUpperArm = animator.GetBoneTransform(HumanBodyBones.RightUpperArm);
leftLowerArm = animator.GetBoneTransform(HumanBodyBones.LeftLowerArm);
rightLowerArm = animator.GetBoneTransform(HumanBodyBones.RightLowerArm);
// 여러 캐릭터가 있어도 동시에 같은 박자로 숨쉬지 않게 한다.
phaseOffset = Random.Range(0f, 100f);
}
void LateUpdate()
{
ApplyArms();
ApplyBody();
}
/// <summary>
/// T포즈에서 팔은 좌우로 뻗어 있다. 캐릭터의 forward 축을 중심으로 돌려 내린다.
/// 왼팔은 -right 방향이라 +각도, 오른팔은 +right 방향이라 -각도가 아래로 향한다.
/// </summary>
void ApplyArms()
{
RotateArm(leftUpperArm, +upperArmDown, +armOutward);
RotateArm(rightUpperArm, -upperArmDown, -armOutward);
// 위팔을 돌리면 아래팔도 따라오므로, 여기서는 추가분만 얹는다.
RotateArm(leftLowerArm, +lowerArmDown, 0f);
RotateArm(rightLowerArm, -lowerArmDown, 0f);
}
void RotateArm(Transform bone, float downAngle, float outwardAngle)
{
if (bone == null) return;
Quaternion delta = Quaternion.AngleAxis(downAngle, root.forward);
if (!Mathf.Approximately(outwardAngle, 0f))
{
delta = Quaternion.AngleAxis(outwardAngle, root.up) * delta;
}
bone.rotation = delta * bone.rotation;
}
void ApplyBody()
{
float t = Time.time + phaseOffset;
if (breathing && chest != null && breathPeriod > 0.01f)
{
float breath = Mathf.Sin(t * Mathf.PI * 2f / breathPeriod);
chest.rotation = Quaternion.AngleAxis(-breath * breathAmplitude, root.right) * chest.rotation;
}
if (weightShift && hips != null && swayPeriod > 0.01f)
{
float sway = Mathf.Sin(t * Mathf.PI * 2f / swayPeriod);
hips.rotation = Quaternion.AngleAxis(sway * swayAmplitude, root.forward) * hips.rotation;
}
}
}