AC7911-开发指南

# 开发指南

**目 录**

1. 编写目的
2. 准备工作
3. 云端技能配置
4. 唤醒词和命令词更换
5. 串口信息调试
	5.1. 离线命令词识别
	5.2. 云端自定义技能

# 1. 编写目的

本文档旨在指导用户完成AC7911 AIUI语音交互开发套件自定义产品开发。

# 2. 准备工作

准备好以下物件：

* AC7911 AIUI语音交互开发套件
* Micro USB数据线
* 电脑（Windows10操作系统，用于查看调试信息和客制化）

# 3. 云端技能配置

开发套件自带默认的应用信息，已经关联了一些内置技能。为了满足用户的功能定制需求，也支持用户更换应用，即允许使用用户在科大讯飞AIUI开放平台自行创建的应用及对应技能。

操作方法如下：

**第一步**，登录科大讯飞AIUI官方网站<https://aiui.xfyun.cn/>。

**第二步**，进入我的应用，创建应用或者选择已创建的应用，并进入应用编辑配置页面。

**第三步**，在应用配置页面中，依次对语音识别、语义理解、语音合成等AI能力进行配置，并保存修改。其中AI能力的配置可以参考AIUI开放平台文档中心<https://aiui.xfyun.cn/doc/aiui/>。

**第四步**，进入应用信息页面，将APPID和APIKEY复制并保存到工具包的tool\_write\_aiui\_appid\user\_cfg\usercfg.ini文件中。

![](/media/202303//1679970466.5005271.png)

<center>图1 获取appid信息</center>

![](/media/202303//1679970466.5059342.png)

<center>图2 将appid和apikey填入usercfg.ini文件中</center>

**第五步**，进入资源更新模式。

将开发套件的硬件跳帽配置如下图所示：

![1678359162821](/media/202303//1679970466.510148.jpeg)

<center>图3 资源更新模式跳帽配置</center>

A有固定跳帽，B用跳帽时可进行资源更新，C用跳帽时可进行log输出。

然后将开发套件与电脑连接，按住下载按键D再拨动开关到ON档，进入资源更新模式。

**第六步**，进入工具包tool\_write\_aiui\_appid\目录，双击write\_aiui\_appid.bat，待上传完毕即可生效。

![](/media/202303//1679970466.5414279.png)

<center>图4 执行脚本写入配置</center>

**开发者更新appid信息，需要注意以下几点：**

1.提供appid给到讯飞；
2.如需闹钟技能，需要讯飞后台单独配置；
3.如需音乐技能，需要讯飞开通音乐权限；
4.基于第3点，另需在小飞在家小程序上点播音乐，需要讯飞提供productkey，更新到配置文件中。

商务联系方式： [mailto:aiui\_support@iflytek.com](mailto:aiui_support@iflytek.com)。

# 4. 唤醒词和命令词更换

开发套件中默认的唤醒词是“小飞小飞”，另外还有一些默认的离线命令词，若用户有更换的需求，可以通过浅定制或者深定制方式进行定制。其中深定制周期长，误唤醒率低；浅定制周期短，误唤醒率相对于深定制较高。

若需要定制，请联系商务，提供自定义资源列表内容并说明要制定的方式。联系方式: [mailto:aiui\_support@iflytek.com](mailto:aiui_support@iflytek.com)。

自定义离线资源列表示例如下：

|类型  |词条    |回复语  |对应串口指令 |
| :---- | :---- |:---- |:---- |
|唤醒词   |小飞小飞   |我在呢 |0x0001  |
|离线命令词   |打开空调   |好的，空调已打开 |0x0002  |
|离线命令词   |关闭空调   |好的，空调已打开 |0x0003  |
|离线命令词   |制热30度   |好的，空调已打开 |0x0004  |
|离线命令词   |温度太高了   |好的，空调已打开 |0x0005  |

表1 自定义资源列表示例

定制成功后，商务会将集成了自定义唤醒词和离线命令词的固件给到客户。客户拿到新固件版本后，按以下步骤更新到设备：

**第一步**，登录到AIUI平台，选择已经申请的应用，进入应用信息页面。

**第二步**，选择应用内固件升级功能点，点击新增固件。

![](/media/202303//1679970466.5532658.png)

填写固件信息并上传固件。

![](/media/202303//1679970466.557563.png)

**第三步**，通过串口工具连接上设备，获取设备ID进行固件验证。

![](/media/202303//1679970466.5828817.png)

**第四步**，确认固件没有问题后，将固件升级到该APPID的所有设备上。

![](/media/202303//1679970466.5876586.png)

# 5. 串口信息调试

可以通过USB转串口下发指令给其他设备以进行业务处理，通信协议参见《AC7911 AIUI语音交互开发套件协议手册》。为了确保命令体取值与指令一一对应，制定以下规则，通过此规则可以实现自定义技能的扩展。

用户如需要查看调试信息，通过串口线将开发套件与电脑连接，通过串口工具打开串口（波特率921600）即可查看调试LOG打印日志信息。

## 5.1 离线命令词识别

通过定制资源时提供的离线命令词列表，将命令词、回复语、编号和命令体（一个用户自定义的int类型数值）一一对应起来。当用户与开发套件进行交互触发离线命令词时，开发套件通过串口传输协议文本，其中命令体会对应被触发的命令词。例如，打开灯光这条离线命令词对应的编号是01，当打开灯光被触发后，命令体取值为0x0001。

|命令词  |回复语    |编号  |命令体 |
| :---- | :---- |:---- |:---- |
|打开灯光   |好的   |01 |0x0001  |
|关闭灯光   |好的   |02 |0x0002  |

表2 离线命令词示例

## 5.2 云端自定义技能

下面以在AIUI开放平台制作灯光控制技能为例说明如何自定义技能，用户可以参考以下操作步骤。

**第一步**，登录科大讯飞AIUI官方网站<https://aiui.xfyun.cn/>。

**第二步**，进入技能工作室，创建技能。

![](/media/202303//1679970466.6013937.png)

**第三步**，在技能下创建意图。

![](/media/202303//1679970466.6163282.png)

**第四步**，进入意图配置页面，配置意图及实体后，构建技能。

![](/media/202303//1679970466.6204531.png)

其中被引用的实体，词条对应编号，别名对应在线指令。

![](/media/202303//1679970466.6404488.png)

这样就完成云端技能的配置。