svrooij/sonos2mqtt

Sonos2mqtt

镜像概述和主要用途

Sonos2mqtt是一个Node.js应用，作为Sonos音箱与MQTT服务器之间的桥接工具。它能实时将所有Sonos设备的状态（如播放状态、音量、曲目信息等）发布到MQTT主题，并允许通过MQTT消息实现对Sonos音箱的控制。该工具旨在作为异构智能家居环境的构建块，适用于以MQTT消息代理作为中央消息总线的场景。

核心功能和特性

• 状态发布：自动发现Sonos设备并将其状态（播放/暂停、音量、当前曲目、艺术家等）实时发布到MQTT主题。
• MQTT控制：支持通过MQTT消息控制Sonos设备，包括播放/暂停、音量调节、曲目切换、播放模式调整等操作。
• 高级功能：集成通知和文本转语音（TTS）功能，可向Sonos音箱发送语音通知。
• 可靠依赖：基于开发者自主开发的node-sonos-ts库，确保与Sonos设备的稳定通信和功能扩展。

使用场景和适用范围

• 智能家居集成：将Sonos音箱无缝集成到以MQTT为核心的智能家居系统中，实现与其他智能设备的联动。
• 自动化场景：通过MQTT消息触发Sonos设备动作，如根据家庭活动状态自动调整音乐播放。
• 远程控制：通过MQTT协议实现对Sonos设备的远程监控和控制。

使用方法和配置说明

Docker部署

基本运行命令

bash
docker run -d \
  --name sonos2mqtt \
  --net=host \  # 推荐使用host网络以确保Sonos设备发现功能正常
  -e MQTT_HOST=your-mqtt-broker-ip \  # MQTT服务器地址（必填）
  -e MQTT_PORT=1883 \  # MQTT服务器端口（可选，默认1883）
  -e MQTT_USER=your-mqtt-username \  # MQTT认证用户名（可选）
  -e MQTT_PASSWORD=your-mqtt-password \  # MQTT认证密码（可选）
  svrooij/sonos2mqtt

Docker Compose配置示例

yaml
version: '3'
services:
  sonos2mqtt:
    image: svrooij/sonos2mqtt
    network_mode: host  # 确保Sonos设备发现正常
    environment:
      - MQTT_HOST=mqtt.example.com
      - MQTT_PORT=1883
      - MQTT_USER=mqtt-user
      - MQTT_PASSWORD=mqtt-pass
      - MQTT_PREFIX=sonos  # MQTT主题前缀（可选，默认"sonos"）
      - DEBUG=false  # 是否启用调试模式（可选，默认false）
    restart: unless-stopped

环境变量配置

MQTT主题说明

• 状态发布主题：sonos/<房间名>/state
  发布特定房间Sonos设备的状态信息（JSON格式），包含播放状态、音量、当前曲目等。

• 控制主题：sonos/<房间名>/set
  发送控制命令（JSON格式），例如：

  • 播放：{"state":"play"}
  • 暂停：{"state":"pause"}
  • 调整音量：{"volume":20}（0-100）
  • 文本转语音：{"tts":"欢迎回家"}

依赖说明

该工具依赖https://github.com/svrooij/node-sonos-ts/%E5%BA%93%EF%BC%8C%E8%AF%A5%E5%BA%93%E6%8F%90%E4%BE%9BSonos%E8%AE%BE%E5%A4%87%E9%80%9A%E4%BF%A1%E7%9A%84%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E7%9F%A5%E3%80%81%E6%96%87%E6%9C%AC%E8%BD%AC%E8%AF%AD%E9%9F%B3%E7%AD%89%E9%AB%98%E7%BA%A7%E7%89%B9%E6%80%A7%E3%80%82%E6%9B%B4%E5%A4%9A%E8%AF%A6%E7%BB%86%E6%96%87%E6%A1%A3%E8%AF%B7%E8%AE%BF%E9%97%AE%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E3%80%82