# 快速体验
当开发者拿到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。