# 内置语音控制 ### 一、阅读前提 1. 设备须在线，才能触发指令控制。 2. 关于内置语音控制说明，凡是型号中带字母A的机器和K4以下型号（WGTUH、WGUH、WTUH、WUH、GTUH、GUH、WGTUS、WGUS、WTUS、WUS、GTUS、GUS）和K8型号支持该功能，其余都不支持该功能。 3. 内置语音只能添加10条（0~9），超出10条，每次会重置aid为0的语音。 4. 打印中使用内置语音需用`<VN>aid</VN>`指令唤醒，且<VN>指令需放在打印内容顶部。 5. <p style="color: red">设置接口返回成功，等硬件响应成功后再设置下一条内置语音，否则不生效或未知错误</p> ### 二、添加接口 #### 接口信息 |协议|方式|地址 |-|-|-| |https|POST|/printer/setvoice #### 请求参数 |名称|类型|必填|描述 |-|-|-|-|-| |client_id|string|是|应用id |sign|string|是|签名 |timestamp|int|是|时间戳（秒） |id|string|是|请求唯一标识码 |access_token|string|是|调用凭证 |machine_code|string|是|终端号 |is_file|string|是|`true`或`false` |content|string|是|is_file=`true`时，该参数为语音链接，文件大小不能超过24kb；is_file=`false`时，该参数为`播报内容` , `音量(1~9)` , `声音类型(0,1,3,4)`组成的json格式字符串，示例：["播报内容",1,0] |aid|int|否|需设置内置语音的编号 #### 响应参数 |名称|类型|描述 |-|-|-|-| |error|int|成功0，其他为异常 |error_description|string|提示信息 |timestamp|int|时间戳（秒） |body|json|数据 #### body 字段示例 ```json { "aid": 0 } ``` #### body 字段说明 |名称|类型|空|描述 |-|-|-|-| |aid|int|否|内置语音编号 ### 三、取消接口 #### 接口信息 |协议|方式|地址 |-|-|-| |https|POST|/printer/deletevoice #### 请求参数 |名称|类型|必填|描述 |-|-|-|-|-| |client_id|string|是|应用id |sign|string|是|签名 |timestamp|int|是|时间戳（秒） |id|string|是|请求唯一标识码 |access_token|string|是|调用凭证 |machine_code|string|是|终端号 |aid|int|否|需设置内置语音的编号 #### 响应参数 |名称|类型|描述 |-|-|-|-| |error|int|成功0，其他为异常 |error_description|string|提示信息 |timestamp|int|时间戳（秒） |body|json|数据