这是本文档旧的修订版！

其它协议功能

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

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

获取设备信息

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

示例：服务器下发：

{"cmd":"getinfo", "msgid":"202010260004"}

终端回复：

{
    "cmd": "getinfo",
    "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 - 音量设置成功，返回对应音量等级

文档中心

目录

其它协议功能

获取设备信息

获取设备位置

设置设备参数

文档中心

用户工具

站点工具

目录

其它协议功能

获取设备信息

获取设备位置

设置设备参数

页面工具