Skip to content

指南针 ​

显示方位角(0~360°,正北为 0)。

界面上有什么 ​

  • 一个会转的罗盘
  • 可选的启用开关

两种数据来源,方向相反 ​

在组件设置里有一个“来源”选项:

来源谁提供方位字段方向典型场景
sensor(默认)手机的地磁计页面 → 设备用手机当遥控器,指向哪设备就往哪转
protocol设备上报设备 → 页面设备上装了电子罗盘,手机只负责显示

选错了方向,会出现“页面一直在发、设备不理”或者“设备一直发、页面不动”。

字段 ​

字段类型说明
heading数字方位角,0~360
en布尔是否启用

和设备的约定 ​

来源 = sensor

text
页面 → 设备:heading:90     (手机指向东)
设备收到后执行动作,不需要回传

来源 = protocol

text
设备 → 页面:heading:90     (设备测得方位)
设备自己决定多久发一次,建议变化超过 2° 再发
  • 手机地磁计容易受干扰,读数会抖,建议取平均后再发
  • 设备端不要“回推”sensor 模式的方位,会造成页面抖动

常见错误 ​

现象原因
页面在发,设备不动设备没实现 heading 的处理
页面不动,设备在发来源选成了 sensor,应该是 protocol
方位一直乱跳手机靠近磁铁/金属,或设备上报太频繁
差 90° / 180°安装方向或坐标系约定不同,需要固定一个基准