基于Doubango的座席控件的設計與實現(xiàn)

田海

（江西九江供電公司，江西九江332000）

基于Doubango的座席控件的設計與實現(xiàn)

田海

（江西九江供電公司，江西九江332000）

為了實現(xiàn)將發(fā)送及接收SIP Message消息的功能封裝成一個供第三方調(diào)用的獨立模塊，在使用Doubango庫的基礎之上，通過ActiveX控件及動態(tài)鏈接庫等關鍵技術，設計了良好緊湊的軟件架構，封裝了SIP Message消息的發(fā)送及接收功能，并充分考慮用戶體驗，完成了C/S和B/S架構均可調(diào)用的座席控件。通過預定義SIP消息ID及消息體格式，用戶可以發(fā)送并響應服務器支持的所有消息，指出了本控件的不足之處并說明了以后的研究方向。

座席控件SIP Doubango ActiveX

1　引言

座席端軟件在一個完整的會議控制系統(tǒng)中占有十分重要的地位。座席操作員通過座席端軟件與CDMS（呼叫調(diào)度管理服務器，用于管理與座席控件之間的信息交互，執(zhí)行系統(tǒng)邏輯功能）服務器進行交互，完成對通訊設備的控制和相關信息的交換，如座席的登錄、注銷、呼出、應答、形成會議和釋放會議等動作，以上操作都是通過座席端軟件與CDMS的通信完成的［1］。

為了加快座席端軟件的開發(fā)速度，同時減少軟件模塊間的耦合度，通常把座席端軟件分為業(yè)務模塊和通信模塊。由于用戶需求經(jīng)常變化，業(yè)務模塊也會隨著變更，所以該模塊一般都需要進行定制開發(fā)。而通信模塊的功能則相對固定，所以可以將通信模塊封裝為一個獨立的控件，供上層業(yè)務模塊調(diào)用［2］。業(yè)務模塊開發(fā)者不必掌握Socket通信相關技術，更不用了解座席端與服務器間的通信協(xié)議，開發(fā)者只需訪問控件的屬性和方法并響應控件的事件，就能夠為座席端軟件添加相應的通信控制功能［3］。

2　關鍵技術

2.1SIP

會話初始化協(xié)議（Session Initiation Protocol，SIP）是由因特網(wǎng)工程任務組（Internet Engineering Task Force，IETF）制定的多媒體通信協(xié)議。它是一個基于文本的應用層控制協(xié)議，用于創(chuàng)建、修改和釋放一個或多個參與者的會話［4］。廣泛應用于下一代網(wǎng)絡（Next Generation Network，NGN）以及IP多媒體子系統(tǒng)（IP Multimedia Subsystem，IMS）的網(wǎng)絡中，可以支持并應用于語音、視頻和數(shù)據(jù)等多媒體業(yè)務，同時也可以應用于呈現(xiàn)和即時消息等特色業(yè)務。

2.2Doubango

Doubango是一個開源的VOIP基礎平臺，并能用于桌面系統(tǒng)和嵌入式的開源框架，該框架底層和中間層使用ANSI-C編寫，它是一系列API的集合，實現(xiàn)多種協(xié)議功能。TinyWRAP是一個由C++實現(xiàn)的包裝類，封裝Doubango工程所有API，并使用SWIG技術提供了C#接口。TinySIP實現(xiàn)了SIP協(xié)議，定義了SIP事件的參數(shù)，該框架還包含TinyMedia、TinyRTP、TinyDAV、TinySDP、TinyMSRP和TinyXCAP等子項目［5］。

2.3ActiveX

ActiveX控件是微軟IE支持的一種軟件組件或?qū)ο螅梢詫⑵洳迦氲絎eb頁面中，實現(xiàn)在瀏覽器端執(zhí)行動態(tài)程序功能，以增強瀏覽器端的動態(tài)處理能力。作為針對Internet應用開發(fā)的技術，ActiveX被廣泛應用于Web服務器以及客戶端的各個方面。

3　設計方案

3.1系統(tǒng)設計

座席控件以動態(tài)鏈接庫的形式存在，供C/S、B/S客戶端調(diào)用（B/S調(diào)用時需將控件封裝成.cab包，首次訪問控件時瀏覽器會自動安裝該控件），通過SIP信令與軟交換進行交互，使用時需要占用軟交換系統(tǒng)中的一個號碼資源。

座席業(yè)務功能通過本控件收發(fā)Sip Message消息來實現(xiàn)。座席端軟件與CDMS之間的通信是建立在TCP/IP的基礎上，具體的通信包為發(fā)送自定義格式的SIP Message消息，不同類型的消息具有唯一的消息ID以及相應的格式。

