查看“音乐等待设置”的源代码

'''MoH 音乐等待模块用户使用指南'''

* Overview
* Logging In
* Adding Music Categories
** Category Name
* Adding Static Music
** Upload a WAV or MP3 File 
*** You will click Choose File
*** Volume Adjustment
*** Upload
** Disable/Enable Random Play
** MoH List
*  Adding Streaming Music
** Category Name
** Application path
** Optional Format

'''总览'''

Music on Hold 音乐等待模块的目的是给呼叫方用户一个比较好的用户体验。当呼叫方呼叫对端时，此时对端处于通话状态，被呼叫方通话只能被转入一个短暂的等待状态，此时系统对呼叫方播放一段音乐或者音乐文件，让呼叫方体验到这个通话的连续性，不是突然中断呼叫。PBX 系统默认支持了十一首歌曲，音乐等待可以对任意一首歌曲播放。当然用户也可以添加自己录制的音乐等待语音文件，这些语音文件的格式为.wav 或者 .mp3 文件格式，或者添加一个网络订阅的实时语音流。用户可以添加一个用户自定义的音乐文件体现出PBX的不同。 PBX 支持两种不同的音乐等待文件播放方式 – 静态音乐文件和动态的媒体流文件。<br/>

静态语音文件的格式可以是 (WAV 或者 MP3 文件格式) ，用户可以上传音乐文件到服务器存储空间，当PBX 需要播放此语音文件时，系统对呼叫方播放音乐等待。媒体流可以是一个实时的流媒体，PBX可以连接流媒体播放源播放音乐等待文件。<br/>

媒体流可以说网络媒体流，也可以是来自声卡的音乐流 或者其他音乐设备提供的媒体流。MoH 可以支持不同的PBX 应用模块，例如呼入路由，队列，振铃组，呼出路由和电话会议。音乐等待的类别可以指定到通话呼叫的层，这个设置将覆盖呼叫目的地的音乐等待类别设置。一旦这个呼叫脱离了这个目标对象，音乐等待类别将返回到在呼入路由设置的音乐等待类别中。<br/>

注意

'''许可证问题'''

以前的做法是直接把电台的媒体流或者CD 播放器音乐接入到PBX中。在实际环境中，因为大部分的音乐版权和音乐许可证限制，音乐版权所有者不会允许这样的接入行为。两种可行的办法是购买音乐的商业版权，或者找适合PBX的其他合法的数据源。具体细节，请参考以下链接：.

[http://www.bmi.com/licensing/entry/music_on_hold BMI - MoH Licencing]

[http://www.ascap.com/licensing/types/music-on-hold.aspx ASCAP - MoH Licencing]

[http://www.opsound.org/ http://www.opsound.org]

[https://soundcloud.com/search/sounds?filter.license=to_use_commercially Creative Commons Search on Sound Cloud]



注意：网络上传的语音文件完全在于用户是否诚实。如果用户需要使用一些网络或者云空间的语音文件，需要详细检查音乐文件的许可证是否可用。

'''Logging In'''

* 从菜单顶部点击 '''Settings'''
* 从下拉菜单中点击 '''Music on Hold'''

'''Adding Music Categories'''

PBX 本身已经带有一个默认的类别，是 “default”。 用户可以创建用户自己定义的类别。点击 “Add Music Category” 添加用户自定义的音乐等待类别。

http://wiki.freepbx.org/download/thumbnails/28770464/rnavMOH.png

需要填写以下类别信息：

http://wiki.freepbx.org/download/thumbnails/28770464/MOHADDCAT.png


'''Category Name'''

输入合适的音乐等待类别，保存设置。

'''Adding Static Music'''

点击右侧导航菜单，点击相应的类别添加播放的音乐文件：

http://wiki.freepbx.org/download/thumbnails/28770464/MOHADDMUSIC.png

'''Upload a WAV or MP3 File'''

这里，用户可以上传用户录制的音乐文件，格式可以是 WAV 或者 MP3。

'''You will click Choose File'''

系统提示栏会提示用户从本地电脑上传音乐文件。

'''Volume Adjustment'''

在上传音乐文件之前，用户可以调整音乐文件的增益 语音音量大小。一旦文件上传以后，用户不能再次调整音乐音量。如果上传后，用户计划再次调整音量的话，只能删除以前的上传文件，调整音量，再次上传一个新的文件。

'''Upload'''

点击上传以后，系统将上传自定义的音乐文件到系统设置的文件路径下。上传时间需要一定的时间，如果上传的是MP3 文件，系统需要转换成WAV 格式。

'''Disable/Enable Random Play'''

此选项可以支持对音乐文件播放状态的任意切换（开启/关闭）。如果呼叫方进入到音乐等待状态时，任意播放的功能则支持系统将任意挑选一个音乐文件对呼叫方播放。如果关闭此选项，系统则对呼叫方从第一个语音文件开始依次播放用户上传的音乐文件（第一个播放的文件将是用户第一个上传的音乐文件，以此类推）。

'''MoH List'''

音乐等待类别列表。 用户可以点击“Delete”按钮删除一个指定的文件。

'''Adding Streaming Music'''

媒体流类别可以用来从在线的网络语音源获取音乐媒体流。

在MoH中使用语音媒体流比使用静态音乐文件更加复杂，因为来自于网络的语音媒体流具有不可预测性。

注意

我们不推荐对于MoH采用媒体流的方式处理。

以下指导告诉用户如何设置媒体流，不推荐使用。


'''Category Name'''

媒体流的类别.

'''Application path'''

这里定义媒体流或者映射到一个脚本文件获取声卡媒体数据。

Application 实例:

/usr/bin/mpg123 -q -s --mono -r 8000 -f 8192 -b 1024 [http://urlofyourlivestream/ http://urlofyourlivestream/]

'''Optional Format'''

语音文件格式，例如 PBX 使用 “ULAW” 播放媒体流。

注意

音乐等待如果使用媒体流形式播放，因为占用带宽过多，编码转换的问题会带来很多负面的影响，严重影响系统的性能。如果多个呼叫连接到同一媒体流，每个媒体类别仅在限定的时间内播放。如果创建了多个媒体流，多个媒体流可能同时启动。PBX 要求媒体流以Ulaw 格式播放，因此，活动的呼叫使用了和媒体播放同样格式的语音编码，则无需标明转换。如果呼叫使用了不同的语音编码，例如使用了G.722 编码，那么系统将强制媒体流进行编码转换，以便呼叫方可以听到音乐等待语音播放。如果语音编码使用了商业许可证，这样的话，要求PBX 系统必须有支持商业许可证的编码算法来处理并发呼叫。这样可以避免因为编码问题带来的性能影响。如果为了保证媒体流的传输的稳定性，除非用户使用的媒体流来自于本地内部网络，媒体流和呼入呼出的呼叫一样占用同样的网络带宽。任何媒体流如果超出24k 则浪费了网络带宽。&nbsp;

&nbsp;