#pragma once

#include "esp_err.h"

#ifdef __cplusplus
extern "C" {
#endif

/*
 * 同步播放 LittleFS 中的 Opus 提示音。函数负责分帧、下行播放会话和完成等待，
 * 返回时文件句柄已关闭；路径解析和播放超时均在实现内处理。
 */
esp_err_t voice_prompt_play_file(const char *path);

#ifdef __cplusplus
}
#endif