先解决「能不能连」
权限与蓝牙是硬前置;扫描无结果则保留可执行的下一步,而不是只显示一句空话。
说明 Android 12+ 的附近设备权限;主行动是去系统设置,并解释为何应用内不再弹窗。
开启蓝牙后自动续扫;权限与定位保持通过状态,避免让用户误以为要全部重来。
扫描 15 秒后停止;给出重新扫描与修改名称前缀两个动作,并提示检查设备占用。
连接过程要可解释
五步进度、就绪自检、自动重连、SN 未就绪——同一套步骤语言,失败时停在具体一步。
建立 GATT → 订阅数据 → 系统配对 → 校验身份 → 同步配置;已完成、进行中、待执行三态分明。
链路、订阅、配置三项自检全部通过;主行动直接进入地图,次行动保留断开出口。
断线原因、倒计时、第几次重试与步骤回退同屏;明确「最多 3 次」,不做无限重试。
已连接但身份未知:所有下行命令与配置项禁用,拿到 SN 后自动解除,不需要重进页面。
地图上的空态与降级
没有目标、没有定位基准、图源缺 Key:三者都保留地图本体,只替换说明层与可用动作。
设备就绪但目标为 0;显示侦测中、覆盖范围与最后扫描时间,避免被误判为断连。
手机未授权且设备北斗未定位;绝对位置照常显示,距离字段显示「--」并标注来源。
天地图置灰并给出「缺 Key」标记;说明 Key 清空时自动回退高德电子图,避免空白底图。
记录与设备操作的空档
没有历史时引导去连接;重启期间解释数据暂停与自动重连,不让用户误以为设备失联。
时间筛选保留;说明记录产生条件(连接、目标、轨迹点)与 30 天本地保留策略。
回执后主动断开、GATT 刷新、6 秒倒计时重连;明确历史与白名单不会丢失。