操作系统 :CentOS 7.6_x64
FreeSWITCH版本 :1.10.9
之前写过FreeSWITCH安装的文章,今天整理下moh使用过程中遇到的问题及解决方案,并提供moh音频下载途径。FreeSWITCH安装的文章可参考如下链接:
docker构建FreeSWITCH编译环境及打包
使用docker构建可动态启动的FreeSWITCH实例
CentOS7环境源码安装freeswitch1.10
一、问题描述
FreeSWITCH有hold_music功能,在hold时会触发,体现在sdp里面就是a头里面是 sendonly 属性:

如果没有启用local_stream模块,触发moh时会报如下错误:
- [ERR] switch_core_file.c:346 Invalid file format [local_stream] for [moh]!

如果没有下载moh音频,触发moh时会报如下错误:
- [ERR] mod_local_stream.c:883 Unknown source default

二、安装moh
1、安装local_stream模块
文件:freeswitch-1.10.9.-release/modules.conf
模块名称:formats/mod_local_stream

2、安装moh音频
make moh-install
下载文件路径:
https://files.freeswitch.org/releases/sounds/freeswitch-sounds-music-8000-1.0.52.tar.gz

make hd-moh-install
下载文件路径:
https://files.freeswitch.org/releases/sounds/freeswitch-sounds-music-16000-1.0.52.tar.gz

make uhd-moh-install
下载文件路径:
https://files.freeswitch.org/releases/sounds/freeswitch-sounds-music-32000-1.0.52.tar.gz

make cd-moh-install
下载文件路径:
https://files.freeswitch.org/releases/sounds/freeswitch-sounds-music-48000-1.0.52.tar.gz

安装完毕的目录结构:
/usr/local/freeswitch/sounds/music

如果下载过慢,可以从如下渠道获取:
关注微信公众号(聊聊博文,文末可扫码)后回复 20231029 获取。
三、使用moh
1、启用local_stream模块
文件:/usr/local/freeswitch/conf/autoload_configs/modules.conf.xml
模块名称:mod_local_stream

2、配置local_stream模块
配置文件路径:conf/autoload_configs/local_stream.conf.xml
配置文件内容:
- <configuration name="local_stream.conf" description="stream files from local dir">
- <!-- fallback to default if requested moh class isn't found -->
- <directory name="default" path="$${sounds_dir}/music/8000">
- <param name="rate" value="8000"/>
- <param name="shuffle" value="true"/>
- <param name="channels" value="1"/>
- <param name="interval" value="20"/>
- <param name="timer-name" value="soft"/>
- <!-- list of short files to break in with every so often -->
- <!--<param name="chime-list" value="file1.wav,file2.wav"/>-->
- <!-- frequency of break-in (seconds)-->
- <!--<param name="chime-freq" value="30"/>-->
- <!-- limit to how many seconds the file will play -->
- <!--<param name="chime-max" value="500"/>-->
- </directory>
-
- <directory name="moh/8000" path="$${sounds_dir}/music/8000">
- <param name="rate" value="8000"/>
- <param name="shuffle" value="true"/>
- <param name="channels" value="1"/>
- <param name="interval" value="20"/>
- <param name="timer-name" value="soft"/>
- </directory>
-
- <directory name="moh/16000" path="$${sounds_dir}/music/16000">
- <param name="rate" value="16000"/>
- <param name="shuffle" value="true"/>
- <param name="channels" value="1"/>
- <param name="interval" value="20"/>
- <param name="timer-name" value="soft"/>
- </directory>
-
- <directory name="moh/32000" path="$${sounds_dir}/music/32000">
- <param name="rate" value="32000"/>
- <param name="shuffle" value="true"/>
- <param name="channels" value="1"/>
- <param name="interval" value="20"/>
- <param name="timer-name" value="soft"/>
- </directory>
-
- <directory name="moh/48000" path="$${sounds_dir}/music/48000">
- <param name="rate" value="48000"/>
- <param name="shuffle" value="true"/>
- <param name="channels" value="1"/>
- <param name="interval" value="10"/>
- <param name="timer-name" value="soft"/>
- </directory>
-
- </configuration>
3、配置hold_music
文件:/usr/local/freeswitch/conf/vars.xml
配置内容:
- <X-PRE-PROCESS cmd="set" data="hold_music=local_stream://moh"/>

四、资源下载
本文涉及的音频文件,可以从如下途径获取:
关注微信公众号(聊聊博文)后回复 20231029 获取。