指南针
显示方位角(0~360°,正北为 0)。
界面上有什么
- 一个会转的罗盘
- 可选的启用开关
两种数据来源,方向相反
在组件设置里有一个“来源”选项:
| 来源 | 谁提供方位 | 字段方向 | 典型场景 |
|---|---|---|---|
sensor(默认) | 手机的地磁计 | 页面 → 设备 | 用手机当遥控器,指向哪设备就往哪转 |
protocol | 设备上报 | 设备 → 页面 | 设备上装了电子罗盘,手机只负责显示 |
选错了方向,会出现“页面一直在发、设备不理”或者“设备一直发、页面不动”。
字段
| 字段 | 类型 | 说明 |
|---|---|---|
heading | 数字 | 方位角,0~360 |
en | 布尔 | 是否启用 |
和设备的约定
来源 = sensor
text
页面 → 设备:heading:90 (手机指向东)
设备收到后执行动作,不需要回传来源 = protocol
text
设备 → 页面:heading:90 (设备测得方位)
设备自己决定多久发一次,建议变化超过 2° 再发- 手机地磁计容易受干扰,读数会抖,建议取平均后再发
- 设备端不要“回推”sensor 模式的方位,会造成页面抖动
常见错误
| 现象 | 原因 |
|---|---|
| 页面在发,设备不动 | 设备没实现 heading 的处理 |
| 页面不动,设备在发 | 来源选成了 sensor,应该是 protocol |
| 方位一直乱跳 | 手机靠近磁铁/金属,或设备上报太频繁 |
| 差 90° / 180° | 安装方向或坐标系约定不同,需要固定一个基准 |
