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。文件在编译时下载一次并本地缓存。
- type (必填, string):
-