常见问题

SDK 连不上设备怎么办？

优先检查以下几项：

设备侧服务是否已经启动
wsSys / wsApp 地址与端口是否正确
是否已经等待 onAppAndSysCreate 回调完成
当前网络环境是否能访问设备

为什么很多方法会提示权限不足？

先不要直接怀疑 SDK。很多失败来自运行模式或权限未开启。

建议先检查：

android.auth.openMustPermissions(false)
android.auth.openAccessibilityService(false)
android.auth.openAllFile(false)
android.auth.openScreenCap(false)

Node.js 环境为什么不能直接跑？

SDK 默认偏浏览器环境。若在 Node.js 中运行，需要补齐以下对象或等价 polyfill：

window
document
Image
WebSocket

项目中的 test/test-all.mjs 与 test/test-toJson.mjs 可作为现成参考。

为什么节点相关方法经常依赖无障碍？

android.acc 模块依赖无障碍树，因此：

getWindows()
getNode()
findView()
node.toJson()
node.click()

这些能力在无障碍未开启时通常无法正常工作。