Sonos Announce

在Sonos扬声器上播放音频文件，并智能恢复播放状态。

使用场景

• - 用户想在Sonos上播放通知
• 音效板效果（气喇叭、鼓点等）
• 任何需要恢复之前状态的音频播放

此技能仅处理播放 - 音频生成（TTS、ElevenLabs等）是独立功能。

快速开始

python
import sys
import os
sys.path.insert(0, /path/to/sonos-announce)
from sonos_core import announce

播放音频并恢复之前状态

假设音频位于默认media_dir目录（~/.local/share/openclaw/media/outbound）

安装

bash
pip install soco

依赖项：

• - python3 - Python 3
• ffprobe - ffmpeg的一部分，用于检测音频时长
• soco - Python Sonos库

核心函数

python
announce(audiofilepath, waitforaudio=True, media_dir=None)

参数

返回值

python
{
coordinators: 2,
states: {
192.168.1.120: {
uri: x-sonos-spotify:spotify%3atrack%3a...,
position: 0:01:23,
queue_position: 5,
was_playing: True,
is_external: False,
transport_state: PLAYING,
speaker_name: Bedroom
}
}
}

使用示例

简单用法（文件在默认媒体目录中）

python
from sonos_core import announce

从默认media_dir提供文件

自定义媒体目录

python
from sonos_core import announce

音频文件的完整路径

完整路径（不使用media_dir）

python
from sonos_core import announce

使用文件所在目录作为media_dir

环境变量

配置用于流式传输到Sonos的HTTP服务器：

bash

运行前设置（可选）

或在代码中导入前设置

from sonos_core import announce
announce(audio.mp3)

支持平台

模块会自动检测您的平台，并使用相应命令：

• - 终止HTTP服务器
• 在后台启动HTTP服务器

状态恢复

模块智能恢复之前的播放状态：

跳转行为

某些流媒体服务不支持跳转到特定位置：

• - 可跳转：Spotify曲目、Spotify播放列表、本地文件、队列项目
• 不可跳转：Spotify电台、TuneIn电台、Pandora、Tidal电台

模块会自动检测这些情况并进行相应处理。

外部输入检测

自动检测无法暂停的输入：

• - x-rincon:RINCON - 线路输入
• x-rincon-stream:RINCON - 线路输入流
• x-sonos-htastream: - 电视/HDMI（Sonos家庭影院）
• x-sonos-vanished: - 已消失的设备
• x-rincon-bt:* - 蓝牙

音效板示例

python
from sonos_core import announce

SOUNDS = {
airhorn: /path/to/sounds/airhorn.mp3,
rimshot: /path/to/sounds/rimshot.mp3,
victory: /path/to/sounds/victory.mp3,
}

def play_sound(name):
播放音效。
if name in SOUNDS:
announce(SOUNDS[name])
else:
print(f未知音效：{name})

故障排除

文件

• - sonos_core.py - 包含announce()函数的主模块
• SKILL.md - 本文档