1.1.1. 相关产品参数

其他产品参数可参考官网：http://www.aispeaker.com/products.html

1.1.2. 语音相关问题

语音唤醒不了，问题排查步骤

1. 桌面顶部下拉 → 设置 → 语音设置，语音唤醒开关是否打开，如果开着，看是否有设置定时关闭唤醒功能，如果有设置，确认下当前时间是否在可唤醒时间范围内。
2. 查看存储空间是否快满了。（空间不够一般会有弹窗提示，可以去顶部下拉-应用-文件管理删除无用的内容）
3. 点击桌面 > 音乐, 进入音乐界面看是否正常（1. 无初始化对话框 2.不会退出 3. 点击一个音乐再播放一下，确定网络是否正常），如果有初始化对话框一直显示，检查网络，查看网络连接
4. 语音没有进行初始化。（前提是网络没有问题，桌面 - 其他应用- 应用管理，下滑找到AIS应用点击管理进入，再点击存储空间进入，点击左边的“清除存储空间”。重新到音乐页面，等待初始化完成）
5. 如果以上步骤没有问题，点击 桌面顶部下拉 → 设置 → 语音设置→语音调试，进入语音调试页面。看语音状态是否是10，如果状态不是10，点击 “重启语音”。如果是10，点击 “唤醒对话”，然后说句 “今天的天气” 看语音是否正常，如果识别不正常，大概率是麦克风问题。如果正常，尝试其他人来唤醒，注意唤醒说话声音不用太大，也不用靠得很近，大概离背景音2米远，正常说话声音即可。
6. 需要检查麦克风是否故障。（可以联系我们查看）

上传音频文件(基础版，用于检测麦克风是否异常)

1. 进入桌面》设置》语音设置》语音调试 界面，点击“保存”按钮，会开始保存音频数据。

2. 语音控制复现问题，说5句：“你好小可”，问题复现难以唤醒后，再次点击步骤1的“保存”按钮，将会停止保存音频数据。

3. 点击 “上传”按钮，再点击“文件管理器”，再点击“0”，然后选择ais-xxx.pcm文件，上传成功后底部会有个小提示。

上传音频文件（高级版，用于检测长时间运行后无法唤醒或识别）

1. 进入桌面》设置》语音设置》语音调试 界面，点击右上角 “高级设置”，5次以上，下方会弹出个 “hello” 的字符,继续连续点击会出现波纹图，说话时可以看到几麦的机器就可以看到有几条变化的波形。（可以检测麦克风是否有问题）

2. 点击 “DN”，会开始保存音频数据。

3. 语音控制复现问题，如：“你好小可，打开客厅灯”，问题复现后，再次点击步骤2的“DN”菜单，将会停止保存音频数据。

4. 点击 “上传”按钮，再点击“文件管理器”，再点击“0”，然后选择ash-aec-xxx.pcm文件，再次重复步骤4，把 ash-rec-xxx.pcm 这个文件也上传。本步骤一共上传2个文件。

语控设备逻辑说明

1. 概述

语音通过增强模糊搜索类型匹配，简化了用户操作设备说法。以前用户每次要说“打开客厅XX灯”, XX灯，用户记忆起来很麻烦，现在都不需要了。用户说“打开客厅灯” 即可打开客厅所有的灯类型设备。

2. 使用建议

对于家居多房间场景，推行房间的概念，以更便捷的控制设备。对于酒店/门店只有一个或少量房间的场景，可以只用一个房间。

3. 语控指令说明

如下()为实际设备名 []是可选的，以灯为例，其他类型（如空调）设备，也按照这个逻辑控制

语音执行场景问题

1. 执行场景通用语句

2. 场景名称

3. 执行 + 场景名称 + 场景
4. 执行 + 场景名称

5. 场景名称 + 场景

6. 对于以下场景名称(场景名称必须是“”里的内容)，指令有如下扩展：

7. “睡觉” 也可以说 “我准备睡觉了、我要睡觉了、我睡觉了、睡了、我睡了、我休息了”等

