XSwitch用户手册

扩展功能

终端

XSwitch的前台命令客户端,实现各种命令输入,也可快捷的查看后台日志,如下图。

终端\label{fig:terminal}

点击上图【暂停】可以使日志界面暂停,当日志较多时,方便查看通话日志,防止被后来日志覆盖。

点击“【设置回滚行数】,可以设置显示最大数,比如,设置为1000,那么可显示最多1000行日志信息,防止重要信息被覆盖。

在终端界面可以【下载】保存当前终端中显示的日志。

当遇到问题,需要发送日志给相关技术人员时,可以点击【日志指令】,SIP日志按钮点击“开”,方便打开跟踪。以后收到的SIP消息都可以在流程图上显示出来。该功能仅用于实时跟踪查看和诊断SIP消息。

重现问题后,点击下图【下载】,此时可以将流程图以及日志下载下来,发给XSwitch技术支持人员以便定位问题原因。

终端日志下载\label{fig:terminal_download}

系统

在此页面可下载系统日志等。

话机自动配置

在此界面可以添加话机信息,支持批量导入。如下图所示

话机自动配置\label{fig:phone_conf}

在界面填入话机MAC地址以及对应账号后,如果想批量实现话机自动部署,需要在话机界面填写系统URL地址,现在以方位F3话机以及方位FA26为例:

潮流

进入话机管理界面,【维护】⇨【更新升级】,然后按照如下图所示填写URL。URL格式为IP:port/api/provision_auto/gs协议类型选择http,服务器地址填写系统真正的访问地址(如192.168.3.144:18081/api/provision_auto/gs)。

潮流1610/1615自动配置\label{fig:gs_auto}

方位F3

进入话机管理界面,【升级】⇨【自动升级】等,然后按照如下图所示填写URL。URL格式为IP:port/api/provision_auto/fw协议类型选择http,服务器地址填写系统真正的访问地址(如192.168.3.1:8081/api/provision_auto/fw

F3自动配置\label{fig:auto_provision}

方位FA26

进入话机管理界面,【话机配置】⇨【自动更新】,然后按照如下图所示填写URL。URL格式为IP:port/api/provision_auto/fwA26协议类型选择HTTP,服务器地址填写系统真正的访问地址(如http://192.168.3.144:18081/api/provision_auto/fwA26)

A26自动配置\label{fig:fw_a26}

智能安全帽对接

智能安全帽通过对接XSwitch系统平台实现WebRTC实时音视频通话。

智能安全帽注册到该系统平台后,其他设备(如SIP话机或手机等)可通过路由设置实现直接呼叫相应智能安全帽;当安全帽需要帮助时,可通过按SOS直接呼叫相应的客服人员。

准备

  • 准备一个域名
  • 域名必须有在备案
  • 申请该域名对应的ssl证书
  • 域名以及对应的ssl证书在系统安装时配置完成即可。

在系统安装时,请.env文件中FreeSWITCH_NAME填写了正确域名

特别注意

证书类型优先选择适用于Nginx类型的SSL证书。

系统界面配置

  • 点击菜单栏【高级】⇨【SIP】⇨【default】,找到ws-bindingwss-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_logfalse

[高级]AI