这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
4g手持语音播报器其它协议功能 [2024/08/01 05:18] xuxubin [获取设备信息] |
4g手持语音播报器其它协议功能 [2024/08/27 12:23] (当前版本) xuxubin [二维码扫码数据上传] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== 其它协议功能 ====== | + | ====== 其它数据协议功能 ====== |
- 网络协议使用json格式,根据 cmd 区分指令类型。以下协议是设备端默认处理好的,服务器需要适配终端。若需要播报机终端适配服务器端的协议,需要评估工作量,并收取一定的开发费。 | - 网络协议使用json格式,根据 cmd 区分指令类型。以下协议是设备端默认处理好的,服务器需要适配终端。若需要播报机终端适配服务器端的协议,需要评估工作量,并收取一定的开发费。 | ||
- | 另外,因流量卡流量有限,有些指令不需要频繁发送。尽量节省流量。服务器与终端联调之前,请先用 mqtt.fx 连接上服务器,确保 mqtt 服务器端没有问题。再介入音箱设备。 | + | 另外,因流量卡流量有限,有些指令不需要频繁发送。尽量节省流量。服务器与终端联调之前,请先用 mqtt.fx 连接上服务器,确保 mqtt 服务器端没有问题。再介入音箱设备。发送uft8时,请使用网络进行发送,有些应用软件可能中文编码不正确。 |
====== 获取设备信息====== | ====== 获取设备信息====== | ||
行 106: | 行 105: | ||
- | ====== 扫码数据上传 ====== | + | ====== |
|字段 ^ 类型 ^ 必选 ^ 取值说明 ^ | |字段 ^ 类型 ^ 必选 ^ 取值说明 ^ | ||
行 112: | 行 111: | ||
^ sn | 字符串 | 是 | 设备SN号,唯一标志一个设备的 ID | | ^ sn | 字符串 | 是 | 设备SN号,唯一标志一个设备的 ID | | ||
^ data | 字符串 | 是 | 摄像头识别的二维码内容 base64 编码。服务器接收到该消息后,需要base64解码才能得到二维码内容。 | | ^ data | 字符串 | 是 | 摄像头识别的二维码内容 base64 编码。服务器接收到该消息后,需要base64解码才能得到二维码内容。 | | ||
- | ^ msgid | 字符串 | 是 | 消息ID,若当前消息ID与上一个消息ID相同,则认为是同一个消息,终端不重复执行。建议用带时间戳的编号赋值。 | | + | ^ money | 字符串 | 是 | 键盘输入收费的金额 | |
+ | ^ msgid | 字符串 | 是 | 由上传的时间年月秒时分组成。 | | ||
+ | ^ goods | 字符串 | 否 | 扫条形码商品时每件物品的信息,如扫了几次等。 | | ||
示例: | 示例: | ||
服务器上传: | 服务器上传: | ||
< | < | ||
- | {" | + | {" |
+ | </ | ||
+ | |||
+ | ====== 条形扫码数据上传 ====== | ||
+ | |||
+ | |字段 ^ 类型 ^ 必选 ^ 取值说明 ^ | ||
+ | ^ cmd | 字符串 | 是 | 指令名称,固定取值:“barcode” | | ||
+ | ^ sn | 字符串 | 是 | 设备SN号,唯一标志一个设备的 ID | | ||
+ | ^ data | 字符串 | 是 | 条型码扫码识别的内容 base64 编码。服务器接收到该消息后,需要base64解码才能得到二维码内容。 | | ||
+ | ^ msgid | 字符串 | 是 | 由上传的时间年月秒时分组成。 | | ||
+ | |||
+ | 示例: | ||
+ | 服务器上传: | ||
+ | < | ||
+ | {" | ||
+ | </ | ||
+ | |||
+ | |||
+ | ====== 条形码信息数据下传 ====== | ||
+ | |||
+ | |字段 ^ 类型 ^ 必选 ^ 取值说明 ^ | ||
+ | ^ cmd | 字符串 | 是 | 指令名称,固定取值:“goods” | | ||
+ | ^ barcode | 字符串 | 是 | 商品的条形码,注意不需要进行base64加密 | | ||
+ | ^ id | 整形 | 是 | 商品在服务器端的ID号,每个商品应该有独立的ID号 | | ||
+ | ^ msgid | 字符串 | 是 | 由上传的时间年月秒时分组成。 | | ||
+ | ^ title | 字符串 | 是 | 商品名称。注意必须为uft8编码 | | ||
+ | ^ price | 字符串 | 是 | 商品价格,目前只支持到小数点第二位,即“分” | | ||
+ | ^ title | 字符串 | 否 | 设备编号 | | ||
+ | |||
+ | |||
+ | 示例: | ||
+ | 服务器下传: | ||
+ | < | ||
+ | {" | ||
</ | </ | ||
+ | **注意:每一次扫码开始后,如果出现相同两件商品时,设备将在从服务器获取商品信息,而直接使用之间的扫码信息结果。** | ||