[ English | 简体中文 ]
声学模型 API
声学模型（Sound Model）接口用于处理媒体触发器所需的低层声学模型数据，提供模型加载、卸载、属性/选项查询和热词检测能力。
头文件：#include <media_trigger_model.h>
openvela 实现说明
- 与 Media Trigger 的关系：
media_trigger_*是高层语音唤醒接口（含 DSP 通路），media_trigger_model_*是底层模型操作接口（不涉及音频采集） - 典型用途：自定义识别流程、在特定 PCM 缓冲上跑一次性的关键词检测
- 模型属性/选项：通过
get_properties查询厂商属性，get_options读取推荐的音频采样参数 - 一次性检测：
detect_hotword在给定 PCM 缓冲上做一次同步检测
模型生命周期
media_trigger_model_load
void* media_trigger_model_load(const void* model, size_t size);
加载声学模型数据，返回模型上下文。
参数：
model模型数据起始指针。size模型数据字节数。
返回值：
成功时返回模型上下文指针，失败时返回 NULL。
media_trigger_model_unload
void media_trigger_model_unload(void* context);
卸载已加载的模型上下文。
参数：
context待卸载的模型上下文。
模型属性查询
media_trigger_model_get_properties
void media_trigger_model_get_properties(void* properties, size_t* size);
查询厂商提供的模型属性信息。
参数：
properties输出缓冲区，用于存放属性数据。size输入输出参数：调用时表示缓冲区大小，返回时被更新为实际写入的字节数。
media_trigger_model_get_options
void media_trigger_model_get_options(void* context, char* options, size_t size);
查询模型推荐的音频采集选项字符串，例如 "format=s16le:sample_rate=16000:ch_layout=mono"。
参数：
context模型上下文（由media_trigger_model_load返回）。options输出缓冲区，用于接收选项字符串。size输出缓冲区字节数。
media_trigger_model_get_buffer_size
void media_trigger_model_get_buffer_size(void* context, size_t* size);
查询模型推荐的录音缓冲区大小。
参数：
context模型上下文。size输出参数，返回推荐的缓冲区字节数。
热词检测
media_trigger_model_detect_hotword
bool media_trigger_model_detect_hotword(void* context, const char* buffer, size_t size);
在给定 PCM 缓冲上运行一次模型检测，判断是否匹配到热词。
参数：
context模型上下文。buffer待检测的 PCM 音频缓冲区。size缓冲区字节数。
返回值：
检测到热词时返回 true，未检测到返回 false。