> ## Documentation Index
> Fetch the complete documentation index at: https://docs.warmcore-tech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 머리·눈·입

> X3 SDK의 물리적 제어 상태

> **개발자 프리뷰 / 하드웨어 미검증:** X3 하드웨어와 실제 로봇에 배포된 실행 환경은 아직 검증되지 않았습니다. 로컬 테스트만으로 장치 호환성, 물리적 동작 또는 안전한 운용을 보장할 수 없습니다.

## 오프라인 준비와 관찰

`MouthController.prepare(ratio)`는 `0`에서 `1` 사이의 유한한 정규화 비율을 검증하고 데이터를 오프라인으로 준비합니다. `HeadController.prepare_rpy(roll, pitch, yaw)`는 라디안 단위의 유한한 숫자 입력을 검증하고 오프라인 데이터를 준비합니다. 이러한 검사는 기계적 동작 범위나 안전한 자세를 입증하지 않습니다.

컨트롤러의 `inspect(node)` 메서드는 호출자가 소유한 ROS 노드로 그래프를 조사하며 움직임 명령을 보내지 않습니다. `EyeController.inspect(node)`는 눈 위치가 아닌 후보 그래프 관찰 결과를 제공합니다.

## 물리적 제어

입과 머리의 수동 쓰기 명령은 `MotionUnavailableError`를 발생시킵니다. 눈을 수동으로 제어하는 SDK 인터페이스는 없습니다. 향후 물리적 제어를 허용하려면 장치별 제한, 제어권 조정, 정지 동작 및 감독하의 하드웨어 수락 검증이 먼저 필요합니다. 경쟁 노드가 발견되지 않았다는 이유로 안전하다고 판단하지 마세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.