8. “晨起” 也可以说 “我准备起床了、我要起床了、起床了、我起来了、起来了”等
9. “运动” 也可以说 “我准备运动了、我要运动了”等
10. “离家” 也可以说 “我要走了、我走了、我出门了、我准备走了、我要出门了、我准备出门了”等
11. “回家” 也可以说 “我回家了、我到家了、我回来了、回家了、我下班回家了”等

其他口语化场景语句可以通过添加场景别名实现。

语控音乐播放问题

1. 歌曲播放不了

在线音乐是需要付费充值会员才能听的，可以进音乐-我的-vip页面充值登录

1. 点播的歌曲和语音回来的歌曲不一致

因版权问题没有开放这部分歌曲，推荐其他的歌曲了

1. 目前语控播歌的通用指令有哪些

需要以下关键字：

.*播放.* .*歌.* .*音乐.* .*想听.* .*曲.* .*首.*

如：播放邓紫棋的歌曲、播放怒放的生命、来点音乐、我想听轻音乐、来一首汪峰的歌等

语音搜歌总是超时

背景：WiFi能正常上网，但语控搜歌百分百超时。让小可连接手机热点语控搜歌正常

遇到问题，有以下两种解决方式。

1. 设置下路由器。 参考链接：https://dudns.baidu.com/support/localdns/
2. 在小可主机的WiFi设置下，设置IP。参考链接：https://dudns.baidu.com/support/localdns/Mobile/

语控“你好，小可”后，还没来得及说话，语控界面就很快退出

检测到外界的语音断句了，就会退出界面。看一下喇叭离麦克风是不是太近，如果离得太近，喇叭的笛声对麦克风会有一定的影响。另在稍微安静点的环境下测试一下，看是否还有这种问题。

经常出现“我没有听到声音，再见”

1. 喇叭离机器远一点

2. 进入桌面 - 设置 - 通用设置 - 语音设置 - 语音唤醒回复。语音回复选择“语音回复”，试一下

3. 周围环境尽量保持安静

4. 如果以上三个条件都满足，看下能否找到出现该问题的规律，联系我司研发及时查看下

1.1.3. 智能家居相关问题

485对接智能家居，有协议吗？

485对接智能家居没有协议，可以自定义任何指令码

在哪设置门磁警报功能

门磁可以设置-设备管理-传感器配置管理里设置警报功能

小可语控是否支持读取传感器类设备的数据？

例如：

A : 你好，小可
B : 你好，主人
A:  现在室内的PM是多少？

声必可暂未实现此功能

自定义场景执行时，小可的回复语

滑到右屏，点击场景的编辑按钮 → 场景编辑 （在场景提示语框中，输入小可的回复语，点击底部“完成“按钮保存提示语并退出界面）

如何将在线QQ音乐中的音乐设置为场景音乐

在手机QQ音乐app应用内，添加歌曲到收藏歌单文件里，在回到屏上-音乐-我的页面，会同步收藏歌单到屏上显示。

如何设置自定义场景音乐？

1. 添加本地音乐作为场景音乐。可以是下载的歌曲，也可以是复制到机器的歌曲。回到桌面，点击“音乐”按钮，切换到”本地“TAB栏下，点击“刷新”按钮，本地的歌曲将会出现，点击该歌曲右边的 ... 按钮，收藏到自己创建的歌单。
2. 添加在线音乐作为场景音乐。QQ音乐，需要在手机QQ音乐app里创建收藏歌单，添加音乐，然后屏上同账号的QQ音乐下就会同步显示app里的歌单。咪咕的可以在音乐播控界面或歌曲列表中某歌曲右边的 … 按钮，将歌曲收藏到自己创建的歌单
3. 在场景编辑界面选择场景音乐，选择刚才创建添加歌曲的歌单，点击右上角完成，返回保存，当执行场景时就可以播放设置的歌曲或者整个歌单

485发码播放场景音乐（指定音乐或歌单）

