语音指令文档 · yilianyun-open-api

# 语音指令 ### 一、阅读前提 1. K4打印机(固件版本`a8.5.0`及以上)、K8打印机: - 可以实现内容固定或者数字、金额内容变化的自定义语音和收款金额播报； - 可以实现MP3音频文件数据播报(K4机型固件版本`a8.6.0`新增，K8机型都支持)； - 可以调用系统内置语音播报(K4机型固件版本`a8.7.0`新增，K8机型都支持)； - 音量四档可调(静音、低音量、中音量、高音量)。 2. K4打印机型号版本带S的机型(比如K4-WUS、K4-GUS等)新增`<TTS></TTS>`指令TTS文字转语音播报功能(目前仅支持中文、数字、英文字母。英文会按字母逐个播报。)。 3. K4和K8打印机不支持`<audio></audio>`指令AI语音播报功能。 4. 关于只播报不打印功能，文本打印接口发送不需要打印的打印内容，比如`<MS>1,2</MS>`。 5. `<VN></VN>、<VD></VD>、<VA></VA>、<VI></VI>`指令可以相互拼接使用，数量不超过20个。`<VN></VN>`该指令使用前需要先通过[内置语音设置接口](内置语音控制.md)为打印机设置内置语音。 6. 文本打印接口使用语音功能指令，图片打印接口不支持语音功能指令。 ### 二、指令说明 <table> <colgroup> <col style="width: 10%;"> <col style="width: 16%;"> <col style="width: 38%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 6%;"> <col style="width: 5%;"> <col style="width: 5%;"> </colgroup> <thead> <tr> <th>指令</th> <th>内容</th> <th>说明</th> <th>K4</th> <th>K5&B1</th> <th>K6</th> <th>K7</th> <th>W1</th> <th>M1</th> <th>K8</th> </tr> </thead> <tbody> <tr> <td>设置自定义语音播报内容</td> <td><audio>speech_content</audio&gt</td> <td>speech_content：语音内容，支持100个字节以内的数据播报。仅支持型号中带字母A的终端设备，例如：K4-WA、K4-GAD</td> <td>✔</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> </tr> <tr> <td>设置TTS文字转语音播报</td> <td><TTS>wait_speaker_alarm_end,voice,speed,base64_str</TTS&gt</td> <td>指令放在订单开头；wait_speaker_alarm_end：值为（0、1），0：不等待播报完成，1：等待播报完成；voice：音库，值为（0、1、2、3）（2和3音质更优，但无词组、多音字处理）；speed：语速，值为（0-5）；base64_str：UTF8编码字符串的BASE64编码字符串（目前仅支持中文、数字、英文字母。英文会按字母逐个播报）；仅支持型号中带字母S的终端设备，例如：K4-WS、K4-GADS</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> </tr> <tr> <td>数字播报</td> <td><VD>digit</VD&gt</td> <td>digit：数字，包括整数、小数。K4、K6机型固件版本a8.5.0及以上，K8机型都支持</td> <td>✔</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> </tr> <tr> <td>收款播报</td> <td><VA>mode,amount</VA&gt</td> <td>mode：模式，值为0、1、2（无/微信/支付宝）。amount：收款金额。K4、K6机型固件版本a8.5.0及以上，K8机型都支持</td> <td>✔</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> </tr> <tr> <td>MP3音频文件数据播报</td> <td><CV2>base64_str</CV2&gt</td> <td>指令放在订单开头；base64_str：MP3音频文件数据的BSAE64编码字符串。K4、K6机型固件版本a8.6.0及以上，K8机型都支持</td> <td>✔</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> </tr> <tr> <td>MP3音频文件数据保存和播报</td> <td><CV3>number,base64_str</CV3&gt</td> <td>指令放在订单开头；number：语音编号（0-9）;base64_str：MP3音频文件数据的BSAE64编码字符串。K4、K6机型固件版本a8.6.0及以上，K8机型都支持</td> <td>✔</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> </tr> <tr> <td>系统内置语音播报</td> <td><VI>number</VI&gt</td> <td>number：系统的内置语音编号，见下面详解。固定3位长度，前置0补齐。K4、K6机型固件版本a8.7.0及以上，K8机型都支持</td> <td>✔</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> </tr> <tr> <td>设置来单提示声音</td> <td><MS>sound_mode,sound_volume</MS></td> <td>指令放在订单开头；sound_mode：声音模式，值为(0、1)，0=蜂鸣器声音提示，1=喇叭语音提示；sound_volume：声音音量，值为(0、1、2、3)，0=蜂鸣器静音/喇叭关闭或静音，1=蜂鸣器低音量/喇叭开启或低音量，2=蜂鸣器中音量/喇叭开启或中音量，3=蜂鸣器高音量/喇叭开启或高音量</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>内置语音播报</td> <td><VN>number</VN></td> <td>指令放在订单开头；number:设置的内置语音编号</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> </tbody> </table> ### 系统的内置语音编号 | 系统内置语音编号 | 播报内容 | |------------------|---------| | 000 | 静音 | | 001 | 设备未检测到SIM卡 | | 002 | 设备联网失败，请检查网络 | | 003 | 设备已掉线，请检查网络 | | 004 | 设备系统正在升级，请勿关机 | | 005 | 您有新的订单，请注意查收 | | 006 | 欢迎使用易联云打印机 | | 007 | 设置成功 | | 008 | 设备缺纸 | | 009 | 设备升级成功，可以正常使用 | | 010 | 设备联网成功 | | 011 | | | 012 | 设备过热 | | 013 | 蓝牙已连接 | | 014 | 蓝牙已断开 | | 015 | 零 | | 016 | 一 | | 017 | 二 | | 018 | 三 | | 019 | 四 | | 020 | 五 | | 021 | 六 | | 022 | 七 | | 023 | 八 | | 024 | 九 | | 025 | 十 | | 026 | 百 | | 027 | 千 | | 028 | 万 | | 029 | 亿 | | 030 | 点 | | 031 | 收款 | | 032 | 元 | | 033 | 微信 | | 034 | 支付宝 | | 035 | 前缀音 | | 036 | 前缀音 | | 037 | 前缀音 | | 038 | 前缀音 | | 039 | 取消 | | 040 | 请出示付款码 | | 041 | 成功 | | 042 | 失败 | | 043 | 支付 | | 044 | 出餐 | | 045 | 核销 | | 046 | 验券 | | 047 | 退款 | | 048 | 请出示商户单号 | | 049 | 退格 | | 050 | 银联 | | 051 | 数字人民币 | | 052 | 翼支付 | | 053 | 苏宁 | | 054 | 美团 | | 055 | 饿了么 | | 056 | 抖音来客 | | 057 | 美团闪购 | | 058 | 饿了么零售 | | 059 | 京东到家京东外卖 (K4机型固件版本a9.1.6及以上，K8机型固件版本a2.5.0及以上) | | 060 | 美团团购 | | 061 | 微店 | | 062 | 微盟 | | 063 | 有赞 | | 064 | 您有新的 | | 065 | 订单，请注意查收 | | 066 | 开票 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 067 | F1 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 068 | F2 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 069 | F3 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 070 | 抖店外卖 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 071 | 拣货 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 072 | 催单 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 073 | 备餐 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 074 | 提醒 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 075 | 修改 (K4机型固件版本a9.0.0及以上，K8机型固件版本a2.0.0及以上) | | 076 | 京东秒送 (K4机型固件版本a9.1.6及以上，K8机型固件版本a2.5.0及以上) | #### VI指令示例 1. 收款成功：`<VI>031</VI><VI>041</VI>` 2. 收款失败：`<VI>031</VI><VI>042</VI>` 3. 退款成功：`<VI>047</VI><VI>041</VI>` 4. 退款失败：`<VI>047</VI><VI>042</VI>` 5. 核销成功：`<VI>045</VI><VI>041</VI>` 6. 核销失败：`<VI>045</VI><VI>042</VI>` 7. 美团出餐成功：`<VI>054</VI><VI>044</VI><VI>041</VI>` 8. 美团出餐失败：`<VI>054</VI><VI>044</VI><VI>042</VI>` 9. 抖音来客出餐成功：`<VI>056</VI><VI>044</VI><VI>041</VI>` 10. 抖音来客出餐失败：`<VI>056</VI><VI>044</VI><VI>042</VI>` 11. 验券成功：`<VI>046</VI><VI>041</VI>` 12. 验券失败：`<VI>046</VI><VI>042</VI>` #### 其他示例 - 以加油站的语音播报“柴油25号枪加油收款成功200元，优惠8.88元”为例展示3种实现方式: - 方式1：`VN`内置语音接口方式。 1. 以数字、金额、标点为节点拆分、去重，保留字段为：柴油、25、号枪加油收款成功、200、元、优惠、8.88、元。 2. 通过[内置语音设置接口](内置语音控制.md)为打印机设置内置语音。 - `柴油`音频设置内置，`VN`编号0 - `号枪加油收款成功`音频设置内置，`VN`编号1 - `元`音频设置内置，`VN`编号2 - `优惠`音频设置内置，`VN`编号3 3. 使用指令拼接，放在订单内容头部：`<VN>0</VN><VD>25</VD><VN>1</VN><VD>200</VD><VN>2</VN><VN>3</VN><VD>8.88</VD><VN>2</VN>` - 方式2：(K4机型固件版本`a8.6.0`新增，K8机型都支持): 1. 调用其他平台语音合成接口将文字转换成语音，生成MP3音频文件。 2. 把MP3音频文件数据的BSAE64编码字符串放入`<CV2>`指令中，放在订单内容头部：示例`<CV2>base64编码字符串</CV2>` - 方式3：K4打印机型号版本带`S`的机型(比如`K4-WUS`、`K4-GUS`等)。 1. 把UTF8编码字符串的BSAE64编码字符串与`<TTS></TTS>`指令拼接，放在订单内容头部。示例：`<TTS>1,2,5,5p+05rK5MjXlj7fmnqrliqDmsrnmlLbmrL7miJDlip8yMDDlhYPvvIzkvJjmg6A4Ljg45YWD</TTS>`