首页 > 代码库 > OMCS开发手册(03) -- 多媒体服务器

OMCS开发手册(03) -- 多媒体服务器

前面我们已经详细介绍了基于OMCS开发网络多媒体应用的客户端程序所必需掌握的内容,现在我们来看一下OMCS服务端的开发。对于使用者而言,OMCS的服务端就非常简单了,只要实现一个用户验证的接口,挂接到OMCS框架上,就可以了。OMCS多媒体服务器的主要职责有:

(1)统一管理多媒体设备的某些公共配置参数。

(2)管理所有在线的OMCS客户端。

(3)协助OMCS客户端之间建立P2P通道。

(4)在OMCS客户端之间转发信息。

 一.MultimediaServer类

      OMCS服务端的核心类是OMCS.Server.MultimediaServer,它将OMCS多媒体服务端的各个组件装配起来,构成一个整体运行。在二次开发时,我们只要正确地实例化MultimediaServer,然后将其宿留任何形式的应用程序中(像WinForm、Windows服务、甚至控制台程序等)即可。所以,作为OMCS使用者,我们只需要关心它的构造函数:

  public MultimediaServer(int port, IUserVerifier userVerifier, OMCSConfiguration config, bool securityLogEnabled, string platformServerIPE)

      port 参数用于指定当前OMCS服务器通过哪个端口提供服务(使用TCP协议)。

      userVerifier 用于验证登录的客户端的帐号密码。如果客户端提交的帐号密码不正确,多媒体设备管理器IMultimediaManager的Initialize方法将抛出异常。OMCS服务端开发唯一需要做的就是实现这个接口。

      securityLogEnabled 参数用于指定是否记录安全日志,一般在调试程序的时候,将其设为true,而正式发布运行时,将其设为false。

      platformServerIPE 用于设定OMCS群集平台服务器的地址,在非群集的OMCS系统中,我们可以先忽略它,直接传入null。

      MultimediaServer类的构造函数中最关键的参数是OMCSConfiguration,我们将在下面详细讨论。

二.OMCS多媒体服务器配置参数

      OMCSConfiguration是多媒体服务器的最关键配置,其类图如下所示:        

    技术分享 

(1)音频:WaveSampleRate 用于设定麦克风的采样率(8k/16K/32K),默认值我为16000。AudioEncodingQuality 用于设定音频数据的编码质量(Low/Middle/High),默认值为High。

(2)视频:CameraFramerate 用于设定摄像头的采集帧频(1~25),默认值为5。

(3)远程桌面:DesktopFramerate 用于设定远程桌面的采集帧频(1~25),默认值为5。

(4)电子白板:WhiteboardWidth和WhiteboardHeight用于设定电子白板的尺寸(比如800*600,具体取值需要综合考虑所有guest的屏幕大小)。

       电子白板的尺寸用于限制其可操作区域,超出区域之外的地方,是不能进行绘图操作的。

(5)SystemToken 用于区分不同的基于OMCS开发的系统,并隔离它们。

       OMCS的客户端也能设置SystemToken,如果客户端与服务端的SystemToken的值不一致,则客户端就无法成功登录到OMCS服务端。

      OMCSConfiguration 对四种多媒体设备都有对应的参数设置,在客户端的多媒体设备管理器初始化之前,多媒体管理器会先从服务器获取OMCSConfiguration对象,然后再根据其设定的值初始化本地的各个多媒体设备。       

三.默认的多媒体服务器

      如果不需要用户验证,可以直接使用OMCS提供的默认的多媒体服务器OMCS.Server.exe(文末将提供其可执行程序和源码的下载):

(1)使用IUserVerifier接口的默认实现类DefaultUserVerifier,其VerifyUser方法始终返回true。

(2)SystemToken的值为""。

       如果需要验证用户帐号密码,或设定SystemToken,则可以将源码修改一下,实现IUserVerifier接口,并替换DefaultUserVerifier,然后重新发布。

(3)OMCSConfiguration其它项的设置可以在配置文件OMCS.Server.exe.config中进行修改。 

<configuration>
  <appSettings>
    
    <!--服务器监听的端口-->
    <add key="Port" value="http://www.mamicode.com/9900"/>
    <!--主窗体上是否显示用户列表。对于高并发应用,建议关闭该显示-->
    <add key="ShowUserList" value="http://www.mamicode.com/true"/>
    <!--是否记录安全日志文件 Omcs.txt-->
    <add key="SecurityLogEnabled" value="http://www.mamicode.com/false"/>    
    <!--UserID的最大长度-->
    <add key="MaxLengthOfUserID" value="http://www.mamicode.com/11"/>
    
    <!--摄像头采集视频的帧率-->
    <add key="CameraFramerate" value="http://www.mamicode.com/6"/>   
    <!--音频编码质量,Low/Middle/High。-->
    <add key="AudioQuality" value="http://www.mamicode.com/High"/>
    <!--音频采样率,8000,16000,32000。-->
    <add key="WaveSampleRate" value="http://www.mamicode.com/16000"/>    
    <!--桌面帧率-->
    <add key="DesktopFramerate" value="http://www.mamicode.com/1"/>  
    <!--白板宽度-->
    <add key="WhiteboardWidth" value="http://www.mamicode.com/800"/>
    <!--白板高度-->
    <add key="WhiteboardHeight" value="http://www.mamicode.com/600"/>  
      
  </appSettings>
</configuration>

       配置文件中除了可以设置OMCSConfiguration相关项外,还有其它几个设置项:

(1)Port 用于指定当前OMCS服务器通过哪个TCP端口提供服务。【将被传入MultimediaServer类的构造函数】

(2)ShowUserList 用于控制采用默认的UI主界面时,是否显示在线用户列表。

       一般,只有在调试和测试阶段,我们才会开启显示用户列表。因为,当在线用户数很多时,窗体实时刷新每个用户的状态数据,其消耗CPU是不可忽视的。 

(3)SecurityLogEnabled 用于指定是否记录安全日志。【将被传入MultimediaServer类的构造函数】

(4)MaxLengthOfUserID 用于设定客户端登录帐号的最大长度,默认值为11,如果所需长度大于这个值,必需重新设定。

       而且,客户端的设定必须同服务器一致,OMCS客户端可以通过调用GlobalUtil类的静态方法SetMaxLengthOfUserID来设定该值。

 

      默认的OMCS.Server.exe以WinForm的形式宿留了MultimediaServer对象。其运行起来后,如下图所示:

      

      界面上显示了所有在线的用户列表,以及服务器相关的状态信息。

      注意:OMCS多媒体服务器使用了两个端口,一个是通过MultimediaServer的构造参数指定的TCP端口,另一个是自动绑定的UDP端口(默认为TCP端口号加1)。

      UDP端口是OMCS多媒体服务器内部集成的P2P服务器所使用的,用于协助客户端之间创建P2P通道。

      OMCS.Server.exe有对应的配置文件OMCS.Server.exe.config,我们可以通过修改该配置文件来设定一些参数信息。       

四.下载

      OMCS多媒体服务器(带源码)。 

      就基于OMCS进行二次开发而言,在我们掌握了概述、多媒体设备管理器、多媒体连接器、多媒体服务器这些内容后,就已经足够了。后面我们会介绍使用OMCS的更多技巧,以及给出更多的demo来演示如何基于OMCS开发网络多媒体应用系统。

OMCS开发手册(03) -- 多媒体服务器