1. 在去设置-智能家居设置-485主机管理-配置485接口，波特率那些。（如果是SDK对接智能家居，就是有安装对接插件的，就一定不能打开下面的智能485主机开关。）
2. 485主机管理-场景音乐配置，添加一个场景，在选择编辑。
3. 编辑页面，点击增加，就可以设置接收码
4. 点击场景音乐进入，选择场景歌单,选择后点击保存（歌单创建查看：如何设置自定义场景音乐？）
5. 485线连接主机，主机端接收到相应场景的触发码，就会播放该场景音乐

如何实现执行场景时关闭音乐

左滑到右屏，找到该场景，点击编辑按钮，进入场景编辑页，添加场景音乐那里，选择第一个 “无”，点击”保存“ 按钮保存配置

设置定时播放和暂停音乐

播放： 桌面-设置-场景管理-情景音乐，点击右上角+号，创建情景。选择想要播放的歌单（可以自己创建歌单：1.场景播放指定歌曲（如上：如何设置自定义场景音乐？有创建歌单方式）。2.场景编辑页面。选择场景音乐).设置定时开启,随后保存退出

暂停： 与播放类似，先创建一个相应的情景，在选择场景音乐时选择“无”，在设置暂停时间，保存退出。

开机后处于动画页面，不能进入桌面

1.开机处于第一个动画页面就不动了，直接返回售后 2.开机处于第二个动画页面后不动，可能是桌面应用问题，给客户一个桌面应用APK，客户那边可以在电脑安装360手机助手，通过usb线连接主机和电脑。安装APK重新进入

1.1.4. 外设相关问题

B5是否有低音炮功能？

没有该功能，但可从audio out取音频来混合，外接一些电路上去，而且要接有源低音炮，2个电阻加2个电容，就可以输出到低音炮了

小可主机支持的TF卡最大是多少，有限制的吗？

有限制，最大支持32G

aux in 接线

AUX接口，L/R/G三条线都要接，电视机出来的L和R声道接到aux-in的L和R，电视机的蔽线或者黑色地线接到GND，切到外部音频模式。

1.1.5. 使用相关问题

在哪查看支持的语控指令

语控 “你好，小可” ，进入语音控制页，页面左下角有一个? 按钮，点击即可查看所有支持指令

如何检测升级

桌面顶部下拉-设置 → 设置 → 软件更新 / 或者顶部下拉-应用-系统升级

怎么去掉屏保？

桌面 → 系统设置 → 显示 → 屏幕休眠 ，把开关关闭

提示内存不足时，卸载不需要的应用

卸载不必要的应用的方法：桌面 → 其他应用 → 应用管理 → 点击应用进入 → 点击卸载

删除本地歌曲文件的方法：桌面 → 音乐 → 本地 → 删除

背景音主机插着USB线，频繁开关机时，出现机器一直处于启动画面

开关机之间要停顿20s，因为电源那边需要彻底放电

485编辑场景控制码界面，延迟发送码的时间单位是什么？

毫秒级单位

网络状态良好情况下，播放音乐一直卡顿，如何排查？

1. 检查喇叭接线是否正确，音频线间是否有缠绕

2. 确认1无误后，检查喇叭是否有问题（换个喇叭试，或少接几个喇叭试，排除是否是喇叭的问题，另：我们只支持定阻喇叭，不支持定压喇叭）

3. 确认喇叭接线正常，播放本地音乐是否正常

音乐能正常输出声音，但语音文本播报没有声音

喇叭接线错误，正确的接法是相邻L+和L-，R+和R-相接，详情请对照喇叭接线图。

连接了喇叭，但没有任何声音输出

1. 检查喇叭接线是否正确，音频线是否可用,喇叭正确接法是相邻的R+R-一个喇叭，L+L-一个喇叭

2. 喇叭是否是定阻喇叭，只支持定阻

3. 检查是否开启了静音，音量是否调到了最低

4. 以上三点不行，恢复出厂设置后在测试

5. 以上都不行返修

USB连接不上小可

