AzurPilot for Android
Android 版不是「手機端的精簡版」——它把完整的核心程序（含 Python 3.14、依賴、OCR 模型、前端）裝進 APK，通過 PRoot 在免 Root 環境下運行，再用虛擬熒幕把遊戲放到後台。
兩種完全不同的用法
| 模式 | 遊戲跑在哪 | 本機 Runtime | 權限 | 適用 |
|---|---|---|---|---|
| 本地運行 | 手機上 | 需要 | 需要內置 ADB / Root 啟用 | 沒有電腦，或用舊手機專職掛機 |
| 遠程客戶端 | 其他機器上 | 不需要 | 不需要 | 用手機查看、控制家裏電腦的實例 |
不要混淆
遠程客戶端模式不會啟動本機 Runtime，也不需要 Shizuku。它是把 AzurPilotGateway 指向另一個實例的固定入口，複用原生控制台。詳見作為遠程客戶端。
分層結構
| 層 | 技術 | 職責 |
|---|---|---|
| App 殼層 | Kotlin + Compose (Material / Miuix) | 介面、Runtime 部署、網關訂閲、懸浮窗 |
| PRoot | jniLibs 九件套 | 免 Root 的系統調用映射 |
| Runtime | Ubuntu 24.04 + Python 3.14 | 上游核心程序與 WebUI |
| 特權服務 | app_process + AIDL + JNI | 虛擬熒幕、截圖、觸控注入 |
| OCR 工作進程 | :ocr 獨立進程 | 推理 API（127.0.0.1:22302） |
三個進程邊界：
- 主進程：Compose UI、配置、網關。
-
:ocr：承載 LiteRT / MNN 推理庫，崩潰不影響主介面。 - 特權進程：通過內置 ADB、Shizuku 或 root 拉起，持有虛擬顯示與原生橋。
能力清單
| 能力 | 説明 |
|---|---|
| 後台虛擬熒幕 | 遊戲在獨立 Virtual Display 運行，主熒幕可正常使用 |
| 懸浮控制 | 全局浮窗啟停任務、看隊列、滾日誌 |
| 內置控制台 | 設備端完整 WebUI，無需電腦 |
| OCR 硬件加速 | 高通 QNN、聯發科 NeuroPilot、海思 HiAI；失敗回退 CPU |
| 幀通道 | 匿名共享記憶體 + SCM_RIGHTS，實測 15.6 ms（TCP 47.2 ms） |
| 熒幕保護防燒屏 | 黑色低亮度，30 秒後每 10 秒上下漂移 16dp |
| 雙軌更新 | APK 與 Runtime 獨立；腳本可事務級熱更 |
| 日誌匯出 | 宿主與業務日誌分離，7 天輪轉，一鍵打包 |
環境要求
| 維度 | 最低 | 推薦 |
|---|---|---|
| 系統 | Android 9.0（API 28） | Android 12–15 |
| 架構 | ARM64-v8a / x86_64 | 同上 |
| 存儲 | 2.5 GB 可用 | 5 GB |
| 記憶體 | 4 GB | 6 GB 以上 |
| 權限 | 內置 ADB 配對 / Root / 外部 Shizuku | 內置 ADB |
32 位設備不支援。x86_64 主要用於模擬器；真機幾乎都是 ARM64。
安裝包怎麼選
| 包 | 內含 Runtime | 首次啟動 | 適用 |
|---|---|---|---|
| 完整版 APK | 是 | 本地解壓縮 1–3 分鐘，無需聯網 | 首次安裝，推薦 |
| 輕量增量 APK | 否 | 下載約 1 GB Runtime | 已裝過完整版，只更新宿主代碼 |
輕量包覆蓋安裝不會重新解壓縮 Runtime，配置與實例保留。
介面
| 頁面 | 內容 |
|---|---|
| 主頁 | Runtime 狀態、下載/解壓縮、啟動與停止 |
| 掛機 | 畫面推流、實例、開始/停止 |
| 控制台 | 內嵌 WebUI |
| 日誌 | 宿主與業務日誌、匯出 |
| 設定 | 外觀、下載源、保活、OCR、熒幕保護、遠程 |
深色主題與 Material / Miuix 兩套外觀都受支援。截圖見 控制台、懸浮窗與熒幕保護。