📋 设备 API 文档
KeenPlus 智能设备开放接口,供 MicroPython 应用和第三方开发者使用。
文档总览:2 个接口条目
🧭 嵌入式开发指南
先看这组本地文档,再结合下方 API 条目开发。
🌐网络/云端(2)
cloud_http_getsince v1.0.0发起 HTTP GET 请求,返回响应体。
参数
url(const char*)请求 URLresp(cloud_http_response_t*)输出:响应结构体,用后调用 free
返回值
esp_err_tESP_OK 成功
C 示例
cloud_http_response_t resp = {0};
cloud_http_get("http://example.com/api/data", &resp);
printf("%s", resp.body);
cloud_http_response_free(&resp);MicroPython 示例
import cloud
data = cloud.http_get("http://example.com/api/data")
print(data)cloud_tts_requestsince v1.0.0调用云端 TTS 服务将文本转为 MP3 音频数据。
参数
text(const char*)待合成文本,UTF-8voice(const char*)声音名称,如 zh-CN-XiaoxiaoNeuralmp3_out(uint8_t**)输出:MP3 数据指针,调用方 freelen_out(size_t*)输出:MP3 数据长度
返回值
esp_err_t
C 示例
uint8_t *mp3; size_t len;
cloud_tts_request("你好世界", "zh-CN-XiaoxiaoNeural", &mp3, &len);
audio_player_play_buffer(mp3, len);
free(mp3);MicroPython 示例
import cloud
mp3 = cloud.tts("你好世界", voice="zh-CN-XiaoxiaoNeural")
esp_audio.play_buffer(mp3)