菜鸟云打印 商家自定义打印 蓝牙便携式

感谢老哥@简书老哥 https://www.jianshu.com/u/bbbc27343adb

因为碰到的坑蛮多的。

20190603

• 在蓝牙便捷打印的环境下，主要的还是在模板编辑器上面，蓝牙便捷自定义区域，仅仅支持 ISV 服务端登陆模板编辑器里的 ISV 预设自定义区。保存发布之后，拿到 url 在发送的数据里面渲染模板即可。
  我是预设自定义区
  value 设置错误的话或者是模板有问题的话 渲染的接口会报未知错误或者其他错误，这个时候就要检查是否是模板问题，或者可以删除掉模板，新建一个在做测试。我在对接的时候就是因为模板里面多了一个空的 layout，在代码编辑里面删除也行的

• 全部流程

1.1.isv账号 登录模板编辑器，选择身份为isv

1.2.新建一个isv预设自定义区，进入模板编辑页面

1.3.以文本打印为例，选择文本元素，排版分为横排和竖排，具体内容分为静态文本和动态文本。

  1.3.1在value里面输入要打印的文本；别名是在模板编辑页面显示的名称，不是打印的内容。

  1.3.2静态文本直接在右侧value中输入要打印的固定内容。

  1.3.3动态文本在value中输入固定格式<%=\_data.XXX%>，其中XXX为变量名。(\_data.XXX,前面的反斜杠去掉，机器人呼出的时候自动加的转义符)

1.4.编辑好isv预设自定义区后，先保存，再发布。

1.5.在模板列表页有复制isv预设自定义区url，打印的时候，传入正确的数据和模板url即可打印

参考和注意

1. 菜鸟API

• 没什么需要注意的地方 参看流程图 我是流程图

2. 便携式蓝牙打印对接说明

• 主要在模板渲染的接口调用的时候花费不少时间 CLOUDPRINT_CMD_RENDER ，注意传输的数据格式和模板是否有误： 两个数据 key 都是 printData ，下面的是我自定义区的模板链接和数据
  我是模板渲染的报文格式

3. 模板设计说明

• 这里我只用到了变量引用:

1. 这里的模板格式还是 _data.xxx 传输过去的是 printData
   以“<%=”开始，以“%>”结束，如“<%=_data.address%>”，表示将会用data.address的实际值在模板中进行填充。允许使用自定义的变量