上層調(diào)用者要實現(xiàn)某項功能時，調(diào)用接口函數(shù)發(fā)送相應的Sip消息。該函數(shù)首先創(chuàng)建私有消息對象，然后根據(jù)AGENT消息格式生成Sip Message Body字符串，發(fā)送至軟交換服務器，再由軟交換服務器轉發(fā)至CDMS處理。接收CDMS服務器返回的消息結果后，首先解析其消息字符串生成私有消息對象，然后根據(jù)消息的ID調(diào)用已經(jīng)定義的事件，將消息結果傳給上層調(diào)用者，如圖1所示。

圖1　座席控件系統(tǒng)結構

4　系統(tǒng)實現(xiàn)

4.1控件接口

ISeatCtrl接口類定義了供第三方調(diào)用的屬性、接口函數(shù)及事件。調(diào)用者只需使用這些公開的信息即可調(diào)用該控件所用功能。

屬性為座席的各項信息，座席通過改變屬性值來設置應急指揮/呼叫中心平臺和自己相關的各項參數(shù)，如AgentID、AgentPassword、AgentName和綁定的分機號碼等信息，以及服務端的各項參數(shù)，如服務器地址和端口號等。

接口函數(shù)即是提供給調(diào)用者的各個功能，如注冊SipRegister（）、組請求GroupReq（）和登錄LogIn（）等接口函數(shù)，事件用來通知調(diào)用者調(diào)用某接口函數(shù)后的結果。因為本控件采用異步操作，調(diào)用者調(diào)用某接口后不會阻塞，控件的接收消息線程捕獲服務器返回的操作結果后，通過事件通知調(diào)用者。如注冊結果事件OnSipRegisterResult、組請求結果事件OnGroupReqResult和登錄結果事件OnLoginResult等。

4.2具體實現(xiàn)

SeatCtrl實現(xiàn)了ISeatCtrl接口，提供了對接口及事件的具體實現(xiàn)，定義了常量、消息結構和若干私有工具函數(shù)。此外，該類還實現(xiàn)了IObjectSafety接口，用來以ActiveX形式加載至瀏覽器中，該控件主要UML類圖如圖2所示。

消息結構定義：

其中消息IDwMessageID定義了消息的類型，取值范圍為事先定義的常量集合。如

GroupAsk代表AGENT請求組消息。同時定義該消息內(nèi)容sMessage為“座席標識（6）”，（6）代表6個字符。

圖2　主要UML類圖

GroupAns代表AGENT請求組結果。同時定義該消息內(nèi)容sMessage為“座席標識（6）+組標識（4）+組名（20）+…”，“…”代表若干個“組標識”和“組名”的集合。

以上說明了消息的結構及主要字段的含義，下面介紹Sip注冊、發(fā)送SIP Message消息等功能的實現(xiàn)過程。

控件的核心類是SipService類。該類主要成員變量為SIP協(xié)議棧sipStack、回調(diào)函數(shù)sipCallback、注冊會話regSession，這些成員變量的類定義依賴于Doubango庫。主要成員函數(shù)為開啟服務Start（）、停止服務Stop（）、注冊Register（）和注銷UnRegister（）等。此外還定義了注冊事件onRegistrationEvent和消息事件onMessagingEvent等。

控件的注冊接口SipRegister最終調(diào)用SipService的注冊接口Register（）。注冊函數(shù)首先依據(jù)控件各屬性初始化SIP協(xié)議棧sipStack，并將該協(xié)議棧和回調(diào)函數(shù)sipCallback綁定，然后調(diào)用sipStack.start（）啟動SIP協(xié)議棧，最后根據(jù)該協(xié)議棧初始化注冊會話regSession，并且調(diào)用regSession.register（）注冊控件，完成控件的注冊操作。

控件的注銷接口SipUnRegister最終調(diào)用SipService的注銷接口UnRegister（）。注銷時采用新的線程調(diào)用SIP協(xié)議棧的sipStack.stop（）即可完成注銷操作。服務器返回的注冊結果被sipCallback捕獲，然后觸發(fā)SipService的onRegistrationEvent事件。用戶只要監(jiān)聽該事件，即可獲得注冊結果。

控件發(fā)送座席命令是通過發(fā)送SIP Message消息完成的。各命令接口中發(fā)送的SIP Message以消息ID和消息內(nèi)容區(qū)分。下面以組請求命令為例介紹發(fā)送SIP Message的過程。

生成消息字符串分為3步。首先，創(chuàng)建消息結構SendMessage，并為各字段賦值，消息ID和消息內(nèi)容如消息結構中所述。然后，將SendMessage轉化為字節(jié)數(shù)組，并添加校驗字節(jié)碼。最后，為了避免傳輸過程中解析內(nèi)容出錯，將字節(jié)數(shù)組轉化為十六進制表示的字符串，每個字節(jié)占用2個字符，所以生成的字符串長度為字節(jié)數(shù)組長度的2倍。

