diff --git a/docs/issues/99.md b/docs/issues/99.md index de11f13..e825797 100644 --- a/docs/issues/99.md +++ b/docs/issues/99.md @@ -7,18 +7,7 @@ title: 💬 FAQ问题集合 > [!NOTE] > 这个 issue 用来总结报错日志和对应的解决方法。 -## 为何网页能控制播放，语音口令不行 - -语音口令功能默认关闭，需要去设置页面打开【获取对话记录】开关。请谨慎打开这个功能，可能会因为频繁请求导致登陆失败的问题，建议不使用的时候随手关闭。 - -## ❓ XIAOMUSIC_HOSTNAME 怎么填 - -填写 docker 主机的 ip ，**不是小爱音箱的ip**，一般就是网页访问的后台地址里的 ip ，只要确保 ip 和小爱音箱在一个局域网内就行。 - -同时也支持 xx.xx.com 的域名格式，用于配置反代供外网访问，比如小爱音箱和 docker 主机不在同一个局域网内。 - - -## ❓ Login Failed 登陆失败 +## Login Failed 登陆失败 表现就是 **后台看不到设备列表** ，日志中会有对应的报错。 @@ -35,7 +24,9 @@ title: 💬 FAQ问题集合 如果是在 openwrt 类路由器系统上安装的，请检查路由器的防火墙设置。 -## ❓ 网页后台可以播放，语音控制无效 +## 网页后台可以播放，语音控制无效 + +语音口令功能默认关闭，需要去设置页面打开【获取对话记录】开关。请谨慎打开这个功能，可能会因为频繁请求导致登陆失败的问题，建议不使用的时候随手关闭。 这种情况是拉取不到对话记录导致的。 如果是首次在网页后台保存 did 后需要重启一次容器。 @@ -43,7 +34,7 @@ title: 💬 FAQ问题集合 还有一种情况是配错了唤醒口令，可以在小爱音箱app里查看对话记录，也可以查看 xiaomusic 的日志。默认口令前缀是【播放歌曲】，没有这个前缀是无法识别的，说播放音乐是没用的，除非自己设置其他口令词。 已知 `M01/XMYX01JY 小米小爱音箱HD` 获取对话记录的接口比较特殊，需要开启【特殊型号获取对话记录:】开关才能正常语音控制。 -## ❓ 日志显示正在播放，却没有声音 +## 日志显示正在播放，却没有声音 可以点击播放链接按钮，看看默认的那个链接能否播放。 @@ -61,11 +52,11 @@ title: 💬 FAQ问题集合 如果是在 windows 上安装的，请关闭防火墙。另外ip别填localhost，填192开头的那个ip. -## ❓ 无法播放 flac 格式歌曲 +## 无法播放 flac 格式歌曲 -因设备差异和文件格式差异，已知部分设备不支持 flac 格式，比如 L05B L05C 。 +因设备差异和文件格式差异，已知部分设备不支持 flac 格式，比如 L05B L05C 。建议提前用其他工具批量把文件格式转为 mp3 ，也可以在后台设置里打开【转换为MP3】，但是会比较消耗 CPU ，会影响体验。 -## ❓ docker 镜像拉取失败 +## docker 镜像拉取失败 请更换镜像源或者使用代理。不同环境更换镜像源的方式不一样，可以网上搜索自己的 NAS 如何更换镜像源。 @@ -78,11 +69,11 @@ docker tag m.daocloud.io/docker.io/hanxi/xiaomusic:latest hanxi/xiaomusic:latest 更多镜像源见 -## ❓ 启动失败，日志中出现 RuntimeError: can't start new thread +## 启动失败，日志中出现 RuntimeError: can't start new thread 一般是 docker 版本太低，或者系统限制了 docker 使用的 cpu 数量，可以尝试升级 docker 到最新版本。 -## ❓ DNS 解析错误 +## DNS 解析错误 一般会出现下面这样的日志，表现就是设置页面看不到设备列表。 @@ -94,14 +85,7 @@ aiohttp.client_ _exceptions. ClientConnectorError: Cannot connect to host accoun 如果还是不行可以把 docker 的网络模式改成 host 模式。 - -## ❓ 点击播放后需要很久才开始播放的问题 - -这个问题新版本已经解决，如果还存在请反馈。 - -~目前0.3.x版本还存在这个问题没有完全解决，可以暂时回退到0.2.0版本继续使用。~ - -## ❓ 如何配置多个歌曲目录 +## 如何配置多个歌曲目录 ```yaml services: @@ -118,11 +102,11 @@ services: - /data/xiaomusic/conf:/app/conf ``` -冒号左边的 `/data/music1` 和 `/data/music2` 改成你的目录即可。如果你是 windows 的 docker ，可以改成 `D:/music1` 和 `D:/music2`，盘符号开头，用 `/` 分割。 +冒号左边的 `/data/music1` 和 `/data/music2` 改成你的目录即可。如果你是 windows 的 docker ，可以改成 `D:/music1` 和 `D:/music2`，盘符号开头，用 `/` 分割。配置多个歌曲目录时，冒号右边不要有单独的 `/app/music` ，都只能是 `/app/music/` 的子目录。 -如果是 docker 部署的，建议不要去修改 web 后台里的音乐路径和配置路径等等所有路径除非你熟悉 docker 的目录映射机制。 +另外如果是 docker 部署的，建议不要去修改 web 后台里的音乐路径和配置路径等等所有路径除非你熟悉 docker 的目录映射机制。 -## ❓ 能不能中文名 +## 能不能中文名 ```yaml services: @@ -139,15 +123,15 @@ services: - /data/xiaomusic/conf:/app/conf ``` -## ❓ 能不能多层目录 +## 能不能多层目录 可以，每层的每个目录会识别为一个播放列表。 -## ❓ 是否需要手动获取 did +## 是否需要手动获取 did -新版本不需要手动获取配置 did，不需要配置环境变量，直接在 web 后台填入小米账号密码保存后会自动获取到 did ，然后勾选对应的设备即可。 +不需要手动获取配置 did，不需要配置环境变量，直接在 web 后台填入小米账号密码保存后会自动获取到 did ，然后勾选对应的设备即可。 -## ❓ 报错 601 +## 报错 601 报错日志大致如下: @@ -157,15 +141,15 @@ Exception: Error https://api2.mina.mi.com/remote/ubus: {"code":601,"message":"il 原因是没有配置 did ，或者 did 配置错误。可以到设置页面选择正确的设备类型和 did 然后保存。 -## ❓ 新功能没有生效 +## 新功能没有生效 在设置页面重新保存一下，或者删除 setting.json 文件，重新在后台设置一次。 -## ❓ 为什么会先说小爱音箱自带的回答，再说下载中或者过一会儿才播放本地歌曲 +## 为什么会先说小爱音箱自带的回答，再说下载中或者过一会儿才播放本地歌曲 设计原理就是每秒不停的抓取对话记录，然后再打断小爱音箱自带的处理流程。整个过程下来会有延时，所以打断不会很及时，做不到无缝衔接。 -## ❓ 云服务器上能否安装 +## 云服务器上能否安装 可以安装，登录 mi.com 这个步骤可以使用终端里的浏览器 [carbonyl](https://github.com/fathyb/carbonyl) 来操作：