HTML5方式使用freeswitch——VERTO模块

mod_verto
在freeswitch中有mod_sofia模块支持sip协议。sip协议用于媒体链接建立前的信令交互。像mod_sofia这种模块在freeswitch中成为endpoint，除了mod_sofia，freeswitch还有一个mod_verto模块。mod_verto使用freeswitch自定义的一个协议，通过websocket进行信令交互。verto协议基于jsonRpc协议，通过json格式来传输数据。

安装mod_verto

正常编译安装freeswitch时在module配置文件中打开verto的编译，之后一样make&make install就可以了，安装好之后需要在freeswitch启动加载模块的配置文件中打开verto，使freeswitch启动时自动加载mod_verto。

配置verto

修改conf/autoload_configs/verto.conf.xml

如下：

1. <configuration name="verto.conf" description="HTML5 Verto Endpoint">

2.  

3. <settings>

4. <param name="debug" value="10"/>

5. <!-- seconds to wait before hanging up a disconnected channel -->

6. <param name="detach-timeout-sec" value="120"/>

7. <!-- enable broadcasting all FreeSWITCH events in Verto -->

8. <!-- <param name="enable-fs-events" value="false"/> -->

9. <!-- enable broadcasting FreeSWITCH presence events in Verto -->

10. <param name="enable-presence" value="false"/>

11. </settings>

12. <profiles>

13. <profile name="default-v4">

14. <param name="bind-local" value="$${local_ip_v4}:8081"/>

15. <param name="bind-local" value="$${local_ip_v4}:8082" secure="true"/>

16. <param name="force-register-domain" value="$${domain}"/>

17. <param name="secure-combined" value="/usr/local/freeswitch/certs/wss.pem"/> -证书的位置，一会儿存放证书时要用

18. <param name="secure-chain" value="/usr/local/freeswitch/certs/wss.pem"/>

19. <param name="userauth" value="true"/>

20. <!-- setting this to true will allow anyone to register even with no account so use with care -->

21. <param name="blind-reg" value="false"/>

22. <param name="mcast-ip" value="224.1.1.1"/>

23. <param name="mcast-port" value="1337"/>

24. <param name="rtp-ip" value="$${local_ip_v4}"/>

25. <!-- <param name="ext-rtp-ip" value=""/> -->

26. <param name="local-network" value="localnet.auto"/>

27. <param name="outbound-codec-string" value="opus,vp8,h264"/>

28. <param name="inbound-codec-string" value="opus,vp8,h264"/>

29. <param name="apply-candidate-acl" value="localnet.auto"/>

30. <param name="apply-candidate-acl" value="wan_v4.auto"/>

31. <param name="apply-candidate-acl" value="rfc1918.auto"/>

32. <param name="apply-candidate-acl" value="any_v4.auto"/>

33. <param name="timer-name" value="soft"/>

34. </profile>

35. <profile name="default-v6">

36. <param name="bind-local" value="[$${local_ip_v6}]:8081"/>

37. <param name="bind-local" value="[$${local_ip_v6}]:8082" secure="true"/>

38. <param name="force-register-domain" value="$${domain}"/>

39. <param name="secure-combined" value="$${certs_dir}/wss.pem"/>

40. <param name="secure-chain" value="$${certs_dir}/wss.pem"/>

41. <param name="userauth" value="true"/>

42. <!-- setting this to true will allow anyone to register even with no account so use with care -->

43. <param name="blind-reg" value="false"/>

44. <param name="rtp-ip" value="$${local_ip_v6}"/>

45. <!-- <param name="ext-rtp-ip" value=""/> -->

46. <param name="outbound-codec-string" value="opus,vp8"/>

47. <param name="inbound-codec-string" value="opus,vp8"/>

48. <param name="apply-candidate-acl" value="wan_v6.auto"/>

49. <param name="apply-candidate-acl" value="rfc1918.auto"/>

50. <param name="apply-candidate-acl" value="any_v6.auto"/>

51. <param name="apply-candidate-acl" value="wan_v4.auto"/>

52. <param name="apply-candidate-acl" value="any_v4.auto"/>

53. <param name="timer-name" value="soft"/>

54. </profile>

55. </profiles>

56. </configuration>

为用户号码配置verto支持

修改directory/default.xml，在<params>和</params>中添加如下：

1. <param name="jsonrpc-allowed-methods" value="verto"/>

2. <param name="jsonrpc-allowed-event-channels" value="demo,conference,presence"/>

每个用户的xml配置文件中conf/directory/default/1000.xml，修改如下：

1. <user id="1001">

2. <params>

3. <param name="password" value="$${default_password}"/>

4. <param name="vm-password" value="1001"/>

5. <param name="verto-context" value="public"/>

6. <param name="verto-dialplan" value="XML"/>

7. </params>

如需使用会议功能，请修改会议配置文件conf/autoload_configs/conference.conf.xml

在<profiles>和</profile>中检查conference-flags项目，确保其中包含livearray-sync和livearray-json-status

拨号计划配置例如：

1. <extension name="HTML5 Verto">

2. <condition field="destination_number" expression="^(10[0-9][0-9])$">

3. <action application="export" data="dialed_extension=$1"/>

4. <action application="set" data="call_timeout=30"/>

5. <action application="bridge" data="${verto_contact ${dialed_extension}@${dialed_domain}}"/>

6. </condition>

7. </extension>

至此freeswitch针对verto的配置已经完成，想要测试的话，需要使用freeswitch自带的verto demo，安装使用过程如下：

一、创建证书

因为wss方式的访问是加密的，所以需要配置https方式运行demo，先创建一个自签名证书，以供freeswitch和web服务使用，注意二者需要使用同一套证书才能顺利的访问freeswitch。

创建自签名证书，过程中按提示输入各种信息，过程中需要openssl的支持，如果未安装请提前自行安装。
wget http://files.freeswitch.org/downloads/ssl.ca-0.1.tar.gz
tar zxfv ssl.ca-0.1.tar.gz
cd ssl.ca-0.1/
perl -i -pe 's/md5/sha256/g' *.sh
perl -i -pe 's/1024/4096/g' *.sh
./new-root-ca.sh
./new-server-cert.sh self.verto
./sign-server-cert.sh self.verto
cat self.verto.crt self.verto.key > /usr/local/freeswitch/certs/wss.pem /*注意此路径和verto配置文件中的相同*/
 

二、安装web服务，以apache为例

sudo apt-get install apache2

配置apache
sudo a2enmod ssl
sudo a2enmod rewrite

修改/etc/apache2/sites-enabled/000-default.conf
<VirtualHost *:443> -- 修改为443
…………
--增加下面几行
SSLEngine On
SSLOptions +StrictRequire
SSLCertificateFile /usr/local/freeswitch/certs/wss.pem
SSLCertificateKeyFile /usr/local/freeswitch/certs/wss.pem
SSLCertificateChainFile /usr/local/freeswitch/certs/wss.pem
</VirtualHost>
# vim: syntax=apache ts=4 sw=4 sts=4 sr noet


重启apache服务
sudo service apache2 restart

三、将verto demo放到apache的web页面目录中

cp -rf /home/verto/freeswitch/html5/verto/video_demo  /var/www/html

此处我们直接复制带视频的demo过来，verto还提供了不带视频的demo和verto_communicator请自行尝试。

打开浏览器（我用的Chrome）访问https://IP地址/video_demo

提示未信任，点高级，继续前往。

至此安装完毕，其他请自行体验。