FIND YOUR NEXT MOVE
문서 탐색
ENGINEERING DOCUMENTATION

크라우치

몸을 낮추는 동작을 구분하고 Runner의 슬라이드로 연결합니다.

EXPERIMENTAL소스 검토 / 2026.09.09

목적과 상태

크라우치는 기존 엔진과 V3 연구에 구현되어 있습니다. Runner에서는 CrouchSlide()로 매핑합니다. 현재 기본 Demo Assist의 동작 조건을 이 페이지의 기존 임계값으로 대체해 설명하지 않습니다.

입력과 관절

기존 전면 2D 경로는 어깨·골반과 양쪽 발목 중심을 사용해 몸통 하강과 다리 수직 압축을 평가합니다. 무릎 각도는 이 기존 경로에서는 진입 또는 해제 조건이 아닌 진단 값입니다. V3의 상대 기하 경로는 무릎 변화와 현재 지지점 증거를 판단에 사용하므로 구분해야 합니다.

기존 정규화 특징

골반, 어깨, 몸통 중심의 하강을 보정 시 몸통 길이로 나눕니다. 다리 수직 압축도 같은 길이 기준을 사용합니다. 몸 전체가 영상에서 함께 이동하는 경우와 실제 몸의 압축을 구분하려는 목적입니다.

기존 변수기본값
CrouchHipDrop0.42
CrouchShoulderDrop0.30
CrouchTorsoCenterDrop0.36
CrouchLegVerticalCompression0.30
CrouchMaximumTorsoLeanDegrees20°
CrouchCandidateDurationSeconds0.12 s
CrouchReleaseDurationSeconds0.10 s

거리 값은 몸통 길이 비율입니다. 이 값은 V3의 확정 기준이 아닙니다.

V3의 상대 기하

CrouchRelativeFeatureExtractor는 에피소드 동안 고정된 로컬 정지 참조에 대해 어깨·골반의 지지점 방향 압축을 계산합니다. InitialCrouchDescent는 압축과 몸·골반·어깨 하강을 요구합니다. 확정에는 전체 압축, 일관된 하강, 의미 있는 무릎 변화와 지지점의 호환성 검사가 추가됩니다. 횡이동 중에는 더 강한 독립 크라우치 증거가 필요합니다.

상태와 재준비

READYCANDIDATECOMMITRECOVER
공통 흐름을 단순화한 개념도입니다. 실패한 후보는 취소되며, 재준비 조건을 충족해야 다시 시작합니다. 실제 상태 이름은 동작별 구현을 참고하세요.

기존 크라우치는 Started, Ended, Cancelled의 지속 동작입니다. V3는 하강 후보, 확정, 해제와 회복을 따로 관리합니다. 해제와 재준비를 새로운 크라우치로 다시 세면 안 됩니다. V3의 안정 해제 설정은 0.080 s, 회복 설정은 0.700 s이며 제품 반응 시간 보장이 아닙니다.

신뢰도와 오탐 위험

발 지점 누락, 앞으로 숙이기, 카메라에 가까워지는 변화, 좌우 동작의 상하 흔들림, 점프 전 준비 하강을 구분해야 합니다. 지지점은 영상상의 기준이며 실제 지면 접촉 센서가 아닙니다.

검증과 한계

CrouchV3DetectorTests와 관련 특징 구현을 확인했습니다. 테스트 존재를 현재 신체 수용으로 표시하지 않습니다. 전체 동작 준비 상태와 참조 잠금 한계는 알려진 한계에 남아 있습니다.