> ## 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 Node 檢查節點圖，不會發送動作指令。`EyeController.inspect(node)` 回報候選圖形觀察資訊，而非眼球位置。

## 實體控制

手動嘴部及頭部寫入會拋出 `MotionUnavailableError`；眼球動作則沒有手動 SDK 介面。未來如需啟用實體控制，須先建立裝置專屬限制、控制仲裁、停止機制及受監督的硬體驗收。不能因為沒有觀察到競爭節點，就推論操作安全。


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