跳到主要内容

录音

录音功能可以将通话中的音频保存到文件中，支持 wav 和 ogg 两种格式。

录音功能在 Invite/Accept 命令的 CallOption 中的 recorder 字段配置，默认关闭。

参数​

recorder_file​

录音文件名。默认为 session_id, 自动生成的 session_id 格式为 s.{uuid} 例如：

s.b3d3dc88-0929-4678-81dc-e5adc40be9c9

如果是绝对路径，则直接使用，否则在 recorder_path 中创建。

recorder_path 默认为 /tmp/recorders，可以在 RustPBX 的配置文件中设置：

config.toml
recorder_path = "/tmp/recorders"

samplerate​

保存文件的采样率，默认 16000。需要配置和 Track 采样率相同：

  • SIP 呼叫默认为 16000hz
  • WebRTC 呼叫依据编解码器决定：
    • G722 16000hz
    • Opus 48000hz
    • 其他 8000hz

ptime​

数据包时间，单位毫秒，默认 200。主要配合采样率用于计算保存文件的 chunk 大小。

format​

保存文件的格式，支持 wav(默认) 和 ogg。

格式同样可以在 RustPBX 的配置文件中设置：

config.toml
recorder_format = "wav"

Event dump​

录音的配置会影响 event dump。

Event dump 在连接 RustPBX 时，设置 dump=true 启用。参见 连接 RustPBX。

dump 文件会和录音文件在同一个目录下，文件名为 session_id.event.jsonl。