Expand description
常用选项键常量与会话选项构造器。
上游选项是无类型的字符串键值(options: { "key": "value" }),配错键名
不会报错、只会被静默忽略(教训:vad_threshold 在上游从未存在,
silero/marblenet 的阈值键都是 request::THRESHOLD;
更隐蔽的是形状:会话选项必须包在 "options" 对象里传,扁平键同样被
静默丢弃)。本模块把源码级核实过的键收敛为常量,拼写错误在编译期暴露;
族名前缀别名(如 sortformer_diar.session_len_sec)与裸键等价
(shim 内的归一化表负责映射,前提是包对了形状)。
键分两类,传参位置不同不可混用:
request:随请求走(crate::Request::option),如language;session:随会话走(SessionOptions→crate::Model::create_task_session的session_options),如session_len_sec。
§示例
use audio_cpp::options::{SessionOptions, request, session};
use audio_cpp::Request;
// 请求选项:直接用常量当键
let req = Request::asr("./speech.wav").option(request::LANGUAGE, "zh");
// 会话选项:builder 拼出 create_task_session 要的 JSON 字符串
//(注意是 {"options": {...}} 嵌套形状,与 Request::to_json 同款;
// shim 只读嵌套 "options" 对象,扁平键会被静默丢弃)
let opts = SessionOptions::new()
.session_len_sec(100.0)
.graph_capacity_mode(session::graph_capacity::GROW);
assert_eq!(
opts.to_json(),
r#"{"options":{"graph_capacity_mode":"grow","session_len_sec":100.0}}"#
);Modules§
- request
- 请求选项键(随
crate::Request::option走)。 - session
- 会话选项键(随
SessionOptions走,建会话时一次传入)。
Structs§
- Session
Options - 会话选项构造器:拼出
crate::Model::create_task_session的session_options参数要的 JSON 字符串。