组件指令

Lvzhou edited this page Apr 18, 2018 · 7 revisions

组件指令

app与设备间的通信指令都采用json格式,所有指令都以\n(换行符)结尾。
在你不了解这些指令的情况下,也可以使用blinker库进行设备开发。
这个文档主要用于开发那些blinker还不支持的设备。

手机震动

设备向app发送:

震动一秒

{“vibrate”:1000}

值为时间,单位毫秒

手机姿态

设备向app发送:

开启ahrs输出

{“ahrs”:”on”}

关闭ahrs输出

{“ahrs”:”off”}

app向设备发送:
开启ahrs输出功能后,手机会输出ahrs数据

{“ahrs”:[332,16,-77]}

位置获取

设备向手机发送:

{"gps":"get"}

手机将会返回当前手机所在位置的经纬度信息,格式如下:

{"gps":[103.907156,30.573667]}

文字组件

文字组件有两个作用:
1.显示用户自定义文本
做文本显示时,只需要app上设置即可
2.显示设备发送到app的数据
文字组件都有一个key,如上key为”text-abc”,key可以在app上设置。
设备向app发送:

{“text-abc”:”Text”}

当app接收上以上数据时,会将key为”text-abc”的文字组件内容刷新为”Text”。

按键组件

轻触按键:

{"btn-abc":"tap"}

说明key为"btn-abc"的按键被触发。

按下未放开

{"btn-abc":"press"}

释放按键

{"btn-abc":"pressup"}

开关组件

轻触开关打开,app将向设备发送:

{"tog-abc":"on"}

轻触开关关闭,app将向设备发送:

{"tog-abc":"off"}

设备可以向app发送同样的指令,改变app上按键的显示状态,如:

{"tog-abc":"on"}

app会将key为"tog-abc"的开关组件切换为打开状态。

滑动条组件

拖动滑动条,手机将向设备发送:

{"ran-abc":101}

"ran-abc"为滑动条的key,用户可自定义,101为具体数值。
设备可以向app发送同样的指令,改变app上滑动条的显示状态,如:

{"ran-abc":255}

app会将key为"tog-abc"的滑动条组件的滑块调整到255位置。
滑动条数值范围为0~255。

摇杆组件

拖动摇杆,app将向设备发送:

{"joy":[208,255]}

摇杆拉到左下角发送的数据为:

{"joy":[0,0]}

摇杆拉到右上角发送的数据为:

{"joy":[255,255]}

释放摇杆,摇杆会归到中心位置,发送的数据为:

{"joy":[128,128]}

摇杆组件的key是"joy",不可更改。

调试组件

设备向app发送的数据将被显示到调试组件中。

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.