Sendspin Media Source

sendspin 媒体源平台通过 Speaker Source 媒体播放器 播放来自 Sendspin 分组的同步音频。Sendspin 中枢 必须在同一设备上配置。

此平台仅适用于 ESP32 芯片。

# 示例配置条目
sendspin:

media_source:
  - platform: sendspin
    id: sendspin_media_source

media_player:
  - platform: speaker_source
    id: external_media_player
    name: Media Player
    media_pipeline:
      speaker: my_speaker_id
      sources:
        - sendspin_media_source

配置变量

• sample_rate（可选，positive integer）：向 Sendspin 服务器通告的采样率（Hz）。必须在 16000 到 96000 之间。默认为 48000。
• buffer_size（可选，positive integer）：音频缓冲区大小（以字节为单位）。必须至少为 25000。默认为 1000000。
• fixed_delay（可选，Time）：用于补偿的固定已知播放延迟；例如，板载 DAC 引入的处理时间。必须不超过 10ms。默认为 0us。
• initial_static_delay（可选，Time）：初始静态延迟，可在运行时从 Sendspin 服务器调整。用于补偿在配置时未知且可能随设备运行时设置而改变的延迟。从 Sendspin 服务器进行的更新会持久化到闪存。必须不超过 5000ms。默认为 0ms。
• static_delay_adjustable（可选，boolean）：静态延迟默认是否启用。当为 false 时，Sendspin 服务器无法调整静态延迟，配置的增加值也不会添加到播放延迟中。可通过 sendspin.media_source.enable_static_delay_adjustment 和 sendspin.media_source.disable_static_delay_adjustment 操作在运行时切换。默认为 false。
• task_stack_in_psram（可选，boolean）：如果为 true，FreeRTOS 播放任务栈将分配在 PSRAM 而非内部 RAM 中。需要 psram 组件。默认为 false。
• decode_memory（可选，string）：音频解码器传输缓冲区的优先位置。可选 psram 或 internal。在 internal 中分配可减少在 PSRAM 较慢的设备上流播放开始时出现的卡顿，代价是占用更多内部 RAM。对 ESP32-S3 的益处甚微。默认为 psram。
• 媒体源 的所有其他选项。

TIP

fixed_delay 和 initial_static_delay 选项用途不同。对于设备上已知且恒定的延迟（如 DAC 的处理延迟），请使用 fixed_delay。当总体延迟依赖于不同安装之间可能变化的下游设备时，请将 initial_static_delay 与 static_delay_adjustable 配合使用。例如，当辅助线缆连接到外部扬声器时。延迟可在运行时从 Sendspin 服务器进行微调。

操作

sendspin.media_source.enable_static_delay_adjustment 操作

此操作启用从 Sendspin 服务器对静态延迟的运行时调整，并将当前配置的静态延迟值应用于播放。

on_...:
  - sendspin.media_source.enable_static_delay_adjustment:

sendspin.media_source.disable_static_delay_adjustment 操作

此操作禁用静态延迟的运行时调整。配置的静态延迟不再应用于播放，Sendspin 服务器也无法对其进行微调。

on_...:
  - sendspin.media_source.disable_static_delay_adjustment:

参见

• Sendspin
• Speaker Source 媒体播放器
• 媒体源组件
• API 参考：sendspin_media_source.h