xiaomusic 多音箱立体声与全屋播放实战设备分组、米家组合与社区最优解【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic本篇围绕 xiaomusic 在真实场景中遇到的多台小爱音箱如何同时播放问题展开完整梳理 issue #235 中用户与开发者围绕立体声、全屋播放、设备分组展开的实测记录与方案讨论并结合仓库源码config.py、device_manager.py、device_player.py解析多设备播放的实现机制与不同步根因。读完你将掌握xiaomusic 原生设备分组的配置方法及其局限、米家全屋播放/立体声组合与 xiaomusic 的兼容边界、社区验证可行的 DLNA 与蓝牙容器方案以及每套方案的适用前提。背景问题的本质是多设备同时驱动小爱音箱的单机播放能力已经很成熟但当用户拥有两台甚至更多台音箱例如小爱音箱 Pro LX06 小爱音箱 L06A或两台 Xiaomi Sound Pro时就会遇到两类诉求立体声将左右声道拆开分别发给两台音箱形成立体声场全屋播放 / 多房间同步多台音箱同时播放同一首歌声音尽量对齐。issue #235 记录的就是这样一个真实案例用户 zazhi4 基于 xiaomusic 0.3.69 版本购入第二台 L06A 后尝试双音箱方案逐一测试了设备分组米家立体声组合米家全屋播放三条路径得到的结论并不理想。开发者 hanxi 以及多位社区用户随后贡献了大量实测数据最终收敛出几套可落地的解法。xiaomusic 原生方案设备分组group_list配置入口与格式xiaomusic 提供了一套原生的多设备驱动能力配置项为group_list在 Web 设置页面的设备标签页中对应设备分组配置输入框setting.html 中给出的占位符格式为did1:组名1,did2:组名1,did3:组名2即同一组内的设备用冒号指定组名多组之间用逗号分隔。这一格式与配置文件中的定义完全一致config.py 中声明为group_list: str os.getenv(XIAOMUSIC_GROUP_LIST, ) # did1:group_name,did2:group_name同时在 config-example.json 中该字段默认值为空字符串devices默认为空字典mi_did默认为空字符串其注释为逗号分割支持多设备。也就是说要让两台音箱进入同一分组需要在 Web 设置页保存小米账号密码后让 xiaomusic 拉取到设备列表此时devices中会出现每台音箱的did、device_id、hardware、name等信息在设备分组配置中填写did1:组名1,did2:组名1将两台音箱放入同一个组也可以将mi_did填为逗号分隔的多个 did 作为多设备基础配置。源码中的分组机制设备分组的解析与驱动逻辑分别落在两个模块device_manager.py 的_update_devices()通过parse_str_to_dict(self.config.group_list, d1,, d2:)将字符串解析为did - 组名的映射解析函数定义见 text_utils.py然后为每个设备构建XiaoMusicDevice实例并记录groups[组名] [device_id, ...]播放时device_player.py 的group_player_play()会取出该组全部设备 ID用asyncio.gather并发地向每台设备下发播放指令async def group_player_play(self, url, name): 同一组设备播放 device_id_list self.xiaomusic.device_manager.get_group_device_id_list( self.group_name ) tasks [ self.play_one_url(device_id, url, name) for device_id in device_id_list ] results await asyncio.gather(*tasks)此外停止播放stop、强制停止group_force_stop_xiaoai、取消下一曲定时器cancel_group_next_timer也都是以组为单位对组内全部设备生效的。实测效果与局限issue #235 中用户 zazhi4 的实测评论 3表明在设置页勾选两个音箱、并在设备分组配置中将两个 did 配为 1 个组后两台音箱确实能同时发声但不同步时间上差了不到 1 秒钟。这个结果与源码实现是吻合的——从源码结构看group_player_play只是把同一个播放 URL 并发下发给组内每台设备每台设备随后各自独立走play_one_url→ 各自启动基于本机时钟的下一曲定时器set_next_music_timeout组内没有任何时钟对齐或进度同步机制因此能同时响、但会有进度偏差是该方案的固有限制。正因为如此设置页面中该配置项被明确标注为设备分组配置不推荐声音不同步这也是 hanxi 在评论 1 中直接引用的既有结论。米家侧方案全屋播放与立体声组合既然 xiaomusic 设备分组存在不同步问题用户很自然会转向米家 APP 侧的能力——全屋播放与立体声组合。issue 中的实测评论 3、评论 6给出了一组关键结论方案xiaomusic 触发时米家/其他来源触发时米家全屋播放只有被选中驱动的那一台有声音对播放无影响多个音箱同时播进度同步且后续会自动全屋播放评论 2F-loat米家立体声组合只有一台有声音设置后对播放没有影响立体声音效测试、米家内 QQ 音乐播放均能形成立体声评论 4xiaomusic 设备分组两台同时发声但时间差不到 1 秒——其中值得注意的两点全屋播放进度同步评论 2F-loat给出的流程是先用一个音箱播放然后米家里设置全屋播放这样多个音箱同时播、进度也同步且后续自动全屋播放立体声只在米家主动发音时成立评论 4zazhi4经测试确认米家 APP 内的立体声音效测试和 QQ 音乐都能让两台音箱构成立体声而其他方法比如蓝牙或 AUX都没法实现立体声推测是米家主动发音时在服务端拆解了左右声道并分别发往两台音箱。而对 xiaomusic 而言无论用户在米家里配置了立体声还是全屋播放xiaomusic 的下发路径都只驱动设置页勾选的那一台设备评论 3、评论 6 验证设置 A 则 B 无声设置 B 则 A 无声米家侧的组合同步效果并不会被 xiaomusic 的播放指令继承。社区验证可行的方案DLNA 推送与小米立体声主副音箱方案一DLNA 推送延迟极小评论 10winsel提供了一个实测方案两台 L06A 在米家 APP 中打开 DLNA 并组成立体声后用安卓手机上的椒盐音乐播放器推送到小爱音箱的 DLNA 服务显示的就是立体声组合名推送后左右延迟很小几乎察觉不到。相比 xiaomusic 设备分组的不到 1 秒偏差DLNA 推送的同步质量明显更好。该用户进一步建议 xiaomusic 增加一个采用 DLNA 推送模式播放的立体声选项——这可以作为后续功能方向参考注意当前仓库代码中并未实现 DLNA 播放通道该方案目前只能通过第三方播放器完成。方案二小米立体声组合 主音箱指令Sound Pro 实测评论 11lgcscu给出了更省事的做法两台小爱音箱 Sound Pro 在米家里组合立体声后组合本身有主、副之分按组合顺序比如左边为主音箱只要对主音箱下发播放指令副音箱就会同步播放、没有偏差完全依靠小米自己的立体声组合能力不需要 xiaomusic 单独支持。该用户还补充了一个细节需要勾选 xiaomusic 的连续播放选项Sound Pro 的灯光效果在 xiaomusic 触发的播放中才能正常工作不勾选则无灯光效果而小爱音箱自己的播放有。适用前提该方案依赖小米立体声组合本身具备主箱转发能力不同型号行为可能不一致例如 zazhi4 的 LX06 L06A 组合、以及 L06A 的组合场景下xiaomusic 触发并不能让副箱发声。因此该方案更适合同型号且组合后支持主箱联动的设备实际效果需以自己设备的固件表现为准。方案三蓝牙 独立容器播放器同步效果最好评论 12aidyli分享了一套自定义程度最高的方案把 USB 蓝牙适配器挂载到一个新的 Ubuntu/Debian 容器中运行带蓝牙与 mpv 播放器的容器bluetooth-audio-sidecar让该容器连接米家的立体声组合将容器与 xiaomusic 放进同一个 docker compose 中通过 xiaomusic 下发指令完成播放与语音控制再借助额外 Python 脚本实现指令下发与蓝牙连接/断开管理。该用户实测不会存在同步问题环境为绿联 DX4600 docker 跑 xiaomusic bluetooth-audio-sidecar 容器组。这条路径本质上是绕开 xiaomusic 直连音箱改为让能正确驱动立体声组合的音频源蓝牙 mpv发声。方案四蓝牙直连主音箱受浏览器限制评论 13zazhi4尝试过蓝牙连接立体声组合中的主音箱然后在 xiaomusic Web 界面选择手机作为播放源由手机将信号交给主音箱分发。实测立体声可以成立但浏览器界面播放一段时间后会停止疑似与手机屏幕常亮/后台限制有关。这条路径实现成本低但稳定性差仅作为参考。技术方向讨论为什么立体声对 xiaomusic 是难题在评论 8 中zazhi4 归纳了三条可能的实现路径hanxi评论 9对此确认思路是对的感兴趣可以抓包玩玩的目前协议是没加密的左右分轨直推xiaomusic 将声音拆分为左右声道分别发往两台音箱难点在于如何保证两台音箱同时收到指令并发声模拟米家 APP 接口由 xiaomusic 完成米家 APP 侧的立体声/全屋播放能力让音箱以为声音来自米家DLNA 模式参考方案一的成功经验在 xiaomusic 内增加 DLNA 推送通道。其中路径 1 社区已有尝试评论 12 中 aidyli 提到试过 xiaomusic 左右分轨可以实现立体声但大概率出现不同步与前面源码分析的结论相互印证问题不在声道拆分而在两台音箱独立播放时钟的同步。路径 2 依赖于对小米私有协议的逆向协议未加密具备可行性但工作量大、且随小米服务端调整存在失效风险。总结与选型建议结合 issue #235 全部实测与仓库源码多音箱场景的选型建议如下能接受同时响但轻微不同步使用 xiaomusic 设备分组配置group_list一行配置即可让组内多台音箱同时发声适合背景音乐等对同步不敏感的场景追求进度严格同步的全屋播放先由任意一台音箱在 xiaomusic 中播放再到米家 APP 设置全屋播放F-loat 方案多音箱进度同步且可持续追求真正立体声优先尝试小米立体声组合若设备支持主箱联动如 Sound Pro 实测直接对主音箱下发指令即可否则借助支持 DLNA 的播放器如椒盐音乐推送到立体声组合或在 docker 中引入蓝牙 mpv 容器作为音频源自定义能力强、愿意折腾参考 aidyli 的容器化方案将 xiaomusic 的语音控制与立体声输出解耦可获得同步质量最好的效果。最后需要说明xiaomusic 目前已在 docs/issues/index.md 中公告停止维护上述能力以当前仓库代码约 0.3.x 版本为准设备型号、固件版本与米家服务端策略会持续变化实测结论请以你自己的设备表现为准。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 xiaomusic 多音箱立体声与全屋播放实战：设备分组、米家组合与社区最优解
xiaomusic 多音箱立体声与全屋播放实战设备分组、米家组合与社区最优解【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic本篇围绕 xiaomusic 在真实场景中遇到的多台小爱音箱如何同时播放问题展开完整梳理 issue #235 中用户与开发者围绕立体声、全屋播放、设备分组展开的实测记录与方案讨论并结合仓库源码config.py、device_manager.py、device_player.py解析多设备播放的实现机制与不同步根因。读完你将掌握xiaomusic 原生设备分组的配置方法及其局限、米家全屋播放/立体声组合与 xiaomusic 的兼容边界、社区验证可行的 DLNA 与蓝牙容器方案以及每套方案的适用前提。背景问题的本质是多设备同时驱动小爱音箱的单机播放能力已经很成熟但当用户拥有两台甚至更多台音箱例如小爱音箱 Pro LX06 小爱音箱 L06A或两台 Xiaomi Sound Pro时就会遇到两类诉求立体声将左右声道拆开分别发给两台音箱形成立体声场全屋播放 / 多房间同步多台音箱同时播放同一首歌声音尽量对齐。issue #235 记录的就是这样一个真实案例用户 zazhi4 基于 xiaomusic 0.3.69 版本购入第二台 L06A 后尝试双音箱方案逐一测试了设备分组米家立体声组合米家全屋播放三条路径得到的结论并不理想。开发者 hanxi 以及多位社区用户随后贡献了大量实测数据最终收敛出几套可落地的解法。xiaomusic 原生方案设备分组group_list配置入口与格式xiaomusic 提供了一套原生的多设备驱动能力配置项为group_list在 Web 设置页面的设备标签页中对应设备分组配置输入框setting.html 中给出的占位符格式为did1:组名1,did2:组名1,did3:组名2即同一组内的设备用冒号指定组名多组之间用逗号分隔。这一格式与配置文件中的定义完全一致config.py 中声明为group_list: str os.getenv(XIAOMUSIC_GROUP_LIST, ) # did1:group_name,did2:group_name同时在 config-example.json 中该字段默认值为空字符串devices默认为空字典mi_did默认为空字符串其注释为逗号分割支持多设备。也就是说要让两台音箱进入同一分组需要在 Web 设置页保存小米账号密码后让 xiaomusic 拉取到设备列表此时devices中会出现每台音箱的did、device_id、hardware、name等信息在设备分组配置中填写did1:组名1,did2:组名1将两台音箱放入同一个组也可以将mi_did填为逗号分隔的多个 did 作为多设备基础配置。源码中的分组机制设备分组的解析与驱动逻辑分别落在两个模块device_manager.py 的_update_devices()通过parse_str_to_dict(self.config.group_list, d1,, d2:)将字符串解析为did - 组名的映射解析函数定义见 text_utils.py然后为每个设备构建XiaoMusicDevice实例并记录groups[组名] [device_id, ...]播放时device_player.py 的group_player_play()会取出该组全部设备 ID用asyncio.gather并发地向每台设备下发播放指令async def group_player_play(self, url, name): 同一组设备播放 device_id_list self.xiaomusic.device_manager.get_group_device_id_list( self.group_name ) tasks [ self.play_one_url(device_id, url, name) for device_id in device_id_list ] results await asyncio.gather(*tasks)此外停止播放stop、强制停止group_force_stop_xiaoai、取消下一曲定时器cancel_group_next_timer也都是以组为单位对组内全部设备生效的。实测效果与局限issue #235 中用户 zazhi4 的实测评论 3表明在设置页勾选两个音箱、并在设备分组配置中将两个 did 配为 1 个组后两台音箱确实能同时发声但不同步时间上差了不到 1 秒钟。这个结果与源码实现是吻合的——从源码结构看group_player_play只是把同一个播放 URL 并发下发给组内每台设备每台设备随后各自独立走play_one_url→ 各自启动基于本机时钟的下一曲定时器set_next_music_timeout组内没有任何时钟对齐或进度同步机制因此能同时响、但会有进度偏差是该方案的固有限制。正因为如此设置页面中该配置项被明确标注为设备分组配置不推荐声音不同步这也是 hanxi 在评论 1 中直接引用的既有结论。米家侧方案全屋播放与立体声组合既然 xiaomusic 设备分组存在不同步问题用户很自然会转向米家 APP 侧的能力——全屋播放与立体声组合。issue 中的实测评论 3、评论 6给出了一组关键结论方案xiaomusic 触发时米家/其他来源触发时米家全屋播放只有被选中驱动的那一台有声音对播放无影响多个音箱同时播进度同步且后续会自动全屋播放评论 2F-loat米家立体声组合只有一台有声音设置后对播放没有影响立体声音效测试、米家内 QQ 音乐播放均能形成立体声评论 4xiaomusic 设备分组两台同时发声但时间差不到 1 秒——其中值得注意的两点全屋播放进度同步评论 2F-loat给出的流程是先用一个音箱播放然后米家里设置全屋播放这样多个音箱同时播、进度也同步且后续自动全屋播放立体声只在米家主动发音时成立评论 4zazhi4经测试确认米家 APP 内的立体声音效测试和 QQ 音乐都能让两台音箱构成立体声而其他方法比如蓝牙或 AUX都没法实现立体声推测是米家主动发音时在服务端拆解了左右声道并分别发往两台音箱。而对 xiaomusic 而言无论用户在米家里配置了立体声还是全屋播放xiaomusic 的下发路径都只驱动设置页勾选的那一台设备评论 3、评论 6 验证设置 A 则 B 无声设置 B 则 A 无声米家侧的组合同步效果并不会被 xiaomusic 的播放指令继承。社区验证可行的方案DLNA 推送与小米立体声主副音箱方案一DLNA 推送延迟极小评论 10winsel提供了一个实测方案两台 L06A 在米家 APP 中打开 DLNA 并组成立体声后用安卓手机上的椒盐音乐播放器推送到小爱音箱的 DLNA 服务显示的就是立体声组合名推送后左右延迟很小几乎察觉不到。相比 xiaomusic 设备分组的不到 1 秒偏差DLNA 推送的同步质量明显更好。该用户进一步建议 xiaomusic 增加一个采用 DLNA 推送模式播放的立体声选项——这可以作为后续功能方向参考注意当前仓库代码中并未实现 DLNA 播放通道该方案目前只能通过第三方播放器完成。方案二小米立体声组合 主音箱指令Sound Pro 实测评论 11lgcscu给出了更省事的做法两台小爱音箱 Sound Pro 在米家里组合立体声后组合本身有主、副之分按组合顺序比如左边为主音箱只要对主音箱下发播放指令副音箱就会同步播放、没有偏差完全依靠小米自己的立体声组合能力不需要 xiaomusic 单独支持。该用户还补充了一个细节需要勾选 xiaomusic 的连续播放选项Sound Pro 的灯光效果在 xiaomusic 触发的播放中才能正常工作不勾选则无灯光效果而小爱音箱自己的播放有。适用前提该方案依赖小米立体声组合本身具备主箱转发能力不同型号行为可能不一致例如 zazhi4 的 LX06 L06A 组合、以及 L06A 的组合场景下xiaomusic 触发并不能让副箱发声。因此该方案更适合同型号且组合后支持主箱联动的设备实际效果需以自己设备的固件表现为准。方案三蓝牙 独立容器播放器同步效果最好评论 12aidyli分享了一套自定义程度最高的方案把 USB 蓝牙适配器挂载到一个新的 Ubuntu/Debian 容器中运行带蓝牙与 mpv 播放器的容器bluetooth-audio-sidecar让该容器连接米家的立体声组合将容器与 xiaomusic 放进同一个 docker compose 中通过 xiaomusic 下发指令完成播放与语音控制再借助额外 Python 脚本实现指令下发与蓝牙连接/断开管理。该用户实测不会存在同步问题环境为绿联 DX4600 docker 跑 xiaomusic bluetooth-audio-sidecar 容器组。这条路径本质上是绕开 xiaomusic 直连音箱改为让能正确驱动立体声组合的音频源蓝牙 mpv发声。方案四蓝牙直连主音箱受浏览器限制评论 13zazhi4尝试过蓝牙连接立体声组合中的主音箱然后在 xiaomusic Web 界面选择手机作为播放源由手机将信号交给主音箱分发。实测立体声可以成立但浏览器界面播放一段时间后会停止疑似与手机屏幕常亮/后台限制有关。这条路径实现成本低但稳定性差仅作为参考。技术方向讨论为什么立体声对 xiaomusic 是难题在评论 8 中zazhi4 归纳了三条可能的实现路径hanxi评论 9对此确认思路是对的感兴趣可以抓包玩玩的目前协议是没加密的左右分轨直推xiaomusic 将声音拆分为左右声道分别发往两台音箱难点在于如何保证两台音箱同时收到指令并发声模拟米家 APP 接口由 xiaomusic 完成米家 APP 侧的立体声/全屋播放能力让音箱以为声音来自米家DLNA 模式参考方案一的成功经验在 xiaomusic 内增加 DLNA 推送通道。其中路径 1 社区已有尝试评论 12 中 aidyli 提到试过 xiaomusic 左右分轨可以实现立体声但大概率出现不同步与前面源码分析的结论相互印证问题不在声道拆分而在两台音箱独立播放时钟的同步。路径 2 依赖于对小米私有协议的逆向协议未加密具备可行性但工作量大、且随小米服务端调整存在失效风险。总结与选型建议结合 issue #235 全部实测与仓库源码多音箱场景的选型建议如下能接受同时响但轻微不同步使用 xiaomusic 设备分组配置group_list一行配置即可让组内多台音箱同时发声适合背景音乐等对同步不敏感的场景追求进度严格同步的全屋播放先由任意一台音箱在 xiaomusic 中播放再到米家 APP 设置全屋播放F-loat 方案多音箱进度同步且可持续追求真正立体声优先尝试小米立体声组合若设备支持主箱联动如 Sound Pro 实测直接对主音箱下发指令即可否则借助支持 DLNA 的播放器如椒盐音乐推送到立体声组合或在 docker 中引入蓝牙 mpv 容器作为音频源自定义能力强、愿意折腾参考 aidyli 的容器化方案将 xiaomusic 的语音控制与立体声输出解耦可获得同步质量最好的效果。最后需要说明xiaomusic 目前已在 docs/issues/index.md 中公告停止维护上述能力以当前仓库代码约 0.3.x 版本为准设备型号、固件版本与米家服务端策略会持续变化实测结论请以你自己的设备表现为准。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考