NavoX Android 4.1 · Cloud API v2

手機操作，
NavoX 回應。

Android App 使用原生介面，透過 navoai.io 的 API 查看狀態、控制動作及對話。NavoX 主動連接雲端，所以手機與機器人可以位於不同網路，不需要設定路由器連接埠轉發。

下載原生 Android App 4.0.0（測試版 APK） · SHA-256

登入與連接

安裝 App，使用原先綁定 NavoX 的 Google 或 ChatGPT 帳號登入。授權在系統瀏覽器完成，接著返回 App。
已經綁定的 NavoX 會出現在裝置清單。全新裝置請選「新增 NavoX」，掃描包裝 QR，透過熱點設定 Wi-Fi，再於 App 確認帳號綁定。
NavoX 上線後，從「控制」「夾取」「對話」開始操作；「更多」可查看任務、日誌、事件及個性設定。

Google 與 ChatGPT 是分開的帳號身分，Email 相同不會自動合併裝置。登入 ChatGPT 也不會自動提供 OpenAI API 額度。

App API

App 以 Authorization: Bearer 傳送登入權杖，回應 schema 為 navox.app.v2。所有裝置端點都核對擁有者，裝置的控制密鑰不會交給 App。AP 初始配網使用 Pi 的本地 JSON 介面。

GET    /api/robot/v2/me
GET    /api/robot/v2/devices
POST   /api/robot/v2/devices/register
POST   /api/robot/v2/claim
GET    /api/robot/v2/devices/{id}
POST   /api/robot/v2/devices/{id}/commands
GET    /api/robot/v2/devices/{id}/commands/{command_id}
GET    /api/robot/v2/devices/{id}/camera
GET    /api/robot/v2/devices/{id}/chat
GET    /api/robot/v2/devices/{id}/tasks
GET    /api/robot/v2/devices/{id}/settings
GET    /api/robot/v2/devices/{id}/events
GET    /api/robot/v2/devices/{id}/journal
DELETE /api/robot/v2/devices/{id}

原生登入採 PKCE：/app/auth/authorize、/app/auth/token、/app/auth/refresh 與 /app/auth/revoke 均位於 /api/robot/v2 下。授權完成只返回 navox://oauth/callback；APK 不內建登入密鑰。

指令與回報

先讀取裝置當次的 session_id，再傳送指令。同一操作使用固定 request_id；重新連線後，App 會取得新工作階段，不補執行舊動作。

{
  "request_id": "每次操作產生的 UUID",
  "session_id": "裝置目前的 session_id",
  "kind": "grasp",
  "args": {
    "target": "藍色水瓶"
  }
}

HTTP 202 表示已排隊。從 commands/{command_id} 讀取送達及執行回報；accepted、running、completed、failed、cancelled 分別代表已接收、執行中、裝置回報完成、失敗與取消。排入佇列不代表機械動作已成功。

control：同時傳送底盤、肩、肘與夾爪狀態，支援雙搖桿；arm、gripper 可做單次調整，stop 可停止動作。
grasp：指定物品，由 Pi 沿用影像辨識、尋找及夾取流程。vision.roi_grasp：手動標框，沿用追蹤流程。
chat.send、chat.history：文字或手機辨識後的語音訊息、對話回覆。task.list、task.cancel：進度與打斷。
settings.get、settings.update：個性、語音、自主與照護設定。follow.start／stop、dock.start／stop：跟隨與回充對位。
care.journal、care.ack、care.check_in：生活記錄、事件確認及關心訊息。

App 依裝置實際提供的 capabilities 啟用功能。硬體未就緒或任務失敗時，會呈現裝置回報；回充對位成功仍需充電硬體確認是否開始充電。

照片與手動標框

按「取得影像」時才請求單張照片。照片會固定供手指標框，座標依照片內容計算，不包含上下或左右留白。裝置移動或照片過期後，需要重新拍攝。

雲端照片只供擁有者讀取，最長可讀取 60 秒，到期後於後續資料交換或讀取時清理；照片不寫入長期指令紀錄。關閉影像、裝置重新連線或解除綁定後也會清除。這是可更新的照片預覽。

Pi 連線與本地功能

Pi 保留 /api/robot/v1/exchange 與獨立裝置權杖，既有網頁 API v1 也繼續使用。App 的 API v2 與原服務共用原本的馬達控制、夾取、對話及設定。