跳转到内容

Sendspin

sendspin 组件增加了对 Sendspin 的支持, 这是一种多房间同步音频协议。hub 管理与 Sendspin 服务器的连接,并将状态更新分发给任何 Sendspin 子组件。

该设备使用 mDNS 来发现网络上的 Sendspin 服务器,因此你的网络上不能阻止 mDNS 流量。设备与服务器之间的 TCP 端口 8928 也必须 可达。

仅 hub 本身不会暴露任何面向用户的实体。一旦网络中存在 Sendspin 服务器,它将连接到设备并开始发送组状态更新,但音频播放、控制和元数据需要 相应的子组件也已配置。

此平台仅适用于基于 ESP32 的芯片。

WARNING

Sendspin 协议尚未最终定稿,此组件被视为 实验性。随着协议和组件的发展,未来的 ESPHome 版本中可能会发生破坏性更改。

# 示例配置条目
sendspin:
  • id (可选, ID): 手动指定此 hub 的 ID。如果你想从子组件中显式引用此 hub,则为必选。
  • task_stack_in_psram (可选, boolean): 将内部 HTTP 服务器任务栈放在 PSRAM 中,以减少内部 RAM 占用。需要已配置 Psram 组件。默认为 false。

此操作将 Sendspin 客户端切换到下一个活动组。

on_...:
- sendspin.switch:
  • Sendspin 组媒体播放器:将组范围的 播放和音量控制作为 Home Assistant 媒体播放器实体暴露。
  • Sendspin 媒体源:通过 Speaker Source 媒体播放器播放 Sendspin 组的同步音频。
  • Sendspin 传感器:暴露有关当前播放音频的数值元数据 (曲目进度、曲目时长等)。
  • Sendspin 文本传感器:暴露有关 当前播放音频的元数据(标题、艺术家、专辑等)。