RoomSound

🔊 语音控制全屋音乐播放

通过蓝牙/WiFi音箱播放YouTube音乐及本地音频,支持多设备切换与语音控制

收藏
4.5k
安装
1k
版本
0.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

RoomSound 综合评估

核心用法

RoomSound 是一个面向智能家居场景的多媒体控制技能,赋予 AI Agent 通过语音指令控制音频播放的能力。其主要功能包括:

1. YouTube 音频播放:支持直接播放 URL 或搜索播放,使用 yt-dlp 解析流媒体,mpv 进行无画面音频播放
2. 蓝牙音箱管理:设备发现(bluetoothctl paired-devices)、连接/断开切换、别名映射持久化

3. 音频路由控制:通过 wpctl/pactl 管理 PipeWire/PulseAudio 输出_sink

4. 自然语言交互:用户可用"厨房音箱播放周杰伦"等口语化指令,Agent 自动解析为设备别名+搜索+播放的完整流程

显著优点

  • 硬件生态开放:不绑定特定品牌音箱,支持标准蓝牙协议和 Linux 音频子系统
  • 渐进式初始化:首次运行自动检测依赖、配置 yt-dlp JS 运行时、引导用户建立设备别名
  • 多后端兼容:同时支持 PipeWire(现代标准)和 PulseAudio(遗留系统)
  • 安全确认机制:切换活跃音箱前要求自然语言确认,避免播放中断
  • 结构化命令契约:明确区分搜索展示(只读)与播放执行(副作用),降低误操作风险

潜在缺点与局限性

  • Linux 专属:依赖 apt/bluez/pipewire 等 Linux 生态组件,macOS/Windows 用户无法使用
  • 二进制依赖重:需要 yt-dlp、mpv、bluetoothctl 三个外部工具链,任一缺失即阻断功能
  • 蓝牙连接脆弱性:未实现自动重连逻辑,连接失败时需用户手动介入配对模式
  • 无音量控制指令:文档未提及音量调节,用户需通过系统其他方式控制
  • YouTube 服务依赖:yt-dlp 可能因 YouTube 接口变更而失效,需持续维护

适合人群

  • Linux 桌面/服务器用户(Debian/Ubuntu 系优先)
  • 拥有多房间蓝牙音箱的智能家居爱好者
  • 希望通过语音控制背景音乐播放的技术早期采用者
  • 已部署 PipeWire/PulseAudio 环境的开发者工作站用户

常规风险

  • MAC 地址泄露风险:设备别名映射可能存储敏感硬件标识符
  • 音频劫持风险:恶意指令可能强制切换至未授权蓝牙设备
  • 依赖供应链风险:yt-dlp 来自第三方源,存在潜在供应链攻击面
  • 蓝牙扫描暴露:设备发现过程广播蓝牙活动,可能泄露家庭设备指纹
  • 进程管理风险:mpv 子进程若未妥善回收可能导致僵尸进程或音频独占锁死

RoomSound 内容

手动下载zip · 3.4 kB
QUICK-START-GUIDE.mdtext/markdown
请选择文件