# 快速体验

当开发者拿到AIUI评估板时,可通过简单的几步配置即可快速体验AIUI。

# 云端配置

在AIUI开放平台中购买AIUI评估板 (opens new window)后,您的账号下会自动创建一个AIUI应用。登录账号后,进入我的应用即可看到您的应用。

进入应用后,您可以在SDK下载页面中查询应用的APPID与AppKey以及下载最新版本的SDK。

在应用配置页面,您可通过添加技能按钮添加自己想要的开放技能,如天气、音乐、航班等。

# 评估板配置

# 网络配置

配置好云端服务后,需要将AIUI评估板连接上网络才能使用云端强大的开放语义能力。评估板提供以下三种配网方式给开发者使用,开发者只需选择其中一种方式将评估板连接上网络即可。

SmartConfig

①扫描下方二维码,安装AIUI评估板控制端(暂时只支持Android手机);

②将手机连接至wifi网络,如已连接可忽略此步骤;

③短按评估板右下角的 Load 键,语音提示进入 SmartConfig连网模式;

④在手机端点击右上角快联,然后设置所连接 WIFI的密码,点击发送;

⑤等待一会儿,听到播报联网成功即可。

Windows批处理

①评估板插上电源、开机,使用 USB 线连接电脑与评估板DEBUG口,并将电脑配置好 ADB的环境变量;

②双击打开开发包中 wifi_connect_ui.bat 文件;

③按照提示键入 WIFI 的SSID、密码、加密方式回车即可(连接成功后会保存到系统设置,重启后会自动联网无需重新配置)。

同屏UI操作

①评估板插上电源、开机,使用 USB 线连接电脑与评估板DEBUG口,并将电脑配置好 ADB的环境变量;

②使用TotalControl或者Vysor,通过界面直接操作评估板WIFI配置。

注:评估板暂不支持5G网络。

# APPID配置

评估板连接上网络后,开发者需要将自己的APPID、AppKey以及场景参数同步到评估板中,使评估板拥有访问AIUI云端服务的权限。具体步骤如下:

①手机安装AIUI评估板控制端APP,可扫描网络配置中二维码进行下载安装;

②打开AIUI评估板控制端,APP会自动扫描出当前手机所在无线网络中所有的评估板设备。请确认手机与评估板已经连接在同一个无线网络中,否则无法扫描到评估板设备;

③选择一个设备,点击“连接”,进入控制台页面,可以看到连接情况和评估板返回的消息;

④点击“配置”,按提示输入应用配置信息,勾选是否启动AIUI后处理程序,点击“同步配置”,配置成功后即可体验。

流程如下所示:

注:请注意勾选是否启动AIUI后处理程序,否则评估板将无法播报。

# 常见问题

Q:同在一个WIFI下,无法搜索到设备

A: 手机端使用局域网广播包的方式扫描设备,如果路由器对这种方式进行限制就会导致无法扫描到,所以建议使用手机4G分享热点,重试扫描。

Q:手机端显示10407错误

A: 配置的APPID和KEY不匹配。请仔细检查应用的APPID与KEY是否匹配后再重新配置。

# 交互使用

AIUI评估板可通过默认唤醒词 叮咚叮咚 即可唤醒。

# 交互示例

您可以用日常交流方式与AIUI进行自然交互,比如今天天气怎么样给我唱首歌等,AIUI会返回结果并进行播报,并且在手机端APP会有AIUI返回结果的显示。

以下为一些交互问法的示例:

音乐:

叮咚叮咚
我想听张学友的歌
下一首
声音大一点

诗词:

叮咚叮咚
李白的静夜思
换他的望庐山瀑布
春眠不觉晓的下一句
这首诗是谁写的

更多技能问法,可以在AIUI开放平台-技能商店里查询。

# LED灯提示

评估板麦克风阵列上LED灯指示唤醒角度。底板三色灯指示AIUI状态,底板三色灯状态定义如下:

三色灯状态 AIUI 状态
灯灭 休眠状态
红灯闪烁 未连接WiFi
红灯常亮 APPID校验不通过
绿灯常亮 录音状态
蓝灯亮 拒识状态

# 常见问题

Q:开发板可以外接屏幕吗?

A: 不能。

Q:唤醒无声音播报怎么办?

A: 参考 评估板配置中配置APPID时请确认勾选了是否启动AIUI后处理程序。

Q:问法无回复播报怎么办?

A: AIUI后台根据已勾选的语义技能对输入进行处理返回,本地客户端根据结果进行解析播报。 如果有问法没有响应播报,按如下方法检查:

查看手机端的语义结果返回,根据语义结果中rc字段判断

①rc字段为0为有语义结果,没有播报是本地解析播报的问题,联系我们反馈。

②rc字段为4为无效语义结果,检查后台有没有勾选对相应的语义技能。如果已勾选,那是语义未覆盖该说法的原因。

Q:为什么播报“网络有点问题,我去休息了”?

A: 该播报由超时错误10120引起。交互语音上传后,听写或者语义结果没有在特定时间(配置文件result_timeout定义)返回,则会出现10120错误。 出现10120错误的原因有可能是网络状态差或者服务器处理缓慢的原因,可以按照如下方式验证排查:

  • 通过在AIUI模块上ping aiui.openspeech.cn,检查本地到服务端的链接情况;
  • 将开启日志的msc.cfg (opens new window)放入/sdcard/msc/目录下,重启后复现超时的问题,然后将整个/sdcard/msc/目录下的日志文件pull出来,发送给技术支持分析;
  • 切换到另一个网络,看是否有10120错误。如有,则通过tcp_dump (opens new window)进行抓包,复现超时的问题,pull出数据包,发送给技术支持分析。

Q:AIUIProductDemo没看到启动项,这个的入口是什么?

A: AIUIProductDemo以Service方式运行,入口类是ProductDemoService,没有启动Activity。配置appid以及正常启动时都是由ControlService拉起ProductDemoService。