跳转到内容

Audio File 组件

此组件仅适用于基于 ESP32 的芯片。

audio_file 组件允许你将音频文件直接嵌入到设备的固件中。 音频文件可以来自本地文件,或在编译时从 URL 下载。 原始音频数据存储在闪存中,可以通过 Audio File 媒体源 平台播放。

自动检测支持以下音频格式:

  • WAV
  • MP3
  • FLAC
  • Opus(在 OGG 容器中)
# 示例配置条目
audio_file:
- id: alert_sound
file: "sounds/alert.wav"
- id: timer_sound
file: "https://example.com/sounds/timer_finished.flac"
- id: doorbell
file:
type: local
path: "sounds/doorbell.mp3"
  • id (必填, ID):用于引用此音频文件的 ID。在通过媒体源播放时,也用作文件标识符。

  • file (必填):要嵌入的音频文件。可以是简单的字符串,也可以是带有 type 键的映射:

    • 简单形式:字符串值。如果以 http:// 或 https:// 开头,则被视为网络 URL;否则,被视为相对于配置文件的路径。

    • 带类型形式:

      • type (必填, string):local 或 web。

      本地文件:

      • path (必填, string):音频文件的路径(相对于配置文件)。

      网络文件:

      • url (必填, string):下载音频文件的 URL。文件在编译时下载一次并本地缓存。