개발자 프리뷰 / 하드웨어 미검증: X3 하드웨어와 실제 로봇에 배포된 실행 환경은 아직 검증되지 않았습니다. 로컬 테스트만으로 장치 호환성, 물리적 동작 또는 안전한 운용을 보장할 수 없습니다.
오프라인 준비와 관찰
MouthController.prepare(ratio)는 0에서 1 사이의 유한한 정규화 비율을 검증하고 데이터를 오프라인으로 준비합니다. HeadController.prepare_rpy(roll, pitch, yaw)는 라디안 단위의 유한한 숫자 입력을 검증하고 오프라인 데이터를 준비합니다. 이러한 검사는 기계적 동작 범위나 안전한 자세를 입증하지 않습니다.
컨트롤러의 inspect(node) 메서드는 호출자가 소유한 ROS 노드로 그래프를 조사하며 움직임 명령을 보내지 않습니다. EyeController.inspect(node)는 눈 위치가 아닌 후보 그래프 관찰 결과를 제공합니다.
물리적 제어
입과 머리의 수동 쓰기 명령은MotionUnavailableError를 발생시킵니다. 눈을 수동으로 제어하는 SDK 인터페이스는 없습니다. 향후 물리적 제어를 허용하려면 장치별 제한, 제어권 조정, 정지 동작 및 감독하의 하드웨어 수락 검증이 먼저 필요합니다. 경쟁 노드가 발견되지 않았다는 이유로 안전하다고 판단하지 마세요.