首页 > 代码库 > OMCS开发手册(04) -- 二次开发流程

OMCS开发手册(04) -- 二次开发流程

在掌握了前面几篇关于OMCS的详细介绍后,我们就可以正式基于OMCS进行二次开发了。下面我们就从服务端和客户端的角度分别介绍开发的步骤。

一.服务端开发

      抛开具体的业务逻辑而言,就OMCS的服务端的开发而言相当简单。步骤如下所示:

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

(2)使用VS打开OMCS.Server项目,修改其中的DefaultUserVerifier类的实现,为VerifyUser方法添加验证客户端用户帐号密码的逻辑。

(3)如果需要使用自定义的主窗体,则实现它。

(4)更改配置文件App.config中的相关配置。

(5)发布项目,部署并运行。

      就像OMCS开发手册(00) -- 概述一文中描述的,OMCS多媒体服务器和实现业务逻辑的应用服务器是相互独立的。

      

      我们也可以在OMCS服务器进程中,集成具体的业务逻辑,将两个进程合并为一个。但是我们并不推荐这样做,因为当负载增加时,还是需要将它们分开部署的;而且,分开部署还有一个好处就是避免它们之间相互干扰。 

二.客户端开发

      相对于OMCS服务器端,客户端开发要稍微复杂一些。

(1)在项目中添加对OMCS.dll、PaintFramework.dll、ESBasic.dll的引用。

(2)将OMCS的连接器组件/控件添加到工具箱中:在VS的工具箱的空白地方右键快捷菜单 => 选择项,在弹出的“选择工具箱项”的窗体上,点击“浏览”按钮,选中OMCS.dll文件,再点击“确定”。

(3)开始编码,调用MultimediaManagerFactory的静态方法GetSingleton获取多媒体管理器单件实例,设置多媒体管理器的属性,并调用其Initialize方法完成初始化。比如:       

    IMultimediaManager multimediaManager = MultimediaManagerFactory.GetSingleton();
    multimediaManager.ChannelMode = ChannelMode.P2PChannelFirst;
    multimediaManager.SecurityLogEnabled = false;                
    multimediaManager.CameraDeviceIndex = 0;
    multimediaManager.MicrophoneDeviceIndex = 0;
    multimediaManager.SpeakerIndex = 0;
multimediaManager.DesktopEncodeQuality = 3; multimediaManager.Initialize("aa01","pwd", "192.168.0.98", 9900);

(4)预定multimediaManager的ConnectionInterrupted、ConnectionRebuildSucceed事件,以实时监控多媒体管理器与多媒体服务器之间的TCP连接的状态。 

        multimediaManager.ConnectionInterrupted += new CbGeneric(multimediaManager_ConnectionInterrupted);
        multimediaManager.ConnectionRebuildSucceed += new CbGeneric(multimediaManager_ConnectionRebuildSucceed);

        void multimediaManager_ConnectionInterrupted()
        {
            if (this.InvokeRequired)
            {
                this.Invoke(new CbSimple(this.multimediaManager_ConnectionInterrupted), null);
            }
            else
            {                
                this.toolStripLabel_state.Text = "连接状态:断开";
                this.toolStripLabel_state.ForeColor = Color.Red;
            }
        }

        void multimediaManager_ConnectionRebuildSucceed()
        {
            if (this.InvokeRequired)
            {
                this.Invoke(new CbSimple(this.multimediaManager_ConnectionRebuildSucceed), null);
            }
            else
            {
                this.toolStripLabel_state.Text = "连接状态:正常(重连成功)";
                this.toolStripLabel_state.ForeColor = Color.Black;               
            }
        }

(5)将连接器组件从工具箱拖到您的窗体或控件的表面。

(6)调用连接器的BeginConnect方法连接到目标多媒体设备,并预定其ConnectEnded事件,以获取连接是否成功的结果。

(7)预定连接器的Disconnected事件,当连接器的连接断开时获取通知并做相关的处理。比如: 

        this.cameraConnector1.ConnectEnded += new CbGeneric<ConnectResult>(cameraConnector1_ConnectEnded);            
        this.cameraConnector1.Disconnected += new CbGeneric<ConnectorDisconnectedType>(cameraConnector1_Disconnected);

        void cameraConnector1_ConnectEnded(ConnectResult result)
        {
            if (this.InvokeRequired)
            {
                this.BeginInvoke(new CbGeneric<ConnectResult>(this.cameraConnector1_ConnectEnded), result);
            }
            else
            {
                this.label_camera.Text = string.Format("视频:{0}", result == ConnectResult.Succeed ? "成功连接到设备" : result.ToString());
            }
        }

        void cameraConnector1_Disconnected(ConnectorDisconnectedType connectorDisconnectedType)
        {
            if (this.InvokeRequired)
            {
                this.BeginInvoke(new CbGeneric<ConnectorDisconnectedType>(this.cameraConnector1_Disconnected), connectorDisconnectedType);
            }
            else
            {
                this.label_camera.Text = string.Format("视频:与设备的连接已断开,原因:{0}", connectorDisconnectedType);
            }
        }

 (8)当业务逻辑需要挂断连接器,或宿主窗体将被关闭时,需要调用连接器的Disconnect方法,以主动断开到目标多媒体设备的连接。最后还要释放连接器对象。比如: 

        private void ChatForm_FormClosing(object sender, FormClosingEventArgs e)
        {            
            this.cameraConnector1.Disconnect();
            this.cameraConnector1.Dispose();
        }  

      本文介绍的只是使用OMCS的最基本开发流程,关于如何更好地使用OMCS的各个特性来构建我们的网络多媒体应用,请参考后面即将退出的“OMCS使用技巧”类的文章。

OMCS开发手册(04) -- 二次开发流程