1. 查看设备USB调试功能是否打开（顶部下拉-设置-关于本机-点击设备号进入，连续点击右下角空白处，出现调试帮助，点击进入，打开USB调试开关）
2. 检查电脑USB驱动
3. 确认是否是USB线的问题，换根线测试
4. 如果是笔记本换台式电脑接入测试

wifi连接不上可以看下面几点（只显示以保存，不能连接）

1. 连不上wifi，就开个手机热点，连接热点试试，热点能连接，就检查wifi问题。热点部分手机也可以设置加密方式，选择wpa2,苹果手机打开最大兼容性开关
2. wifi得加密方式需要选择 wpa2，可以路由器里设置
3. 不要插网线，插了网线是不能连接wifi的
4. 密码输入错误，忘记保存，在重新输入

使用485指令码控制背景音乐播控没反应，如何排查？

桌面 → 设置 → RS485 → 485控制开关，这里的开关要打开。另：该界面设置的房间号要和指令码中设置的ID号一致

使用UDP/TCP控制背景音乐播控没反应，如何排查？

1.wifi，客户端服务端需要同一个网段。

2.485控制开关打开，选择房间号

3.小可是作为服务端，udp调试工具是客户端，填写小可连接网络的IP，udp端口固定是28998，tcp端口固定是60003，接收指定485码进行播控

4.发送和房间号相关的485码，可以尝试更换房间号和485码测试（注意不是十六进制的方式发送）

5.设置中的酒店模式不要打开

6.重启机器后在试

背景音乐主机发码使用UDP/TCP控制智能家居设备失败，如何排查？

1.wifi，客户端服务端需要同一个网段。

2.小可是作为客户端，调试工具或网关服务器作为服务端。小可485配置页输入服务端的ip和端口

3.房间管理查看是否添加设备以及是否添加了控制码和回复码

4.需要注意如果选择的是UDP，这个时候去切换485的方式，之前添加的设备及控制码会清除，切换方式需要重新输入

5.设置中的酒店模式不要打开

6.检查传输方式以否一样，是十六进制还是字符串

说明书二维码位置

桌面顶部下拉 → 系统设置 → 关于本机 - 使用说明

进入微信小程序，局域网下控制屏播控

桌面顶部下拉 → 系统设置 → 关于本机 → 扫码下载APP 进入后，使用微信扫码

485设备控制码配置文件的导出路径

桌面 → 应用 → 文件管理器 → 0 → host_config.ini

能实现不同房间的小可背景音乐主机，同一账号下，语控我要睡觉了，执行不同的设备动作吗？

可以通过场景别名的方式实现：

新建两个场景，绑定相应的设备，在小可背景音乐主机场景编辑页里，场景别名设置成一样的（如：我要睡觉了），就可以实现不同房间语控“我要睡觉了”执行不同的设备动作

设备开不了机，怎么排查

1. 接上220V电看背部红色电源指示灯是否亮起

2. 如果电源灯亮，屏幕仍没反应，断掉220V电，用5V的USB供电看屏幕是否有反应

3. 如果仍没反应只能返厂处理

485设备指令码如何实现在电脑端编辑

设置 → Rs485 → 485主机配置（admin）-打开智能485主机的开关，滑到底部有导入导出配置按钮，在小可主机上配置好波特率和传输方式后，去添加设备，设备指令码可以先随便填，添加完后，点击导出配置按钮，将配置文件导出到文件夹下，小可主机连接电脑查看刚导出的配置文件，打开编辑输入正确指令码保存。回到小可主机，点击“导入配置”按钮，将含有最新指令码的信息导进来即可。

语控今天天气，回复的不是本地天气

该问题根本原因是经IP分析出来的地理位置不准确所致

1. 运营商分配的ip地址是动态的，所以ip地址会经常变化。

2. 全球ip地址库想要做到100%准确是不可能的，百度网页输入“我的ip”用的是百度的ip地址库，每家的ip地址库都会有自己的缺陷。

3. 所以要接受ip地址自动定位有可能错误这种现象。对于语控自动定位天气错误的问题，我们尝试跟语音供应商反馈，看能否自定义位置。

