XSwitch用户手册
扩展功能
终端
XSwitch的前台命令客户端,实现各种命令输入,也可快捷的查看后台日志,如下图。
点击上图【暂停】可以使日志界面暂停,当日志较多时,方便查看通话日志,防止被后来日志覆盖。
点击“【设置回滚行数】,可以设置显示最大数,比如,设置为1000
,那么可显示最多1000
行日志信息,防止重要信息被覆盖。
在终端界面可以【下载】保存当前终端中显示的日志。
当遇到问题,需要发送日志给相关技术人员时,可以点击【日志指令】,SIP日志按钮点击“开”,方便打开跟踪。以后收到的SIP消息都可以在流程图上显示出来。该功能仅用于实时跟踪查看和诊断SIP消息。
重现问题后,点击下图【下载】,此时可以将流程图以及日志下载下来,发给XSwitch技术支持人员以便定位问题原因。
系统
在此页面可下载系统日志等。
话机自动配置
在此界面可以添加话机信息,支持批量导入。如下图所示
在界面填入话机MAC地址以及对应账号后,如果想批量实现话机自动部署,需要在话机界面填写系统URL地址,现在以方位F3话机以及方位FA26为例:
潮流
进入话机管理界面,【维护】⇨【更新升级】,然后按照如下图所示填写URL。URL格式为IP:port/api/provision_auto/gs
协议类型选择http,服务器地址填写系统真正的访问地址(如192.168.3.144:18081/api/provision_auto/gs
)。
方位F3
进入话机管理界面,【升级】⇨【自动升级】等,然后按照如下图所示填写URL。URL格式为IP:port/api/provision_auto/fw
协议类型选择http,服务器地址填写系统真正的访问地址(如192.168.3.1:8081/api/provision_auto/fw
)
方位FA26
进入话机管理界面,【话机配置】⇨【自动更新】,然后按照如下图所示填写URL。URL格式为IP:port/api/provision_auto/fwA26
协议类型选择HTTP,服务器地址填写系统真正的访问地址(如http://192.168.3.144:18081/api/provision_auto/fwA26
)
智能安全帽对接
智能安全帽通过对接XSwitch系统平台实现WebRTC实时音视频通话。
智能安全帽注册到该系统平台后,其他设备(如SIP话机或手机等)可通过路由设置实现直接呼叫相应智能安全帽;当安全帽需要帮助时,可通过按SOS直接呼叫相应的客服人员。
准备
- 准备一个域名
- 域名必须有在备案
- 申请该域名对应的ssl证书
- 域名以及对应的ssl证书在系统安装时配置完成即可。
在系统安装时,请.env
文件中FreeSWITCH_NAME
填写了正确域名
特别注意
证书类型优先选择适用于Nginx类型的SSL证书。
系统界面配置
- 点击菜单栏【高级】⇨【SIP】⇨【default】,找到
ws-binding
和wss-binding
参数并检查该参数是否已自动开启,若未开启,则开启后点击该界面上“重启”或“重新扫描”,使其生效。 - 点击菜单栏【高级】⇨【扩展功能】⇨【话机自动配置】,输入名称、MAC及分机号
特别说明
- 名称:输入安全帽SOS对应号码,即当该安全帽按SOS后走哪个被叫号码路由;
- MAC:是指安全帽设备编号;
- 分机号:则是安全帽对应的注册分机号。
安全帽配置
进入智能安全帽自己的配置界面,找到安全帽设置--服务器地址配置。
在服务器地址配置中,如下所示,其中test.cn
替换为真实的域名即可。
https://test.cn/api/provision_auto/safety_hat?ctl=config&act=get_config
检查
点击菜单栏【高级】⇨【状态】⇨【注册】,通过该注册界面查看安全帽有没有注册成功;
如果未能成功注册,可通过访问https://www.doubango.org/sipml5/call.htm?svn=252#,输入分机配置信息,查看系统是否支持WebRTC。
媒体文件
系统内置文件、上传文件以及保存录音等。所有系统通话录音均可在此界面查看下载。
自定义
可根据需求,自定义媒体文件类型,将上传后的文件转到指定类型。通常用于IVR、呼叫中心、会议等需要选择语音文件的场景。
按类型分配,可解决因文件太多而不方便查询选择的问题。
使用TTS制作媒体文件
在使用XSwitch通信过程中,经常需要一些语音文件,有时录制起来比较麻烦。在配置了TTS(语音合成功能)的情况下,XSwitch可以直接使用TTS生成语音文件,供以后使用。
TTS使用方法:
点击【TTS】,选择TTS引擎,在TTS文本框内填写内容,点击TTS即可生成声音文件。
提示:使用TTS之前请确保在相关语音识别模块已自动加载,比如使用百度TTS,确保mod_baidu
已加载。
使用离线TTS
XSwitch也支持离线生成TTS语音,详细操作办法可参考如何使用XSwitch内置的离线ASR及TTS
使用Edge TTS
由于XSwitch提供配套的espeak-ng播放出的中文声音不太好听,我们给出了一个更“好听”的解决方案,详细可参考如何在XSwitch中使用Edge TTS
日志
点击【设置】⇨【日志】,此界面记录了XUI界面每一次的修改状态及内容。通过此界面,可随时查看历史修改记录,根据修改记录,查看配置变化。
此界面功能默认开启,如无需使用日志记录,请在配置文件中(xtra_config.lua
)设置auto_log
为false
。