📋 设备 API 文档

KeenPlus 智能设备开放接口，供 MicroPython 应用和第三方开发者使用。

文档总览：3 个接口条目

🧭 嵌入式开发指南

先看这组本地文档，再结合下方 API 条目开发。

00. 开发总览

平台结构、能力边界与开发路线

01. 环境准备

账号、权限、依赖、调试建议

02. 应用目录规范

项目结构、命名规范、发布清单

03. 设备 API 速查

常用接口目录与调用注意事项

04. AI 协作开发指南

给 AI 的上下文模板与提示词模板

05. 性能评估与芯片选型

S3 / P4 / BK7258 基准对比方法

06. 提审与上架流程

从开发到审核通过的完整流程

audio_engine_play_filesince v1.0.0

audio

从 SPIFFS 路径播放音频文件，支持 MP3/FLAC/WAV/APE/AAC 格式。

参数

返回值

esp_err_tESP_OK 成功，ESP_FAIL 文件不存在

C 示例

esp_err_t err = audio_engine_play_file("/spiffs/music/song.mp3");

MicroPython 示例

import esp_audio
esp_audio.play("/spiffs/music/song.mp3")

audio_engine_set_volumesince v1.0.0

audio

设置播放音量，范围 0-100。

参数

返回值

void无返回值

C 示例

audio_engine_set_volume(75);

MicroPython 示例

esp_audio.set_volume(75)

audio_engine_pause_resumesince v1.0.0

audio

暂停或恢复当前正在播放的音频。

返回值

esp_err_tESP_OK

C 示例

audio_engine_pause_resume();

MicroPython 示例

esp_audio.toggle_pause()

选择接口文档，让 AI 自动生成应用代码。