dsh-hos-scrcpy

LIMITATIONS

Known limitations

- **多设备与 AI**：AI 工具只认"当前聚焦（面板可见）"的那台设备；没有聚焦设备（都没投屏、或聚焦的那台断开了）时，工具会直接返回"先投屏/已断开"的错误，不会替你猜一台 - **同一台手机别用两种连着**：同一台机器同时以 USB 和 TCP 出现在设备列表里时，两行是同一台设备，多设备测试请用不同的手机 - **文本输入**：`hos_scrcpy_input`（AI）与面板「输入」按钮需先让目标输入框获得焦点（先用 `hos_scrcpy_tap` 点一下输入框），再注入文本；系统输入法未内建，部分 App 对注入文本的输入法兼容性可能影响输入结果 - **控件定位**：`hos_scrcpy_locate` 只对原生 ArkUI/鸿蒙控件有效；H5 / 游戏 / 自绘画面布局树匹配不到时，可先 `hos_scrcpy_screenshot` 看画面，再用 `hos_scrcpy_tap` 以比例坐标点击 - **坐标体系**：所有点击/长按用当前画面的**比例坐标(0..1)**，非设备物理像素；小目标（页签/图标）定位 x 偶有偏差，建议确认落点绿点后再放行 - **编码参数**：有线/无线帧率可调；画质（无线固定 1/4）、码率（固定为"不覆盖 SDK 自身设置"）、关键帧间隔（固定 2000ms）是插件写死的——实测 SDK 会对自己收到的码率数值再做一次换算（填 8000000 会变成约 512Mbps），没弄清单位前不去动它 - 仅支持鸿蒙设备；安卓暂不支持 - **模拟器不支持投屏**：鸿蒙模拟器上 SDK 起不来投屏服务（设备侧缺媒体引擎库，日志报 `can not find scrcpy pid`，一帧都没有），投屏请用真机 - 会话内 `cordis_define` 加载方式随 DSH 进程重启失效，需重新定义；插件包方式不受此限制 - 画面静止时 SDK 不推帧，前端会提示"请持续滑动手机更新画面"（正常行为，非故障）