4. 可以先说 “北京今天的天气” ，把位置信息带上

5. 桌面-天气，进入，搜索当前所在城市保存后在试试

1.1.6. 调试相关问题

怎么进入开发者模式

P6:桌面--》应用 --》 设置 --》系统 --》关于背景音乐 --》多次点击“版本号”--》返回上一级 --》重新进入“开发者选项” P3,P5,B6,C6：桌面---》其它应用（文字或机器人图标）---》设置 --》关于本机 ---》连续点击最下面的"版本号"打开开发者模式 ，---》按返回键 ---》开发者选项

M10,S10,P8,B8,M20 :桌面---》顶部下拉通知栏---》设置---》关于本机---》点击设备号进入---》在连续点击右下角空白的地方，会出现跳转原生设置，点击进入---》最底下关于平板电脑 ---》连续点击最下面的"版本号"直到提示开启开发者选项---》返回上级页面，点击系统 ---》点击高级展开后，点击开发者选项进入

查看USB调试功能是否打开

进入开发者选项 ，看USB调试有没有勾上

打开触摸痕迹显示（查看触摸）

桌面---》顶部下拉通知栏---》设置---》关于本机---》点击设备号进入---》在连续点击右下角空白的地方，出现调试帮助 → 显示触摸轨迹 开关打开。点击失效处，看有没有点击痕迹

获取系统日志

开发者选项 ---》勾选“系统日志”(在“USB调试”下方)，系统日志，复现问题后系统日志将存储在/sdcard/jd-log/ 当出现问题后可以使用adb pull /sdcard/jd-log/获取这个文件夹下的日志 除了进开发者选项里打开系统日志，还可以桌面---》顶部下拉通知栏---》设置---》关于本机---》点击设备号进入---》在连续点击右下角空白的地方，出现调试帮助，进入，打开系统日志开关

1.1.7. 蓝牙问题

1. 点击进入蓝牙名称可能显示未知，退出当前界面，再次进入蓝牙界面，看看能否重新获取到
2. 一台背景音乐主机只能和一个手机连接。当一个手机已连接背景音乐主机蓝牙时，其他手机将无法发现背景音乐主机蓝牙

1.1.8. 其他问题

HomeOS系统可以被root吗？

不可以，root后会导致系统升级不成功

客户能否将自己安装在小可主机的软件设为系统级应用？

不可以，需要使用系统签名等操作

如何清理应用数据（如AIS）

桌面 - 应用- 应用管理 - 点击应用进入（AIS） - 在点击存储进入--在点击左边的清除存储空间（清除完，会删除所有应用的数据，包括音乐登录，语音文件）。重新到音乐页面，等待语音初始化完成，登录音乐账号

P3,P5,P6,X8最新版，硬件恢复出厂设置

1. 背景音乐主机断电

2. 按住音量+键，不松开

3. 背景音乐主机上电

4. 当背景音乐主机出现画面时，松开音量+键

5. 按音量-，选择"wipe data/factory reset"，按电源键确认

6. 按音量-, 选择"Yes--delete all user data"，按电源键确认

7. 等待数据清除完毕后，机器会自动重启

M10,S10，硬件恢复出厂设置

1. 背景音乐主机断电
2. 按住右侧顶部第一个按键，长按不松开
3. 背景音乐主机上电
4. 当背景音乐主机出现画面时，松开按键
5. 上下滑动，选择"wipe data/factory reset"，按电源键确认
6. 上下滑动, 选择"Yes--delete all user data"，按电源键确认
7. 等待数据清除完毕后，选择第一行 reboot 重启机器

M20，硬件恢复出厂设置

1. 背景音乐主机断电
2. 长按住旋钮，不要松开
3. 背景音乐主机上电
4. 当背景音乐主机出现画面时，松开按键
5. 上下滑动，选择"wipe data/factory reset"，按电源键确认
6. 上下滑动, 选择"Yes--delete all user data"，按电源键确认
7. 等待数据清除完毕后，选择第一行 reboot 重启机器

界面上操作恢复出厂设置

