小米AI音箱播放无声音问题排查与解决指南

小米AI音箱播放无声音问题排查与解决指南

xiaomusic 使用小爱同学播放音乐，音乐使用 yt-dlp 下载。 项目地址: https://gitcode.com/gh_mirrors/xia/xiaomusic

在使用hanxi/xiaomusic项目时，部分用户反馈小米AI音箱一代虽然能成功下载音乐文件，但在播放时却没有声音输出。这是一个常见但容易解决的问题，本文将详细分析问题原因并提供解决方案。

问题现象

用户通过docker部署hanxi/xiaomi项目后，观察到以下现象：

1. 音乐文件能够正常下载到本地
2. 日志显示播放命令已成功执行
3. 音箱显示播放状态
4. 但实际没有声音输出

根本原因分析

经过排查，发现问题的根源在于XIAOMUSIC_HOSTNAME环境变量配置错误。这个变量用于指定音乐文件的访问地址，如果配置不正确会导致以下问题：

1. 音箱无法正确获取音频流
2. 虽然播放命令发送成功，但实际音频数据无法传输
3. 系统日志显示正常，但实际播放失败

解决方案

要解决此问题，需要确保以下几点配置正确：

1. 检查XIAOMUSIC_HOSTNAME配置：

   • 该变量应设置为宿主机的实际IP地址
   • 确保IP地址在局域网内可访问
   • 避免使用localhost或127.0.0.1这类本地回环地址

2. 验证网络连通性：

   • 确保音箱与宿主机在同一局域网
   • 测试从音箱能否ping通宿主机IP
   • 检查防火墙设置，确保8090端口开放

3. 正确配置docker网络：

   • 如果使用docker部署，确保使用正确的网络模式
   • 推荐使用host模式或正确配置端口映射

配置示例

正确的docker-compose配置示例：

version: '3'
services:
  xiaomusic:
    image: hanxi/xiaomusic
    environment:
      - XIAOMUSIC_HOSTNAME=192.168.1.100 # 这里改为实际的宿主机IP
    ports:
      - "8090:8090"
    volumes:
      - ./music:/app/music

验证方法

配置完成后，可以通过以下步骤验证问题是否解决：

1. 在浏览器中访问http://[宿主机IP]:8090/music/测试.mp3，确认能正常下载音乐文件
2. 使用音箱播放音乐，观察是否有声音输出
3. 检查docker日志，确认没有错误信息

总结

小米AI音箱播放无声音的问题通常是由于网络配置不当导致的。通过正确配置XIAOMUSIC_HOSTNAME环境变量，确保音箱能够访问到宿主机的音乐文件服务，即可解决此问题。对于docker部署的场景，还需要特别注意网络模式和端口映射的正确配置。

xiaomusic 使用小爱同学播放音乐，音乐使用 yt-dlp 下载。 项目地址: https://gitcode.com/gh_mirrors/xia/xiaomusic