一、介绍

相关资料
Freeswitch关于soundtouch介绍

soundtouch下载

mod_soundtouch只有刺啦刺啦声音问题

FreeSWITCH使用soundtouch进行变声

二、安装soundtouch

我这里使用的环境docker是debian。其他环境也可以。

2.1 源码安装方式（推荐）

2.1.1下载源码

https://codeberg.org/soundtouch/soundtouch/tags

放到合适的位置，进行解压

2.1.2解压

tar -zxvf  soundtouch-2.3.3.tar.gz

2.1.3 编译

cd soundtouch
./bootstrap 

默认的 debian 版本是用浮点样本编译的。
需要用整数样本重新编译它才能与 freeswitch 兼容。
--enable-integer-samples

./configure --enable-integer-samples
make
make install

2.1.4 迁移（可选）

我这里有两个环境，一个是编译环境，一个是运行环境，所以，我知道要吧这四个编译好的文件放到运行环境相同目录下面就可以。然后执行ldconfig，重新加载一下环境。

2.2 apt-get 安装

 apt-get install libsoundtouch-dev libsoundtouch1 

三、使用

3.1 终端使用

1）变速不变调

soundstretch original.wav out30.wav -tempo=+30 # 加速，时常变短
soundstretch original.wav out30.wav -tempo=-30 # 减速，时常变长
2） 变调不变速

soundstretch original.wav pitch30.wav -pitch=+5 # 音调调高，可以将男声变成女声
soundstretch pitch30.wav normal.wav -pitch=-5 # 音调调低，可以将女声变成男声
3）变速且变调

soundstretch original.wav rate25.wav -rate=+25

3.2 Freeswitch使用

3.2.1编译Freeswitch的mod_soundtouch

首先进入源mod

cd freeswitch1_10_7/src/mod/applications/mod_soundtouch

make

make install

可以在Freeswitch的生成环境下看到已经编译生成mod了

3.2.2启用 mod_soundtouch 模块

在编译生成的Freeswitch目录下
/usr/local/freeswitch/conf/autoload_configs/modules.conf.xml
添加内容：
<load module="mod_soundtouch"/>
然后重启

临时添加此mod,在fs_cli 执行load mod_soundtouch

3.3.3 使用

使用api命令

1）soundtouch命令格式

soundtouch <uuid> [start|stop] [send_leg] [hook_dtmf] [-]<X>s [-]<X>o <X>p <X>r <X>t

soundtouch 参数说明：

• uuid
  必选参数，需要进行变声操作leg的uuid
• start|stop
  必选参数，使用start时，后面要跟参数，不能连续两次start，可以在同一个命令里面把所有参数都设置好。
  使用stop时，之前必须有start操作。
• send_leg
  可选参数，
  不指定该参数时，用于该uuid发出去的音频变声（说的声音变声）；
  指定该参数时，用于该uuid收到的音频变声（听的声音变声）。
• hook_dtmf
  可选参数
  指定该参数时，在电话侧可用dtmf按键进行变声操作。如果指定，它将挂钩 DTMF 音调并根据底部的 DTMF 代码修改音高/速率/节奏
• s
  以半音为单位调整音高，值应在 -14 到 14 之间，默认为 0
• o
  以八度为单位调整音高，值应介于 -1 和 1 之间，默认为 0
• p
  直接设置音调，值应> 0，默认1（较低=低音调）
• r
  设置速率，值应大于 0，默认为 1（越低 = 越慢）
• t
  设置节奏，值应大于 0，默认为 1（越低 = 越慢）

测试命令：

originate user/1001 &endless_playback(/usr/local/freeswitch/sounds/original.wav)
 
soundtouch uuid start send_leg 4s
soundtouch uuid  stop
soundtouch uuid  start send_leg -4s

使用lua

例如，要在 Lua 中启动 soundtouch，请使用（这会将音调降低 0.2 个八度）：

session:execute("soundtouch", "-0.2o") 

要将音调重置为正常，此方法将不起作用：

session:execute("soundtouch", "+0.2o") 

即使这样也行不通

session:execute("soundtouch", "0o") 

您需要通过以下命令明确“停止”soundtouch

session:execute("soundtouch","stop")

随后，您可以通过发出新的命令再次进行俯仰/速率变换，例如

session:execute("soundtouch","0.8r") 

使用拨号计划

 <action application="soundtouch" data="hook_dtmf -0.3o 0.8r"/>