接下來是發(fā)送消息。首先通過SipService的SipStack生成發(fā)送消息會話MyMessagingSession，該會話類依賴于Doubango庫。然后為該會話添加自定義的"Content-Type"屬性：AGENT_OCX。最后將字符串轉化為UTF8編碼的字節(jié)數(shù)組，調(diào)用send函數(shù)發(fā)送消息。

服務器返回處理消息命令的結果被sipCallback捕獲，然后觸發(fā)SipService的onMessagingEvent事件。用戶只要監(jiān)聽該事件，即可獲取處理結果。

加載控件時，在控件的構造函數(shù)中，實例化SeatCtrlServiceManager類，該類作為全局服務的管理類，所以采用單例模式實現(xiàn)，保證只被實例化一次。該類實現(xiàn)了Sip相關服務的初始化以及提供全局訪問的SipService屬性。實例化SeatCtrlServiceManager時初始化SipStack，調(diào)用了依賴于Doubango庫的SipStack.initialize（），然后調(diào)用該類的Start（）接口，其中調(diào)用SipService的Start（）接口，啟動SipService服務。同時為SeatCtrlServiceManager的SipService屬性的onRegistrationEvent和onMessagingEvent事件分別添加監(jiān)聽函數(shù)。

在注冊事件onRegistrationEvent的監(jiān)聽函數(shù)中，根據(jù)參數(shù)注冊事件類型RegistrationEventArgs的值判斷注冊結果。如返回REGISTRATION_OK，則調(diào)用自定義事件OnSipRegisterResult，告知第三方調(diào)用者注冊結果。

在消息事件onMessagingEvent的監(jiān)聽函數(shù)中，當接收到Message消息后，則創(chuàng)建新的線程執(zhí)行解析收到的字節(jié)數(shù)組，完成和發(fā)送SIP Message時相反的一系列操作，即將字節(jié)數(shù)組先轉化為對應的字符串，然后解析字符串生成長度減半的字節(jié)數(shù)組，最后根據(jù)字節(jié)數(shù)組轉化為消息結構體，并作為參數(shù)傳至MessageComCase函數(shù)。根據(jù)消息ID及預定義的格式解析消息內(nèi)容，生成調(diào)用事件時的參數(shù)并觸發(fā)相應的事件。如消息ID為GroupAns，則從消息內(nèi)容中提取出組標識和組名，并觸發(fā)OnGroupReqResult事件。

5　結束語

用戶通過使用該座席控件可以在桌面軟件和瀏覽器中發(fā)送座席命令，完成呼叫、群呼、形成會議、釋放會議、會議控制、磋商呼叫、強插、強拆和搶接等操作。經(jīng)測試，控件響應快速、穩(wěn)定性強和API調(diào)用方式友好，滿足對座席功能的需求。但是由于只有IE支持ActiveX插件，所以在以B/S方式加載該控件時，只能使用IE瀏覽器。其他瀏覽器訪問時還需安裝支持ActiveX的插件，用戶使用時不夠方便，所以開發(fā)更為通用的插件可以作為以后的研究方向。

［1］孫晶波.機場呼叫中心座席系統(tǒng)的設計與實現(xiàn)［D］.濟南：山東大學，2012.

［2］馮帥.交通銀行信用卡座席系統(tǒng)設計與實現(xiàn)［D］.成都：電子科技大學，2013.

［3］董恭甫.基于ActiveX的呼叫中心座席驅(qū)動的設計與實現(xiàn)［D］.北京：北京郵電大學，2012.

［4］張友波，張煥強，孫利民.基于SIP的視頻會議系統(tǒng)設計與實現(xiàn)［J］.計算機工程，2005（21）：167-169.

［5］姜懿恒，孫勇，溫向明.統(tǒng)一框架Doubango下的IMS客戶端元素［J］.計算機系統(tǒng)應用，2012，21（10）：86-90，113.

［6］劉立峻.基于ActiveX控件的Internet功能實現(xiàn)［J］.武漢工業(yè)學院學報，2004（2）：14-17.

Design and Implementation of Agent Control Based on Doubango

TIAN Hai
（State Grid Jiujiang Power Supply Company，Jiujiang Jiangxi 332000，China）

In order to encapsulate the function of sending and receiving SIP Message into an independent module for third party invoking，on the basis of Doubango library，a kind of compact software architecture is designed through Active X control，dynamic link library and other key technologies.In such software architecture，the function of sending and receiving SIP Message is encapsulated，the user experience is fully considered and the agent control that can be invoked by both C/S and B/S is completed.By predefining the ID and message content formulate of SIP message，the user can send and respond to all messages supported by the server.Finally，the disadvantages of the control are pointed out，and the future development direction is indicated.

agent control；SIP；Doubango；Active X

TP311.1

A

1008-1739（2015）19-68-4

定稿日期：2015-09-12