恢复出厂设置：

P3,P3C： 桌面 → 设置 → 通用设置，多次点击“通用设置”标题，连续点击，向下滑动将出现“恢复出厂设置”

B5：桌面 → 设置 → 通用设置 多次点击“通用设置”标题（小屏86,点击标题的空白处），连续点击，向下滑动将出现“恢复出厂设置”

P5：桌面 → 设置 → 通用设置 → 高级设置，多次点击右侧“高级设置”列表下的空白处，连续点击，将出现“恢复出厂设置”

B6,C6：顶部下拉（从左往右第三个图标）→ 高级选项 → 进入高级选项页面后，连续点击标题高级选项-下滑将出现恢复出厂设置

P6,X8,S10,P8,M20：桌面顶部下拉 → 设置→ 高级选项→ 高级选项（连续点击顶部标题"高级选项"5次） → 下面出现恢复出厂设置

M10：桌面顶部下拉 → 设置→ 高级选项→ 高级选项右边一点空白处（连续点击5次） → 下面出现恢复出厂设置

B8,C8: 顶部下拉-设置-系统管理-进入后，连续点击左上角“系统管理”文字右边的空白处5次，滑到页面最底部，会出现恢复出厂选项

如何上传日志

1. 可以语控时（针对国内机器），直接语控“你好小可，上传日志”。成功后会有弹窗，拍照发下
2. 不能语控时，桌面顶部下拉--》设置--》关于本机--》点击上传日志，成功后会有弹窗，拍照发下

查看设备号

桌面设置 → 通用设置 → 关于本机 （设备号）

1.1.9. 手机端相关问题

手机微信小程序找不到小可背景音乐主机

可从以下方向排查：

1. 手机是否和小可背景音乐主机在同一局域网下

2. 路由器打开UPNP功能，支持局域网广播

3. 小可设置中是否打开了酒店模式（不用打开）

4. 苹果手机需要将微信的 本地网络权限打开

5. 局域网发现不了，可打开手机热点，做局域网，连接手机热点后尝试

6. 若仍然找不到，尝试重启小可和手机重新尝试查找

局域网多房间和呼叫找不到设备

1. 确保机器在一个网段内，连着相同名称的WIFI

2. 路由器打开UPNP功能，支持局域网广播

3. 路由器的端口下面，通过网线再接一个路由器，这种接法，是不行的。

   如果是多个路由器，确保一个是主路由，其它路由功能为WIFI信号放大器，或者中继功能

4. 如果想排除机器功能问题，可以打开手机热点，几台背景音乐主机都连接到手机热点

全宅呼叫或对另一台单独呼提示离线

可以检查下网络是否同一局域网，还有连接的wifi名称不能有特殊字符

语控播放新闻

新闻资源为喜马拉雅，语控时只能是喜马拉雅的新闻频道，具体有哪些，可以点击桌面电台进入喜马拉雅，搜索新闻，就可以查看所有喜马拉雅的新闻频道

怎么安装APK文件

1. 如果电脑安装有adb，可以直接输入adb命令安装（adb install -r 文件所在目录）
2. 下载下来，复制到机器存储。复制可以usb线连接电脑和机器，在电脑上复制，也可以下载到存储卡，把卡插入机器，机器上都有usb调试口以及存储卡插入口。在桌面-其他应用-文件管理里找到复制。复制完，点击安装

安装应用提示解析失败或提示未安装

1. 安装包下载不完整；
2. 下载渠道有问题，非官方或主流应用商店；
3. 存储路径不合法或存储不够；
4. 应用最低支持版本比机器系统android版本高 (一般都是这个，p6,c7是android 8.1,X8,M10,S10,P8,M20是android10.0，其余机器是4.4)
5. 已安装比这个版本更高的了
6. 这个apk设置的cpu架构不支持我们机器。我们机器支持armeabi-v7a，需要apk开发那边修改下

提示“授权失败，服务器返回code-10 msg active record not found”

手机开个热点，把热点名称改为 JdSnStatistics 这个后，屏在连接这个热点