# 问题解答
### 一、对接相关
* Q：对接过程中遇见问题怎么办？
* A：有问题不用怕，加QQ群：943741509，不定时技术人员回复问题！
<br>
* Q：V2接口返回`404`？请求接口偶尔失败？
* A：一、检查接口地址是否准确。二、检查是否添加DNS，文档请看[调用协议](调用协议.md)！
<br>
* Q：如何确认打印机设备设置成功？接口响应成功设备无响应？
* A：打印机设置接口：[离线或重启控制](离线或重启控制.md)、[打印控制](打印控制.md)、[logo控制](logo控制.md)、[音效音量控制](音效音量控制.md)、[内置语音控制](内置语音控制.md)、[接单拒单控制](接单拒单控制.md)、[关键词设置](关键词设置.md)、[高级设置](高级设置.md)，均会与打印机交互，交互过程打印机需要1s-2s的响应时间，切勿连续设置，会导致打印机设置失败。设置成功时打印机会出纸提示！！！
<br>
* Q：设置logo和图片打印url报错，img_url不能识别
* A：img_url中有`&`、`+` 需要进行url编码处理。
<br>
* Q：打印机图片打印接口打印怎么设置宽和高？
* A：修改原图尺寸。打印出来的尺寸由原图决定，8个像素点打印1毫米。
- 58打印机最大打印宽度48毫米，384个像素点。
- 80打印机最大打印宽度72毫米，576个像素点。
- K5、B1型号打印机最大打印宽度108毫米，864个像素点。
<br>
* Q：打印排版二维码、条形码、文字怎么并排放置？
* A：二维码、条形码等图形打印是固定居中的，如果需要并排放置，开发者自行合成一张BMP单色位图使用BMP指令打印。
<br>
* Q：BMP指令图片打印支持打印多大的图片？
* A：图片像素宽*像素高/8小于49152。按纸张算，48毫米宽度打印纸铺满可以打印128毫米长度。图片必须为BMP单色位图。
<br>
* Q：想打印一个二维码，但是这个二维码链接太长了怎么办？
* A：建议转成短链接再使用QR指令生成二维码。内容多了二维码会比较密不好识别。
<br>
* Q：K5型号打印机可以打印PDF吗？
* A：云驱动打印可以打印PDF。调API接口打印的话，需要自行转换成图片打印。
### 二、应用相关
* Q：如何创建应用？如何选择应用类型？
* A：请看文档[使用前准备](使用前准备.md)！
<br>
* Q：应用创建是否可以无限创建？是否有上限？
* A：可以，但不必要，推荐一个易联云账号下对应一个自有型应用管理设备对接，开放型应用不限制！
<br>
* Q：应用可以删除吗？
* A：可以，但是后续影响（接口调用失败），与易联云无关！
<br>
* Q：个人资料能改为企业资料吗？
* A：暂时不能，易联云暂时未对资料进行审核认证，且不影响正常应用创建、使用！
<br>
* Q：开放型应用如何获取调用凭证`access_token`？
* A：便捷获取方式请查看[开放型应用（扫码授权模式）](扫码授权.md)
<br>
* Q: 自有型应用与开放型应用的区别？
* A：请看文档[开发者服务指引【必看】](开发者服务指引.md)
### 三、打印机相关
* Q：新设备如何联网使用？以及设备故障该如何处理？
* A：微信搜索公众号`易联云外卖接单打印机`，在对话框中联系在线售后处理！售后服务时间9:00-23:00！
<br>
* Q：K4型号打印机2.4G WiFi版本配网时，如何通过错误码判断失败原因？
* A：AP即WiFi路由器，STA即WiFi打印机。
- `错误码2`在连接的认证阶段，STA 发送了认证，但在规定时间内未收到 AP 的认证回复，有较低概率会出现。频繁出现暂定为天线问题。
- `错误码3`通常是由 AP 因为某种原因断开了 STA 连接，错误码是由 AP 发过来的。
- `错误码15`或者`错误码204`失败原因为密码错误。其中，错误码15 为标准通用的错误码，而 错误码204 为自定义错误码。两者区别在于 错误码15 为路由器在密码错误时告知设备，产生的错误，错误码204 为路由器在密码错误时不告知设备，由设备本身超时机制产生的错误。
- `错误码205`扫描阶段返回的错误码，主要是由于 STA 扫描到了匹配的 AP，但是这个 AP 在黑名单里。AP 在黑名单里面的原因是上次 AP 主动踢掉了 STA，或者 STA 连接 AP 的过程中失败了。
- `错误码201` STA 未扫描到目标 AP。
* AP 频段不匹配
* AP 加密类型不匹配
* 打印机目前支持加密类型为OPEN、WPA2_PSK、WPA_WPA2_PSK的WiFi
* 打印机配置WiFi时加密类型为OPEN的WiFi不要输入密码
* AP 信号弱
* 隐藏 AP
- 其他错误码，请重试。
<br>
* Q：打印机信号强度说明
* A：`WiFi信号强度`：31，值为0~31，值越大信号越强。`WiFi信号强度`：Good, 100%，第二个值为0%~100%，值越大信号越强。`4G信号强度`：31, 99，第一个值为0~31，值越大信号越强。
<br>
* Q：打印机是否支持连接无密码WiFi？
* A：支持连接无密码WiFi。需要网页、短信等验证的WiFi请绑定打印机WiFi MAC地址。
<br>
* Q：哪些打印机支持云驱动或者图片打印接口？
* A：型号版本带D字母的打印机，比如K5-WED。在售支持的打印机型号有【K7、W1、B1】。
<br>
* Q：哪些打印机支持文本打印接口BMP指令图片打印？
* A：【K4、K5、K6、K7、W1】型号打印机固件版本`a7.0`及以上支持。【K8、B1】型号打印机所有固件版本支持。在售支持的打印机型号有【K4、K8、W1、B1】。
<br>
* Q：K4型号打印机支持TSPL指令集吗？
* A：K4型号打印机不支持TSPL指令集。K4型号打印机蓝牙打印、USB打印目前仅支持ESC/POS指令集，云打印仅支持易联云自定义指令集。B1型号打印机USB打印支持TSPL指令集。
<br>
* Q：现在K4型号打印机的AI语音，和最早的AI语音是不是一样的？开发者是不是还是用`<audio></audio>`这个指令？
* A：不一样。不是用`<audio></audio>`指令，而是用`<TTS></TTS>`指令。型号版本带S字母的打印机支持TTS文字转语音播报功能，即AI语音，比如K4-WUS。
详见打印机语音功能指令文档：[语音指令文档](语音指令文档.md)
<br>
* Q：打印机支持韩语、越南语等打印吗？
* A：【K4、K8、B1】型号打印机支持文本打印接口打印中文、日文、韩文、拉丁文（包含英语、越南语等）、西里尔文（包含俄语等）。
中文、日文、英文、俄文默认支持，韩语、越南语等打印需要使用`<GB18030></GB18030>`或者`<LATIN></LATIN>`指令。详见打印机语言指令集文档：[多语言指令文档](语言指令文档.md)
<br>
* Q：打印机支持维文打印吗？
* A：文本打印接口不支持维文打印。支持图片打印（图片打印接口或者文本打印接口BMP指令）的打印机可以开发者自行绘制图片打印图片。（其他不支持打印的文字均可使用此方法）
<br>
* Q：打印机可以只播报不打印吗？
* A：可以只播报不打印。文本打印接口发送不需要打印的打印内容就会只播报不打印，比如`<MS>1,2</MS>`。
<br>
* Q：打印机的USB打印怎么开发？
* A：调用系统USB驱动打印，或者调用系统打印机打印。B1型号打印机USB打印指令集为TSPL指令集，其他打印机指令集为ESC/POS指令集。型号版本带U字母的打印机支持USB打印。网上可以找到很多相关示例：JAVA示例：
- https://github.com/anastaciocintra/escpos-coffee
- https://gitee.com/xiaohe4966/escpos_print_K4
<br>
* Q：打印机的蓝牙打印怎么开发？
* A：调用系统蓝牙驱动打印。打印机指令集为ESC/POS指令集。型号版本带T字母的打印机支持蓝牙打印。网上可以找到很多相关示例。
<br>
* Q：电脑安装打印机USB驱动时找不到端口？
* A：1.检查打印机是否开机。2.检查打印机首次使用的引导流程是否走完。3.检查打印机USB模式设置状态是否为连接电脑或收银机。4.检查电脑系统Print Spooler打印后台处理服务是否为正在运行状态。参考：https://baijiahao.baidu.com/s?id=1826728987983334059&wfr=spider&for=pc&searchword=%E6%89%93%E5%BC%80Print%20Spooler%E6%9C%8D%E5%8A%A1
<br>
* Q：打印机打印下面图片这个是什么情况？
* A：K6和K7型号打印机AI语音版本（型号版本带A字母的打印机）长按左键一定时间会打印这个调试信息。如果不是人为操作打印出来的，且频繁出现的，那应该是按键硬件有问题。
<br>
* Q：打印机播报联网或者缺纸这种的语音，音量可以调小吗？
* A：设置菜单-高级设置-系统提醒设置，选择设置音量0~3，控制编号1~14除开编号5所有的系统语音音量。
<br>
* Q：打印机USB连接扫码盒子，扫码后打印机没有反应是怎么回事？
* A：打印机USB模式设置为连接扫码设备时才能连接扫码盒子使用。打印机USB模式设置状态默认为连接电脑或收银机，请检查打印机USB模式设置状态是否为连接扫码设备。
<br>
* Q：打印机打印蓝牙被别人连接了，可以取消连接吗？
* A：不可以取消连接。可以设置关闭蓝牙打印，关闭后蓝牙连接语音提醒也会一并关闭。设置菜单-高级设置-蓝牙打印设置，选择设置开启或者关闭。
<br>
* Q：设置菜单-高级设置里的网络超时时间设置的是什么？
* A：打印机和服务器在空闲时会互发网络心跳包保持连接，网络超时时间设置的是多长时间没有收到网络心跳包就判断为网络断开。
<br>
* Q：打印机一行能放置的字符数量怎么计算？
* A：详细请看文档[指令文档说明](指令文档说明.md)
<br>
* Q：记事本打印边距特别大怎么处理？
* A：
文件-页面设置-页边距设置为0，清空页眉、页脚内容。
<br>
* Q：K5、B1型号打印机支持CPCL指令集吗？
* A：K5和B1型号打印机都不支持CPCL指令集。B1型号打印机USB打印使用的是TSPL指令集。其他型号打印机USB打印、蓝牙打印使用的是ESC/POS指令集。
<br>
* Q：打印机打印下面图片这样是什么情况？
* A：图上内容为TSPL指令集内容，如果打印机不支持此指令集就会原样打印出来。检查打单软件上是否把打印机设置成了标签打印机，请切换到非标签打印或者购买B1型号标签打印机使用。错误示例：
<br>
* Q：安装驱动时，提示这个怎么处理？
* A：关闭杀毒软件后再尝试安装。关闭重复打开的程序后再尝试安装。
<br>
* Q：驱动打印，之前可以正常打印，现在电脑系统设置里找不到打印机了是怎么回事？
* A：需要启动Print Spooler服务。参考：https://baijiahao.baidu.com/s?id=1826728987983334059&wfr=spider&for=pc&searchword=%E6%89%93%E5%BC%80Print%20Spooler%E6%9C%8D%E5%8A%A1
<br>
* Q：驱动打印，提示“……本地打印后台处理程序服务没有运行。……”，怎么处理？
* A：需要启动Print Spooler服务。参考：https://baijiahao.baidu.com/s?id=1826728987983334059&wfr=spider&for=pc&searchword=%E6%89%93%E5%BC%80Print%20Spooler%E6%9C%8D%E5%8A%A1
### 四、扫码相关
* Q：打印机扫码功能支持哪些场景？
* A：K8型号打印机（集成扫码头）：出餐、核销、验券、云端下发金额收银、USB键盘输入金额收银、USB打印切支付。K4型号打印机（外接扫码设备）：出餐、核销、验券、云端下发金额收银。以上均支持第三方对接使用，相关文档：[扫码功能流程图](扫码相关功能流程图.md)，[扫码功能指令](扫码功能指令.md)
<br>
* Q：回调地址和扫码推送地址的区别？
* A：回调地址是授权后的回调（调用扫码授权就不会有回调），扫码推送地址就是扫码后通过该地址进行推送数据，配置扫码推送地址是GET请求返回{"message":"ok"}
<br>
* Q：扫码推送AES加密和RSA的区别
* A：AES加密是对称加密，秘钥填写推荐32位字符串。RSA是非对称加密，秘钥填写为4096密匙对中的公钥
<br>
* Q：扫码推送多种模式区别？
* A：1、标准模式：全推送给开发者（出餐、核销、付款以及退款等），不可使用易联云的出餐、核销以及收银；
2、支付模式：付款、退款和带YLY标识内容推送给开发者，可以使用易联云的出餐与核销（需绑定店铺）；
3、标识模式：仅带YLY标识内容推送给开发者，可以使用易联云的出餐、核销以及收银（需绑定店铺）。
<br>
* Q：扫码支付成功后怎么打印收银机本身小票？
* A：支付成功调用文本打印接口，接口参数content值：<JSON>{"order_payment":{"scanned_code":"支付码号","pay_amount":金额,"pay_amount_source":1},"processed_state":2}</JSON>，其中scanned_code，pay_amount，pay_amount_source这三个参数推送数据中有，无需修改。processed_state：处理状态，整型，1上报成功，2支付成功，3支付失败，4退款成功，5退款失败，6核销成功，7核销失败 8出餐成功 9出餐失败
<br>
* Q：推送开关设置接口是干啥的？
* A：1.做扫码推送绑定，只有绑定成功后才能进行推送（注意：一台打印机只能绑定一个应用）2.设置推送模式
<br>
* Q：关键字设置用处？
* A：关键字用于收银机收银匹配收银机本身小票上面的金额，或者换班，重打等操作，不同的收银系统关键字不一样，并且设置一级关键字数量要大于等于二级关键字数量，不要设置空格关键字
<br>
* Q：扫码打印机是否支付外接扫码枪，人脸识别设置？
* A：支持usb的外接设备基本都支持
<br>
* Q：推送开关设置接口提示无权限，怎么办？
* A：1.打印机原来应用推送绑定了未解绑，用原来应用参数调用推送开关设置成关闭进行解绑，或者调用解除授权也会自动解绑，然后新应用调用推送开关设置即可
2.应用未开通
3.打印机未绑定应用上面
<br>
* Q：设置关键字，提示无权限？
* A：除了要满足推送开关设置要求外，还要推送开关设置开启
### 五、对接群
- 使用前准备【必看】
- 开发者服务指引【必看】
- 接口更新动态
- 2024年5月
- 2024年1月
- 2023年11月
- 2023年10月
- 2023年9月
- 2023年6月
- 开发文档【必看】
- 调用协议【必看】
- 授权文档【必接】
- 自有型应用
- 开放型应用（OAuth2.0授权码模式）
- 开放型应用（扫码授权模式）
- SDK使用说明
- API文档【按需对接】
- 设备文档
- 设备绑定
- 设备解绑或取消授权
- 状态获取
- 离线或重启控制
- 打印控制
- logo控制
- 音效音量控制
- 内置语音控制
- 打印宽度获取
- 型号版本获取
- 接单拒单控制
- 打印文档
- 文本打印
- 图片打印
- 面单文档
- 面单生成并打印
- 面单取消
- 打印队列文档
- 订单状态获取（单订单）
- 订单列表获取
- 订单取消打印（单订单）
- 订单取消打印（全量）
- 订单重打（单订单）
- 应用设置文档
- 推送地址设置
- K8支付设置文档
- 推送开关设置
- 关键词设置
- 高级设置
- 打印消息推送
- 打印消息推送说明
- 打印完成推送
- 终端状态推送
- 接单拒单推送
- K8扫码信息推送
- 扫码相关功能流程图
- 产品介绍
- 授权说明
- 消息推送
- http/https推送方式
- 签名验证规则
- 解密规则
- 指令说明
- 验签解密示例
- 打印指令文档
- 指令文档说明
- 文本打印指令集
- 语音指令文档
- 多语言指令文档
- 扫码功能指令
- 常见问题
- 错误码说明
- FAQ