【正文】 7) String omlGetEle(sEle, sPath, uSize, uPos)描述：從一個(gè)OML字符串中獲取指定的OML元素參數(shù)：sEle：OML字符串sPath：要獲取的元素在整個(gè)OML字符串的路徑uSize：獲取OML元素的個(gè)數(shù)uPos：獲取OML元素的起始位置返回值：[字符串] 獲取到的OML元素。6) String omlNewEle(sName, sClass, sContent)描述：生成一個(gè)OML元素字符串參數(shù)：sName：元素的名稱。返回值：[字符串] 設(shè)置元素類型后的整個(gè)OML字符串。3) String omlSetName(sEle, sPath, sName)描述：設(shè)置一個(gè)OML元素的名稱。參數(shù)：sEle：[字符串] 需要編碼的字符串返回值：[字符串] 編碼后的字符串。參數(shù)：uLoop：[整型] 0：每處理完一個(gè)消息后，該函數(shù)返回；1：該函數(shù)循環(huán)處理消息，直到進(jìn)程退出前才返回。sOut：[字符串] 應(yīng)答的輸出參數(shù)uHandle：[整型] 請(qǐng)求句柄，由OnExtRequest()函數(shù)輸入的uHandle參數(shù)。sParam：[字符串] 用戶定義參數(shù)，在OnReply()回調(diào)函數(shù)中原樣返回。如果此參數(shù)為空，則與通信范圍內(nèi)的所有節(jié)點(diǎn)都進(jìn)行同步。當(dāng)此參數(shù)為空時(shí)，刪除之前關(guān)聯(lián)的組。2) void ObjectDelete(sObject)描述：刪除一個(gè)對(duì)象。sGroup：[字符串] 該對(duì)象關(guān)聯(lián)的組。原型：int OnReply(sObject, uErr, sOut, sParam)參數(shù)：sObject：[字符串] 對(duì)象名稱uErr：[整型] 錯(cuò)誤碼sOut：[字符串] 應(yīng)答的輸出參數(shù)，OML格式sParam：[字符串] 用戶參數(shù)，就是在ObjectRequest()函數(shù)調(diào)用時(shí)輸入的sParam參數(shù)。sPeer: [字符串] 發(fā)出請(qǐng)求的對(duì)等節(jié)點(diǎn)返回值：[整型] 1: 異步處理，0: 成功，0: 失敗的錯(cuò)誤碼。=“PG_CLASS_Data:8。0為TCP隧道，1為HTTP隧道，2為WebSocket隧道（未支持）Load：中繼服務(wù)器的負(fù)荷Addr：中繼服務(wù)器的偵聽地址示例(JavaScript)：// 指定2個(gè)隧道參數(shù)。0為明文方式，1為摘要方式。只有無法根據(jù)服務(wù)器地址選擇本地地址時(shí)，才會(huì)使用指定的本地地址。如果不指定某個(gè)參數(shù)的值，則使用系統(tǒng)的缺省值。0為禁用，1為啟用。如果調(diào)用時(shí)指定Path參數(shù)為空，則停止當(dāng)前正在進(jìn)行的錄制操作。2) 媒體源的切換媒體流直播過程中有時(shí)需要切換到新的媒體源，恰當(dāng)?shù)牟僮髂苁骨袚Q過程平滑，產(chǎn)生的停頓較短。請(qǐng)參考“說明：文件傳輸模式”章節(jié)。使用順序傳輸模式獲取媒體流文件并實(shí)時(shí)轉(zhuǎn)發(fā)到本地HTTP服務(wù)器上，然后使用具有網(wǎng)絡(luò)播放功能的播放器播放該媒體流文件的URL。某個(gè)節(jié)點(diǎn)獲取到所有的文件數(shù)據(jù)塊后，作為種子給其他節(jié)點(diǎn)繼續(xù)共享文件。2) 分散傳輸模式分散傳輸模式用PG_ADD_SHARE_Distribute選項(xiàng)開啟。設(shè)置線條的顏色與背景顏色相同、設(shè)置較寬的線條寬度、設(shè)置橡皮形狀的鼠標(biāo)光標(biāo)，繪制這樣的線條時(shí)就等同于橡皮的效果。6) 視頻錄制調(diào)用PG_METH_VIDEO_Record方法可將視頻輸出錄制到由Path參數(shù)指定的AVI文件中。3) 會(huì)議模式及視頻的加入和離開會(huì)議模式用PG_ADD_VIDEO_Conference選項(xiàng)開啟。7. 使用視頻傳輸類(PG_CLASS_Video)1) 預(yù)覽模式視頻傳輸類有三種模式：預(yù)覽模式、兩點(diǎn)模式和會(huì)議模式。3) 設(shè)置和獲取音量調(diào)用PG_METH_AUDIO_CtrlVolume方法可設(shè)置和獲取麥克風(fēng)和揚(yáng)聲器的音量。6. 使用音頻傳輸類(PG_CLASS_Audio)1) 兩點(diǎn)模式音頻傳輸類有兩種模式：兩點(diǎn)模式和會(huì)議模式，缺省為兩點(diǎn)模式。調(diào)用PG_METH_DATA_Message方法可以給所關(guān)聯(lián)的通信組成員的發(fā)送單向的消息，消息的內(nèi)容完全由應(yīng)用程序決定，控件透明傳輸。同樣，節(jié)點(diǎn)NodeA上的Group0給節(jié)點(diǎn)NodeC上的Group0復(fù)制了離節(jié)點(diǎn)NodeC最近的6個(gè)成員。(“Group0”, “PG_CLASS_Group”, “NodeA”, 0)。當(dāng)它的成員發(fā)生變化時(shí)，會(huì)實(shí)時(shí)地通知給引用它的同名通信組對(duì)象。6) 數(shù)據(jù)的簽名和校驗(yàn)調(diào)用節(jié)點(diǎn)類的PG_METH_PEER_DigGen方法產(chǎn)生數(shù)據(jù)的簽名，調(diào)用節(jié)點(diǎn)類的PG_METH_PEER_DigVerify方法校驗(yàn)數(shù)據(jù)的簽名。(3) 協(xié)助普通節(jié)點(diǎn)處理NAT穿越和中繼隧道類型的協(xié)商。 // 顯示接收到的“Hello!”消息 }}function pgOnReply(sObj, uErr, sData, sParam) {}/script但是，這個(gè)程序在實(shí)際中很難使用，因?yàn)橐孪戎缹?duì)端節(jié)點(diǎn)的網(wǎng)絡(luò)地址。var sInEle = “(Addr){“ + sRemoteAddr + “}(Proxy){}”。 = “Type=1”。 = pgOnReply。在一個(gè)節(jié)點(diǎn)上只能有一個(gè)節(jié)點(diǎn)自身對(duì)象，如果創(chuàng)建第二個(gè)，則前面一個(gè)自動(dòng)銷毀。// Name參數(shù)指定登錄服務(wù)器節(jié)點(diǎn)對(duì)象的名稱，Addr參數(shù)指定登錄服務(wù)器節(jié)點(diǎn)的地址。在實(shí)際使用中不需要直接創(chuàng)建登錄服務(wù)器節(jié)點(diǎn)對(duì)象，而是在控件初始化時(shí)，由系統(tǒng)自動(dòng)創(chuàng)建。在通信組對(duì)象添加成員時(shí)，如果該成員所對(duì)應(yīng)的節(jié)點(diǎn)對(duì)象不存在，則系統(tǒng)自動(dòng)創(chuàng)建一個(gè)對(duì)應(yīng)的動(dòng)態(tài)節(jié)點(diǎn)對(duì)象。沙盒目錄中的文件的移入和移出通過FileCopy()命令完成，F(xiàn)ileCopy()的Src參數(shù)和Dst參數(shù)的使用規(guī)則如下：(1) Src和Dst都指定了文件路徑（非空），則Src和Dst指定的文件都必須在沙盒目錄內(nèi)，否則命令調(diào)用執(zhí)行失敗。為了防止某些惡意的應(yīng)用程序使用Peergine進(jìn)行偷竊用戶數(shù)據(jù)、傳輸惡意代碼等不良操作，Peergine通過使用沙盒目錄來控制文件系統(tǒng)的訪問范圍。5) 獲取控件的窗口參數(shù)控件運(yùn)行在瀏覽器中時(shí)，一個(gè)重要用途是做為視頻顯示和白板共享的窗口。當(dāng)控件運(yùn)行在界面線程中 (例如運(yùn)行在瀏覽器中)時(shí)，界面線程能夠處理消息循環(huán)。通信對(duì)象同步以后，就可以調(diào)用通信對(duì)象的方法。2) 使用通信對(duì)象初始化控件實(shí)例之后，就可以使用控件的節(jié)點(diǎn)功能函數(shù)。 = Addr=0:0:0::0:0。代碼示例(HTML)：object id=pgAtx classid=clsid:FFC9369FA8D945988E22ED07C7628BFC width=320 height=240/object控件運(yùn)行在Windows Script Host中時(shí)，使用JavaScript的ActiveXObject()函數(shù)創(chuàng)建，代碼示例(JavaScript)：var pgAtx = new ActiveXObject()。 (AddrUDP6){FE800000:0:01B05996:42CFB70D:0:0} //轉(zhuǎn)換成UDP后的IPV6地址，端口自動(dòng)分配。Peergine中繼服務(wù)器提供了IPV4和IPV6的轉(zhuǎn)換功能，使IPV4節(jié)點(diǎn)與IPV6節(jié)點(diǎn)之間也能互通。節(jié)點(diǎn)A節(jié)點(diǎn)BUDP v4/v6圖14. 直接UDP通信方式但在實(shí)際網(wǎng)絡(luò)環(huán)境中，某些節(jié)點(diǎn)的UDP通信是受限的。將其路徑添加到CLASSPATH環(huán)境變量中，就可以在Java應(yīng)用程序中調(diào)用Peergine的API。樣例：20111022,18:20:09。應(yīng)用程序pgAtx控件()()發(fā)送請(qǐng)求接收應(yīng)答節(jié)點(diǎn)A圖8. 交互方式56) 方式6：本端應(yīng)用程序發(fā)送請(qǐng)求觸發(fā)本端控件上報(bào)事件給應(yīng)用。對(duì)端應(yīng)用程序接收請(qǐng)求、發(fā)送應(yīng)答。參考“使用通信組類”章節(jié)。使用節(jié)點(diǎn)對(duì)象可以建立兩點(diǎn)之間的通信會(huì)話。同名通信對(duì)象建立通信會(huì)話的過程，稱為“通信對(duì)象的同步”。Peergine就是這種以通信對(duì)象為基礎(chǔ)的對(duì)等通信系統(tǒng)。各種OS和運(yùn)行環(huán)境的支持情況及路標(biāo)如下表：運(yùn)行環(huán)境\OSWindowsLinuxAndroidMac OS XiOSInternet Explorer√Chrome√√√2012Q22012Q2Firefox√√√2012Q22012Q2Safari√2012Q22012Q2Java (JNI)√√√3. 基于對(duì)象的多點(diǎn)通信會(huì)話1) 概念在以往的網(wǎng)絡(luò)編程方法中，例如，TCP連接、SIP會(huì)話等，通信會(huì)話一般指兩點(diǎn)之間協(xié)商建立起來的通信交互。實(shí)現(xiàn)QOS機(jī)制，每個(gè)節(jié)點(diǎn)都有4個(gè)優(yōu)先級(jí)隊(duì)列，分別對(duì)消息/信令、音頻、視頻和文件4種流量進(jìn)行優(yōu)先級(jí)調(diào)度，保證高優(yōu)先級(jí)流量的服務(wù)質(zhì)量。對(duì)于UDP協(xié)議通信受限的節(jié)點(diǎn)，通過承載在TCP之上的隧道連接到中繼服務(wù)器，然后轉(zhuǎn)換成UDP協(xié)議通信。支持文件傳輸模式，每個(gè)文件對(duì)應(yīng)到數(shù)據(jù)表的一條記錄進(jìn)行傳輸，實(shí)現(xiàn)文件的批量同步。支持會(huì)議模式中視頻的加入/離開，視頻顯示窗口的調(diào)整和轉(zhuǎn)移，抓拍視頻照片，視頻錄制。參考“使用消息傳輸類”章節(jié)。即便是對(duì)網(wǎng)絡(luò)通信知識(shí)缺乏了解的編程人員，也能夠構(gòu)建出功能強(qiáng)大的對(duì)等通信應(yīng)用。 Peergine編程手冊(cè)Peergine編程手冊(cè)V 201205介紹1. 關(guān)于PeerginePeergine是一個(gè)功能強(qiáng)大的對(duì)等通信中間件，用C/C++編程語言開發(fā)。參考“基于對(duì)象的多點(diǎn)通信會(huì)話”章節(jié)。文件傳輸類：兩個(gè)節(jié)點(diǎn)之間的文件傳輸。參考“使用視頻傳輸類”章節(jié)。參考“使用數(shù)據(jù)表傳輸類”章節(jié)。支持TCP、HTTP和WebSocket三種協(xié)議的隧道，以適應(yīng)多種通信環(huán)境。支持對(duì)通信數(shù)據(jù)進(jìn)行加密，加密的密鑰自動(dòng)協(xié)商生成，無需配置。且也已經(jīng)有了相應(yīng)成熟的網(wǎng)絡(luò)編程模型，例如Socket API。在系統(tǒng)中不同的通信業(yè)務(wù)類型表述為相對(duì)應(yīng)的通信對(duì)象類，例如消息傳輸類、音頻傳輸類、視頻傳輸類等，而每一個(gè)通信對(duì)象實(shí)例表示一個(gè)通信會(huì)話。如下圖，有NodeA、NodeB、NodeC三個(gè)節(jié)點(diǎn)，它們的自身對(duì)象分別為 NodeA、NodeB、NodeC。對(duì)于通信組對(duì)象，它的通信范圍由它所包含的組成員決定。4. 控件與應(yīng)用程序的交互方式1) 系統(tǒng)概述Peergine中間件的系統(tǒng)框圖如下，它位于應(yīng)用程序和網(wǎng)絡(luò)層的中間。應(yīng)用程序pgAtx控件pgAtx控件應(yīng)用程序()()()()網(wǎng)絡(luò)發(fā)送請(qǐng)求接收請(qǐng)求發(fā)送應(yīng)答接收應(yīng)答節(jié)點(diǎn)A節(jié)點(diǎn)B圖4. 交互方式13) 方式2：本端應(yīng)用程序發(fā)送請(qǐng)求、接收應(yīng)答。應(yīng)用程序pgAtx控件()()發(fā)送請(qǐng)求觸發(fā)上報(bào)節(jié)點(diǎn)A圖9. 交互方式67) 方式7：本端應(yīng)用程序調(diào)用本端控件的方法但沒有輸出。3) 文件摘要的格式Peergine 系統(tǒng)中使用的文件摘要格式為：SHA256算法生成，Base64編碼。2. Linux平臺(tái)：NPAPI插件：，復(fù)制到/usr/lib/mozilla/plugins目錄后就可以在瀏覽器中調(diào)用Peergine的API。例如，這些節(jié)點(diǎn)位于防火墻的后面，而防火墻把UDP端口全部封鎖。2. 配置運(yùn)行。 } (Name2){ //偵聽端口2 (Type){1} //隧道類型：HTTP隧道 (AddrListen){0:0:0::8888:0} //TCP偵聽地址/端口(這是個(gè)IPV4地址) (AddrUDP4){0:0:0::0:0} //轉(zhuǎn)換成UDP后的IPV4地址，端口自動(dòng)分配。創(chuàng)建控件實(shí)例后，通過給控件的配置屬性變量賦值進(jìn)行配置，然后調(diào)用Start()函數(shù)啟動(dòng)控件的節(jié)點(diǎn)功能。 = Name=PGServer。用ObjectAdd()函數(shù)創(chuàng)建通信對(duì)象，用ObjectDelete()刪除通信對(duì)象。需要ObjectRequest()、ObjectExtReply()、OnExtRequest()和OnReply()這4 個(gè)函數(shù)配合才可以完成一次方法的調(diào)用。但運(yùn)行在Windows Script Host中時(shí)，線程沒有消息循環(huán)，無法完成交互消息的投遞?？丶峁┝溯o助函數(shù)utilGetWndRect()來獲取控件窗口的尺寸和句柄，以便用來初始化視頻或白板窗口?？刂埔?guī)則如下：(1) 所有涉及到網(wǎng)絡(luò)傳輸?shù)奈募L問都限制在沙盒目錄內(nèi)。(2) Src指定了文件路徑且Dst為空，則Src指定的文件必須在沙盒目錄內(nèi)。所以，動(dòng)態(tài)節(jié)點(diǎn)對(duì)象一般都由系統(tǒng)自動(dòng)創(chuàng)建，無須直接調(diào)用控件的API創(chuàng)建。代碼示例(JavaScript)： = Type=1。 = Name=PGServer。在實(shí)際使用中不需要直接創(chuàng)建節(jié)點(diǎn)自身對(duì)象，而是在控件初始化或調(diào)用登錄方法時(shí)，有系統(tǒng)自動(dòng)創(chuàng)建。(0)。 = “Name=” + sLocalName + “。(sRemoteName, 37, sInEle, “SetAddr”)。對(duì)此，Peergine提供了自動(dòng)交換節(jié)點(diǎn)網(wǎng)絡(luò)地址的方法，請(qǐng)看參考下文的“登錄、注銷和地址解析”章節(jié)。普通節(jié)點(diǎn)通過調(diào)用登錄服務(wù)器節(jié)點(diǎn)對(duì)象的PG_METH_PEER_Login和PG_METH_PEER_Logout方法來請(qǐng)求登錄和注銷。3. 使用通信組類(PG_CLASS_Group)1) 手動(dòng)控制成員通過調(diào)用通信組類的PG_METH_GROUP_Modify方法來手動(dòng)添加、刪除通信組的成員，必須啟用PG_ADD_GROUP_Modify選項(xiàng)后才允許調(diào)用該方法。(2) 一個(gè)通信組對(duì)象引用了另一個(gè)通信組對(duì)象的成員時(shí)，它自身的節(jié)點(diǎn)也同時(shí)加入了被引用的通信組對(duì)象的成員列表。3) 鄰近