信电助sdk二次开发acc_param配置参数说明
1. SDK自动软挂机触发条件 (auto_api_hangup)
定义在特定信号下是否自动执行软挂机操作。
| 参数名 |
类型 |
默认值 |
说明 |
| busy |
Boolean |
true |
检测到线路忙音信号时是否自动软挂机 |
| phone_hangup |
Boolean |
true |
检测到phone口电话机挂机时是否自动软挂机 |
| phone_offhook |
Boolean |
true |
检测到phone口电话机摘机时是否自动软挂机 |
| polarity |
Boolean |
true |
使用极性反转检测到对方挂机时是否自动软挂机 |
| vad_timeout |
Integer |
600 |
软摘机后多久静音自动挂机（单位：秒）。需启动VAD检测才有效。用于AI领域避免线路异常无法挂机。 |
| act_timeout |
Integer |
36000 |
软摘机多久强制挂机（单位：秒）。用于AI领域避免线路异常无法挂机。 |
2. 电话机状态响应操作
定义检测到电话机状态变化时执行的操作。除喇叭控制外，0表示关闭，1表示打开。删除字段则保留摘机前状态。
2.1 摘机时操作 (on_phone_hook)
| 参数名 |
说明 |
| loud_spk |
大喇叭控制 |
| line_to_hp_spk |
线路转耳机喇叭 |
| mic_to_line |
麦克风转线路 |
| line_to_sndcard_spk |
线路转声卡喇叭 |
| sndcard_mic_to_ub |
声卡麦克风转UB设备 |
2.2 挂机时操作 (on_phone_hangup)
参数同 on_phone_hook，效果类似。
3. 自定义与设备属性
3.1 自定义通道属性 (dev_attr)
仅在事件回调中反馈给应用，不进行实际逻辑操作。
| 参数名 |
值 |
说明 |
| name |
agi-ub-box |
设备名称 |
| nick |
agi-ub |
设备昵称 |
3.2 设备操作属性 (dev_param)
| 参数名 |
类型 |
默认值 |
说明 |
| logout |
Boolean |
true |
是否保存输出日志（建议开启以便排查异常） |
| polarity |
Boolean |
true |
是否使用极性反转检测代替信号音检测。若设备支持（型号带F）且线路开通此功能，建议开启。这是模拟线路精准检测对方挂机的唯一方法。 |
4. 电话线特性参数 (line_param)
配置电话线的号码规则和替换逻辑。
| 参数名 |
说明/值 |
| area_id |
电话线所在城市区号（建议设置，用于手机号加0/删0） |
| code_id |
电话线实际号码（无实际逻辑使用，可不设置） |
| prefix |
出局号码（如分机线需预拨的号码，一般为0或9。建议加逗号延迟，如 9,,） |
| proxy |
代拨号码配置（数组格式）。包含 id（代拨号）和 regular（匹配的正则规则）。 |
| ext |
内部分机号码规则。匹配则视为分机，否则为外线。示例：匹配1-4位数字视为分机 ^\\d{1,4}(\\*)?(#)?$ |
| replace |
号码替换规则：
- in (来电): 如将
086138... 替换为 138... (规则:
086* -> *)
- out (去电): 同上，针对去电号码。
|
5. 话机拨号规则 (phone_dial)
| 参数名 |
值/说明 |
| end_char |
拨号结束符号（如 #） |
| end_size |
拨号长度达到多少即认为结束（如 32） |
| min_dial_size |
最小拨号长度（达到该长度后才开始检测回铃音） |
| timeout |
拨号间隔超时时间（如 5000ms），超时即认为结束 |
| code_end |
号码规则检测：
- ext: 分机号码规则（如
^[8][0-9][0-9]）
- out: 外线号码规则（如手机号
^1[3-9][0-9][0-9]{8}）
|
6. 文件录音与转写 (recfile)
6.1 录音文件参数 (param)
| 参数名 |
说明 |
| filename |
文件名格式（支持动态参数如 ${v_callid}） |
| format |
格式（wav 或 mp3） |
| mode |
通道模式（mono单通, stereo立体声） |
| rate |
mp3压缩率（1-16，16表示约1KB/秒） |
| root |
录音文件根目录 |
| subdir |
多层子目录（自动按日期保存） |
6.2 自动录音启动模式 (start_rec)
- in: 来电启动时机（如
in_connected 接通时）
- out: 去电启动时机（如
out_invite 拨号完成时）
6.3 录音转文字 (ASR) (asr)
注意： 需在 agi_ub_cfg.json 中开启 recfile_asr 模块。
| 参数名 |
说明 |
| enable |
是否启用录音文件转文字功能 |
| vad |
VAD分段参数：
max_sentence_silence: 静音多久表示一句话结束 (ms)min_sentence_voice: 语音开始的最小长度 (ms)min_voice_begin_am: 语音开始的最小幅度sentence_vad_mode: 灵敏度 (0-3, 值越大越灵敏)
|
7. 线路VAD音频检测 (sentence_vad)
系统默认不启动，需调用控制函数打开 sentence_vad 才生效。参数意义同上ASR中的VAD。
max_sentence_silence: 500msmin_sentence_voice: 150msmin_voice_begin_am: 1500sentence_vad_mode: 3
8. 超时与音频设备参数
8.1 超时设置 (timeout)
| 参数名 |
值 |
说明 |
| in_callid |
4001ms |
响铃后多久无来电号码即结束 |
| in_trying |
1001ms |
收到号码后多久无响铃则忽略（视为无效号码） |
8.2 音频设备 (audio_dev)
配置默认使用的耳机和麦克风设备。
- spk (喇叭):
sndcard (声卡) 或 ub_dev (UB设备)
- mic (麦克风):
sndcard 或 ub_dev
- volume: 默认音量 (0-100)
9. 设备增益参数 (ub_gain)
配置设备各通道的音量增益（0为静音）。
| 参数名 |
范围 |
默认值 |
说明 |
| hp_mic |
0-7 |
2 |
设备麦克风增益 |
| hp_spk |
0-15 |
13 |
设备耳机增益 |
| line_in |
0-7 |
4 |
设备line口采集增益 |
| line_out |
0-15 |
12 |
设备line口发送语音增益 |
| loud_spk |
0-7 |
2 |
设备喇叭增益 |