本地 API 访问

我们打造这样一件精美的机器人硬件，可不是为了把它锁在一个封闭的花园里。只要你知道怎么发一个 cURL 请求，或者写一段简单的 Python 脚本，OneMira 就完全为你敞开大门，任你把玩。

本地服务器

当 OneMira 连接到你的 Wi-Fi 时，它会在本地启动一个 Express 服务器。在使用 API 时，绝不涉及任何云端遥测或数据回传。

只需通过你的路由器或手机 App 找到 OneMira 的局域网 IP 地址（例如 192.168.1.100）。

所有请求都是向 8080 端口发送的 POST 请求。

示例：马达控制

想写个脚本，当你的智能门铃响时，让 OneMira 物理转头看向房门吗？

你可以向马达控制器传递绝对的 XYZ 坐标，或者相对的角度值。

curl -X POST http://192.168.1.100:8080/api/motors \
-H "Content-Type: application/json" \
-d '{
  "pan": 45,
  "tilt": -10,
  "speed": 0.8,
  "easing": "ease-in-out"
}'

示例：接管矩阵“眼睛”

正面的 LED“眼睛”是一个完全可寻址的 NeoPixel 阵列。你可以覆盖默认的 AI 眨眼行为，直接推送原始的 Hex 颜色数组。

我个人的用法是：根据我的 CI/CD 流水线状态，让这只眼睛闪烁特定的颜色（构建通过显示绿色，失败显示红色）。

curl -X POST http://192.168.1.100:8080/api/eye \
-H "Content-Type: application/json" \
-d '{
  "mode": "solid",
  "color": "#FF0000",
  "duration_ms": 5000
}'

因为完全是本地运行，延迟几乎为零。你可以用它写个番茄钟，做个物理通知指示灯，或者把它跟你正在播放的 Spotify 音乐同步。这台硬件，现在属于你了。