• 新一代开源VoIP协议栈--OPAL(OpenH323 v2)


     OPAL是Open Phone Abstraction Library的字母缩写,仍然是Equivalence公司开发的开源VoIP协议栈,从2001年便开始开发了,直到现在还没有正式发布过一个版本,只能从CVS: http://cvs.sourceforge.net/viewcvs.py/openh323/opal下载最新的版本,而且现在的2.05bate版有着非常多的问题,但这些丝毫不能阻止我对OPAL的看好。OPAL仍然采用PWLIB作为开发库,最新的PWLIB实际已经只剩PTLIB,Equivalence公司已经停止了对PWLIB的GUI开发了,GUI全面转向更为强大的wxWindows。OPAL作为Openh323的下一代协议栈最大的特点是加入了对SIP协议的支持,OPAL保留了Openh323大部分代码,并加入了对EndPoint,Connection等抽象描述的基类,使得添加新的协议和设备变得更加简单和方便。

        OPAL中最重要的类是新加的:OpalManager,它跟Openh323中的H323EndPoint地位一样,它定义了OPAL系统中最基本的操作,所以每个应用程序必须从OpalManager派生一个类,然后重载虚函数实现自己的操作。
    OpalManager::SetUpCall(partyA,partyB,token); 呼叫,partyA是会话发起人,partyB是会话接受人
    OpalManager::OnIncomingConnection(connection); 接听,返回TRUE则接听,返回FLASH则拒绝
    OpalManager::AdjustMediaFormats(connection,mediaFormats); 调整媒体格式
    OpalManager::ClearCall(token,reason,sync) 清除呼叫,sync如果为NULL则不等待快速返回
    OpalEndPoint是描述端点的基类,H323,SIP,PSTN,IVR,LID,声卡的端点都是继承于这个类,在这里值得注意的是连声卡设备也看做一种端点。
    OpalPCSSEndPoint则是EndPoing中比较重要的一个类,毕竟打电话还是声卡用的多,OpalPCSSEndPoint的构造函数必须引用派生的OpalManager类的实例。

    下面具体例子SimpleOPAL来讲解:
    opal = new MyManager;                                                           //新建一个MyManager的实例
    if (opal->Initialise(args))                                                          //调用MyManager::Initialise()函数初始化
    opal->Main(args);                                                                   //等待用户输入命令
    cout << "Exiting " << GetName() << endl;
    delete opal;                                                                             //擦pp
    部分Initialise()函数代码:
    SetVideoInputDevice(video);                                                    //设置输入视频设备
    ...
    SetVideoOutputDevice(video);                                                  //输出视频设备
    ...
    SetAudioJitterDelay(minJitter, maxJitter);                                 //声音抖动缓存的最小和最大值
    ...
    SetMediaFormatMask(args.GetOptionString('D').Lines());          //屏蔽的媒体格式
    SetMediaFormatOrder(args.GetOptionString('P').Lines());          //媒体格式的使用顺序
    ...
    SetTranslationAddress(args.GetOptionString("translate"));         //设置外部IP地址
    ...
    Set***Ports(rgs.GetOptionString("tcp-base").AsUnsigned(),
                   args.GetOptionString("tcp-max").AsUnsigned());        //设置相关的端口
    SetSTUNServer(args.GetOptionString("stun"));                         //使用STUN服务器
    ...
    pcssEP = new MyPCSSEndPoint(*this);                                    //新建一个MyPCSSEndPoint实例
    pcssEP->SetSoundDevice(args, "sound", PSoundChannel::Recorder)//设置相关的播放声音设备
    ...
    h323EP = new H323EndPoint(*this);                                         //h323EP的初始化
    h323EP->DisableFastStart(args.HasOption('f'));                        //关闭快速拨号模式
    h323EP->DisableH245Tunneling(args.HasOption('T'));              //关闭H245通道模式
    h323EP->AddAliasName(aliases[i]);                                         //添加昵称
    h323EP->SetInitialBandwidth(initialBandwidth);                        //限制带宽
    h323EP->StartListeners(listeners)                                             //现在才开始监听,默认是TCP:1720
    h323EP->SetGatekeeperPassword(args.GetOptionString('p'));    //注册网守所需的密码
    h323EP->UseGatekeeper(gkHost, gkIdentifer, gkInterface)       //注册网守
    ...
    sipEP = new SIPEndPoint(*this);                                               //SIP也来了
    sipEP->SetUserAgent(args.GetOptionString("sip-user-agent")); //设置用户代理,UserAgent就相当于最初openh323的endpoint
    sipEP->SetProxy(args.GetOptionString("sip-proxy"));              //设置SIP代理,此处proxy相当于h323里的Gatekeeper
    sipEP->SetMIMEForm(args.HasOption("use-long-mime"));         //MIME头的格式
    sipEP->StartListeners(listeners)                                              //监听开始,默认是TCP:5060和UDP:5060
    Main()函数部分代码:
    if (pcssEP != NULL && !pcssEP->incomingConnectionToken) {    //小心,有电话来了
          if (cmd == "n")
            pcssEP->ClearCall(pcssEP->incomingConnectionToken,     //打死我都不接
        OpalConnection::EndedByRefusal);
          else if (cmd == "y")      
            pcssEP->AcceptIncomingConnection(pcssEP->                  //喂,小莉吗?
        incomingConnectionToken);
        }
    ...
    OpalCall * call = FindCallWithLock(currentCallToken);             //让我看看是那一个通话 
    if (call != NULL) {
      cout << "Clearing call " << *call << endl;
      call->Clear();                                                                      //废话那么多,打IP电话也要钱的,挂拉
      call->Unlock();
    ...
    if (potsEP != NULL)                                                                //是打电脑还是打座机呢?
      SetUpCall("pots:*", params[1], currentCallToken);                 //打座机吧(PSTN)
    else
      SetUpCall("pc:*", params[1], currentCallToken);                    //打电脑不要钱,嘿嘿

        OPAL中的例子MFC根本无法使用,Openphone的GUI使用了wxWindows,所以必须安装了wxWindows才能正常编译,opalgw这玩意我试过好多次根本无法让别人注册,看来OPAL要走的路还很长,不过Equivalence公司开发已经渐渐的从Openh323转向了OPAL,相信不久一个稳定的OPAL将会被发布.

  • 相关阅读:
    dll得到主窗體的handle
    将应用程序11M内存占用,降至500K
    是否想为你的Windows加上一双眼睛,察看使用者在机器上所做的各种操作(例如建立、删除文件;改变文件或目录名字)呢?
    TreeView 之间节点拖动 /移动
    Delphi与C之间的类型对应表
    以ADO数据集相连的DBGrid按单一字段排序通用过程
    为Delphi程序添加事件和事件处理器
    DataSetToTreeView
    一个系统空闲时间函数
    调用chm
  • 原文地址:https://www.cnblogs.com/shengshuai/p/opal.html
Copyright © 2020-2023  润新知