这是本文档旧的修订版！

其它协议功能

网络协议使用json格式，根据 cmd 区分指令类型。以下协议是设备端默认处理好的，服务器需要适配终端。若需要播报机终端适配服务器端的协议，需要评估工作量，并收取一定的开发费。

另外，因流量卡流量有限，有些指令不需要频繁发送。尽量节省流量。服务器与终端联调之前，请先用 mqtt.fx 连接上服务器，确保 mqtt 服务器端没有问题。再介入音箱设备。

获取设备信息

字段	类型	必选	取值说明
cmd	字符串	是	指令名称，固定取值：“getinfo”
msgid	字符串	否	消息ID，若当前消息ID与上一个消息ID相同，则认为是同一个消息，终端不重复执行。建议用带时间戳的编号赋值。
full	整形	是	数值为:1

示例：服务器下发：

{"cmd":"getpara", "full":1,"msgid":"201d32010263030034"}

终端回复：

{
    "cmd": "getpara",
    "sn": "TEST001",
    "imei": "863586888311150",
    "imsi": "460042712831115",
    "iccid": "89860407111980351047",
    "volume": "2",
    "batt": 4207,
    "poweron": "欢迎使用智能收款播报云音响",
    "poweroff": "谢谢使用",
    "verno": "EC230905.1.0.1",
    "signal": 28
}

获取设备位置

字段	类型	必选	取值说明
cmd	字符串	是	指令名称，固定取值：“getloc”
msgid	字符串	否	消息ID，若当前消息ID与上一个消息ID相同，则认为是同一个消息，终端不重复执行。建议用带时间戳的编号赋值。

示例：服务器下发：

{"cmd":"getloc", "msgid":"202010260003"}

设备端回复：

{
        "cmd":"getloc",
        "sn": "TEST001",
        "lbs":[
                {"lac":"120600609","mnc":"0","rssi":"18","mcc":"460","cid":"29601"},
                {"lac":"252332421","mnc":"0","rssi":"18","mcc":"460","cid":"29601"},
                {"lac":"121619222","mnc":"0","rssi":"16","mcc":"460","cid":"29601"},
                {"lac":"98152263","mnc":"0","rssi":"15","mcc":"460","cid":"29601"},
                {"lac":"252332422","mnc":"0","rssi":"17","mcc":"460","cid":"29601"},
                {"lac":"13706903","mnc":"0","rssi":"8","mcc":"460","cid":"29601"}
              ]
    }

字段	类型	必选	取值说明
cmd	字符串	是	指令名称，固定取值：“getloc”
sn	字符串	是	设备编号
lbs	Json数组	是	可用于获取经纬度的lbs数据

设置设备参数

字段	类型	必选	取值说明
cmd	字符串	是	指令名称，固定取值：“setting”
msgid	字符串	否	消息ID，若当前消息ID与上一个消息ID相同，则认为是同一个消息，终端不重复执行。建议用带时间戳的编号赋值。
poweron	字符串	否	设备开机铃声，中文字符编码必须是 UTF8 编码，若poweron=““，则清空设置，使用默认铃声
poweroff	字符串	否	设备关机铃声，中文字符编码必须是 UTF8 编码，若poweroff=”“，则清空设置，使用默认铃声

示例：服务器下发：

{"cmd":"setting","poweron":"欢迎使用万能收款播报机", "poweroff":"谢谢使用","msgid":"202010260002"}

终端回复:

{"cmd":"setting","sn": "TEST001","poweron":1,"poweroff":1,"volume":1}

字段	类型	必选	取值说明
cmd	字符串	是	指令名称，固定取值：“setting”
sn	字符串	是	设备编号
poweron	整形	否	1-开机铃声设置成功，0-开机铃声设置失败
poweroff	整形	否	1-关机铃声设置成功，0-关机铃声设置失败
volume	整形	否	1~8 - 音量设置成功，返回对应音量等级

LCD显示屏二维显示

字段	类型	必选	取值说明
cmd	字符串	是	指令名称，固定取值：“display”
times	整形	否	当前界面显示的秒数。0 表示常亮
data	字符串	是	二维码的内容
x	整形	是	取值范围 0~320。10000 表示居中显示
y	整形	是	取值范围 0~240。10000 表示居中显示
w	整形	是	二维码显示的宽度。不能大于屏幕尺寸240
color	整形	是	16位的RGB565颜色值，取值范围0~65535。RGB888换算成RGB565算法：RGB值第一个字节取高五位，第二个字节取高六位，第三个字节取高五位。比如颜色为粉色，RGB888值为(255, 101, 230)，换算成RGB565值为64316（0XFB3C）

示例：服务器下发：

{
    "cmd":"display",
    "times":0, 
    "ui":[
        {"data":"二维码显示","x":40,"y":80,"w":32,"color":65535}
    ]
}

扫码数据上传

字段	类型	必选	取值说明
cmd	字符串	是	指令名称，固定取值：“qrcode”
sn	字符串	是	设备SN号，唯一标志一个设备的 ID
data	字符串	是	摄像头识别的二维码内容 base64 编码。服务器接收到该消息后，需要base64解码才能得到二维码内容。
msgid	字符串	是	由上传的时间年月秒时分组成。

示例：服务器上传：

{"cmd":"qrcode","sn":"TEST001","data":"二维码内容base64编码","msgid":"20240716103030"}

文档中心

目录

其它协议功能

获取设备信息

获取设备位置

设置设备参数

LCD显示屏二维显示

扫码数据上传

文档中心

用户工具

站点工具

目录

其它协议功能

获取设备信息

获取设备位置

设置设备参数

LCD显示屏二维显示

扫码数据上传

页面工具