【正文】 成員控制在對(duì)等通信場(chǎng)景中，有時(shí)候一個(gè)通信組內(nèi)的成員會(huì)很多，但一個(gè)節(jié)點(diǎn)只希望與離它最近的幾個(gè)節(jié)點(diǎn)交互。以此類推，每個(gè)成員節(jié)點(diǎn)上的Group0都復(fù)制到了離該節(jié)點(diǎn)最近的6個(gè)成員。參考“PG_CLASS_Data類”章節(jié)5. 使用文件傳輸類(PG_CLASS_File)1) 兩點(diǎn)文件傳輸文件傳輸類提供了兩點(diǎn)之間傳輸文件的功能。兩點(diǎn)模式允許經(jīng)過呼叫協(xié)商之后才建立通話，一端發(fā)起請(qǐng)求之后，另一端可以選擇接受或拒絕，只有對(duì)端選擇接受后通話才建立。4) 實(shí)時(shí)顯示音量的變化啟用了PG_ADD_AUDIO_ShowVolume選項(xiàng)后，系統(tǒng)會(huì)調(diào)用PG_METH_AUDIO_ShowVolume方法上報(bào)在麥克風(fēng)輸入和揚(yáng)聲器輸出的音頻信號(hào)的音量。預(yù)覽模式用PG_ADD_VIDEO_Preview選項(xiàng)開啟，用來顯示從本地視頻捕捉設(shè)備上輸入的視頻圖像。調(diào)用PG_METH_VIDEO_Open打開視頻會(huì)議后，缺省沒有視頻通話加進(jìn)來，需要PG_METH_VIDEO_Join和PG_METH_VIDEO_Leave使視頻加入或離開。如果調(diào)用時(shí)指定Path參數(shù)為空，則停止當(dāng)前正在進(jìn)行的錄制操作。4) 保存和載入文件調(diào)用 PG_METH_BOARD_Save方法把當(dāng)前白板的內(nèi)容保存到指定的圖片文件。與順序傳輸模式相反，分散傳輸模式盡力避免按照從前到后的順序傳輸數(shù)據(jù)塊。4) 轉(zhuǎn)發(fā)到本地HTTP服務(wù)器控件提供了本地HTTP服務(wù)器功能，可以在節(jié)點(diǎn)本地的私網(wǎng)地址或環(huán)回地址上啟動(dòng)一個(gè)HTTP服務(wù)器，允許HTTP客戶端在本地通過HTTP方式訪問Peergine的內(nèi)容。10. 使用數(shù)據(jù)表傳輸類(PG_CLASS_Table)1) 數(shù)據(jù)表傳輸數(shù)據(jù)表傳輸類以類似操作數(shù)據(jù)庫的方式，在多點(diǎn)之間傳輸數(shù)據(jù)。3) 強(qiáng)制同步傳輸如果數(shù)據(jù)表中某些記錄已經(jīng)沒有源（添加這些記錄的節(jié)點(diǎn)已經(jīng)不在通信組里了），則數(shù)據(jù)表的同步操作就會(huì)停止在這些記錄上，不能再繼續(xù)傳輸數(shù)據(jù)，這種情況稱為記錄空洞(Hole)。切換媒體源有2種情況：(1) 在同一個(gè)節(jié)點(diǎn)上切換不同的媒體流，例如播放另外一個(gè)AVI文件。請(qǐng)參考“音頻錄制”和“視頻錄制”章節(jié)。缺省為啟用。 = “Type=1。示例(JavaScript)：// 指定服務(wù)器節(jié)點(diǎn)的名稱為“Server”，地址為“0:0:0::3000:0” = “Name=Server。如果啟用摘要方式，則需要調(diào)用PG_METH_PEER_DigVerify方法對(duì)密碼進(jìn)行驗(yàn)證。第1個(gè)為HTTP隧道/IPV6地址，第2個(gè)為TCP隧道/IPV4地址。PG_CLASS_File:16。如果返回值為1，表示處理還沒有完成，后續(xù)需要調(diào)用ObjectExtReply()函數(shù)發(fā)送應(yīng)答。返回值：[整型] 0: 成功，0: 失敗的錯(cuò)誤碼。它是一個(gè)PG_CLASS_Peer或PG_CLASS_Group類型的對(duì)象的名稱。參數(shù)：sObject：[字符串] 對(duì)象的名稱返回值：無示例(JavaScript)：// 刪除名為“OnlineGroup”的對(duì)象(“OnlineGroup”)。返回值：[整型] 1: 成功，0: 失敗。uAction：[整型] 同步動(dòng)作，1: 已同步，0: 去同步。返回值：[整型] 1: 異步處理，0: 成功，0: 錯(cuò)誤碼。返回值：[整型] 0: 成功，0: 失敗的錯(cuò)誤碼。返回值：[整型] 1: 成功，0: 失?。ㄊ盏絎M_QUIT消息）。示例(JavaScript)：var sEncEle = (“abc(efg[hij{klm”)。參數(shù)：sEle：OML字符串sPath：需要設(shè)置名稱的OML元素在整個(gè)OML字符串中的路徑sName：設(shè)置的新名字。示例(JavaScript)：var sEle = “(Name0)[Class0]{aaaaa}(Name1)[Class0]{bbbb}”。不需要對(duì)此參數(shù)進(jìn)行OML編碼。示例(JavaScript)：var sEle = “(PeerList){(Peer0){}(Peer1){}(Peer2){}(Peer4){}}”。示例(JavaScript)：var sNewEle = (“Name0”, “Class0”, “aaaaaaaaaa”)。var sNewEle = (sEle, “Name0”, “XXXXX”)。不需要對(duì)此參數(shù)進(jìn)行OML編碼。Eklm”)。如果該字符串中包含OML的標(biāo)記字符，則這些標(biāo)記字符將轉(zhuǎn)換成轉(zhuǎn)義后的標(biāo)記，請(qǐng)參考“對(duì)象標(biāo)記語言(OML)”章節(jié)。這種情況下，可以在JavaScript容器的運(yùn)行線程中主動(dòng)調(diào)用PumpMessage()函數(shù)來處理消息。參數(shù)：sObject：[字符串] 對(duì)象的名稱uErr：[整型] 錯(cuò)誤碼。sIn：[字符串] 請(qǐng)求的輸入?yún)?shù)。參數(shù)：sObject：[字符串] 對(duì)象的名稱sPeer：[字符串] 對(duì)等節(jié)點(diǎn)名稱。它是一個(gè)PG_CLASS_Peer或PG_CLASS_Group類型的對(duì)象的名稱。(“OnlineGroup”, “PG_CLASS_Group”, “Server”, 0x1)。sClass：[字符串] 該對(duì)象的類型，參考“節(jié)點(diǎn)功能類的編程參考”章節(jié)。當(dāng)接收到異步操作應(yīng)答時(shí)，系統(tǒng)調(diào)用該函數(shù)。sIn: [字符串] 請(qǐng)求的輸入?yún)?shù)，OML格式uHandle: [整型] 請(qǐng)求句柄，在ObjectExtReply()函數(shù)中返回控件。參數(shù)：PG_CLASS_Data：消息傳輸類PG_CLASS_File：文件傳輸類PG_CLASS_Audio：音頻傳輸類PG_CLASS_Video：視頻傳輸類PG_CLASS_Board：白板共享類PG_CLASS_Share：文件分塊共享類PG_CLASS_Table：數(shù)據(jù)表分發(fā)類PG_CLASS_Live：媒體流直播類示例(JavaScript)：// 類名稱的冒號(hào)后面的數(shù)字指定該類的最大實(shí)例數(shù)。參考“配置和運(yùn)行中繼服務(wù)器”章節(jié)參數(shù)：Type：中繼轉(zhuǎn)發(fā)的隧道協(xié)議類型。Addr: 服務(wù)器節(jié)點(diǎn)的網(wǎng)絡(luò)地址Digest: 是否以摘要的方式發(fā)送登錄密碼。作為普通節(jié)點(diǎn)時(shí)，即使指定了本地地址，系統(tǒng)依然會(huì)根據(jù)服務(wù)器的地址選擇合適的本地地址使用。0為二進(jìn)制（在C/C++編程中使用），1為OML格式，2為JSON格式（未支持）示例(JavaScript)：// 指定該節(jié)點(diǎn)為服務(wù)器和最大的對(duì)象數(shù)目。Update：是否啟用在線升級(jí)。3) 媒體流錄制在收看節(jié)點(diǎn)上調(diào)用PG_METH_LIVE_Record方法可以把媒體流錄制到 Path參數(shù)指定的AVI文件中。在收看節(jié)點(diǎn)上，媒體流要經(jīng)過一段時(shí)間的緩沖后才輸出。數(shù)據(jù)表同步文件屬性信息的同時(shí)，也把文件內(nèi)容也同步到通信組內(nèi)的其他節(jié)點(diǎn)。這個(gè)功能的用途是方便實(shí)現(xiàn)媒體流文件的一邊下載一邊播放。例如，假設(shè)共享的文件名為“”，則系統(tǒng)創(chuàng)建的兩個(gè)文件名分別為“”和“”，傳輸完成后系統(tǒng)把“”刪除，把“”重命名為“”。這種模式的用途是傳輸媒體流文件，按照從前到后的順序獲取數(shù)據(jù)塊有利于媒體流文件一邊下載一邊播放。3) 實(shí)現(xiàn)橡皮功能白板共享類沒有專門的橡皮功能，但可以用繪制線條的方法來實(shí)現(xiàn)橡皮。Path參數(shù)指定保存照片的文件路徑，照片文件必須是“.jpg”文件。所以，為了使通信范圍更加準(zhǔn)確，建議視頻傳輸對(duì)象關(guān)聯(lián)節(jié)點(diǎn)對(duì)象作為對(duì)端節(jié)點(diǎn)，或者關(guān)聯(lián)的通信組對(duì)象始終保持只有1個(gè)成員作為對(duì)端節(jié)點(diǎn)。請(qǐng)參考“視頻錄制”章節(jié)。會(huì)議模式下可以調(diào)用PG_METH_AUDIO_Speech方法來控制指定節(jié)點(diǎn)的發(fā)言狀態(tài)。參考“PG_CLASS_File類”章節(jié)。消息傳輸類提供多點(diǎn)之間的消息傳輸功能。那么，節(jié)點(diǎn)NodeA上的Group0給節(jié)點(diǎn)NodeB上的Group0復(fù)制了離節(jié)點(diǎn)NodeB最近的6個(gè)成員。// 在節(jié)點(diǎn)NodeB和NodeC上創(chuàng)建Group0，關(guān)聯(lián)節(jié)點(diǎn)NodeA。2) 自動(dòng)控制成員Peergine還提供了一種自動(dòng)控制通信組對(duì)象的成員的方法：(1) 當(dāng)一個(gè)通信組對(duì)象啟用了PG_ADD_GROUP_Refered選項(xiàng)時(shí)，則允許其他同名通信組對(duì)象引用該通信組對(duì)象的成員，它的成員列表將自動(dòng)復(fù)制到引用它的同名通信組對(duì)象。該方法的請(qǐng)求參數(shù)的內(nèi)容由應(yīng)用程序定義，控件透明傳輸。(2) 處理其他普通節(jié)點(diǎn)的地址解析請(qǐng)求，返回指定節(jié)點(diǎn)的地址信息和登錄狀態(tài)。 uMeth == 36) { alert(sData)。(sRemoteName, “PG_CLASS_Peer”, “”, 0x4)。 = “Type=1”。 = pgOnExtRequest。節(jié)點(diǎn)自身對(duì)象：創(chuàng)建登錄服務(wù)器節(jié)點(diǎn)對(duì)象使用PG_ADD_PEER_Self選項(xiàng)。 = Addr=0:0:0::0:0。在一個(gè)節(jié)點(diǎn)上只能有一個(gè)登錄服務(wù)器節(jié)點(diǎn)對(duì)象，如果創(chuàng)建第二個(gè)，則前面一個(gè)自動(dòng)銷毀。2. 使用節(jié)點(diǎn)類(PG_CLASS_Peer)1) 創(chuàng)建節(jié)點(diǎn)對(duì)象動(dòng)態(tài)節(jié)點(diǎn)對(duì)象：創(chuàng)建節(jié)點(diǎn)對(duì)象時(shí)不帶任何選項(xiàng)，所創(chuàng)建的就是一個(gè)動(dòng)態(tài)節(jié)點(diǎn)對(duì)象。注：沙盒目錄必須具有：創(chuàng)建、刪除、寫、讀等文件操作的權(quán)限，否則Peergine的某些功能將失效。比如，發(fā)送接收文件、緩存文件等。函數(shù)的每一次調(diào)用都是獨(dú)立的，調(diào)用完成后通過返回值輸出處理后的OML字符串。3) 處理消息循環(huán)控件與應(yīng)用程序的交互過程需要通過系統(tǒng)的消息隊(duì)列投遞消息。這時(shí)可以使用ObjectSync()函數(shù)主動(dòng)觸發(fā)通信對(duì)象進(jìn)行同步。}請(qǐng)參考“控件的屬性配置項(xiàng)”章節(jié)。PG_CLASS_Video:8?？丶\(yùn)行在瀏覽器中時(shí)，建議用HTML的object標(biāo)簽創(chuàng)建，這種方式不僅可以使用控件的所有功能，還可以使用控件的窗口來顯示視頻和白板。 (Name1){ //偵聽端口1 (Type){0} //隧道類型：TCP隧道 (AddrListen){FE800000:0:01B05996:42CFB70D:7777:0} //TCP偵聽地址/端口(這是個(gè)IPV6地址) (AddrUDP4){0:0:0::0:0} //轉(zhuǎn)換成UDP后的IPV4地址，端口自動(dòng)分配。但I(xiàn)PV4和IPV6是不兼容的，它們之間需要某種機(jī)制進(jìn)行轉(zhuǎn)換后才能互通。配置和運(yùn)行中繼服務(wù)器1. 關(guān)于Peergine使用UDP協(xié)議進(jìn)行通信（如下圖）。JNI類庫：，包含了pgJNI、pgJNINode和pgJNINodeProc共3個(gè)java類。 IPV4和IPV6地址格式到Peergine地址格式的對(duì)應(yīng)關(guān)系如下圖：0007F00000180080::::::圖12. IPV4地址到Peergine地址的對(duì)應(yīng)關(guān)系FE800000001B0599642CFB70D80080FE8000001B0599642CFB70D:::::::::::::圖13. IPV6地址到Peergine地址的對(duì)應(yīng)關(guān)系2) 時(shí)間的格式Peergine系統(tǒng)中使用的時(shí)間格式為：YYYYMMDD,HH:MM:SS。應(yīng)用程序pgAtx控件pgAtx控件應(yīng)用程序()()發(fā)送請(qǐng)求接收請(qǐng)求節(jié)點(diǎn)A節(jié)點(diǎn)B網(wǎng)絡(luò)圖7. 交互方式45) 方式5：本端應(yīng)用程序發(fā)送請(qǐng)求，本端應(yīng)用程序接收應(yīng)答。2) 方式1：本端應(yīng)用程序發(fā)送請(qǐng)求、接收應(yīng)答。一個(gè)節(jié)點(diǎn)對(duì)象或通信組對(duì)象可以被多個(gè)通信對(duì)象關(guān)聯(lián)。例如上圖中，在節(jié)點(diǎn)NodeA上創(chuàng)建節(jié)點(diǎn)對(duì)象NodeB，它跟節(jié)點(diǎn)NodeB的自身對(duì)象同名，所以它的通信范圍就是節(jié)點(diǎn)B。位于不同節(jié)點(diǎn)上的相同名稱的通信對(duì)象之間自動(dòng)地建立起通信會(huì)話，然后在其中一個(gè)節(jié)點(diǎn)上調(diào)用該對(duì)象的方法，就可以完成與其它各節(jié)點(diǎn)之間的通信交互。兩點(diǎn)通信會(huì)話與多點(diǎn)通信會(huì)話的比較示意圖，如下：(a)(b)圖1. (a) 兩點(diǎn)通信會(huì)話連接，(b) 多點(diǎn)通信會(huì)話連接進(jìn)一步，我們把一個(gè)多點(diǎn)通信會(huì)話封裝成一個(gè)通信對(duì)象，用面向?qū)ο蟮姆椒▉肀硎鼍W(wǎng)絡(luò)通信的特征，這樣就使對(duì)等網(wǎng)絡(luò)編程變得更加簡(jiǎn)單、直觀。可用JavaScript和Java編程語言構(gòu)建Web應(yīng)用的瀏覽器端和服務(wù)器端。支持HTTP代理方式通信，在代理后面的主機(jī)也能連接到Peergine網(wǎng)絡(luò)。3) 自適應(yīng)的網(wǎng)絡(luò)互通機(jī)制以IPV4和IPV6的UDP協(xié)議為基礎(chǔ)進(jìn)行網(wǎng)絡(luò)通信。數(shù)據(jù)表傳輸類：多個(gè)節(jié)點(diǎn)之間用訪問數(shù)據(jù)庫的方式傳輸數(shù)據(jù)。支持本地預(yù)覽模式、兩點(diǎn)對(duì)話模式和多點(diǎn)會(huì)議模式。參考“使用通信組類”章節(jié)消息傳輸類：多個(gè)節(jié)點(diǎn)之間單向傳輸消息。2. Peergine的功能特性1) 全新的網(wǎng)絡(luò)編程模式以面向?qū)ο蟮姆椒?，把?fù)雜的多點(diǎn)對(duì)等通信交互過程封裝成通信對(duì)象，提供簡(jiǎn)單、直觀的編程接口。為了適應(yīng)多種運(yùn)行環(huán)境，Peergine被封裝成ActiveX控件(pgATX)、NPAPI插件和JNI插件等，能夠在Internet Explorer、Chrome、Firefox和Safari等瀏覽器以及Windows Script Host、Java Runtime Environment等環(huán)境中運(yùn)行。2) 強(qiáng)大的對(duì)等通信功能以通信對(duì)象類的形式實(shí)現(xiàn)各種對(duì)等通信功能，目前支持的通信對(duì)象類為：節(jié)點(diǎn)類：提供對(duì)象的兩點(diǎn)通信范圍控制。支持PUT和GET傳輸方式，文件的斷點(diǎn)續(xù)傳。白板共享類：多個(gè)節(jié)點(diǎn)共享白板，可設(shè)置繪制每種圖形的參數(shù)，可設(shè)置繪制每種圖形時(shí)的鼠標(biāo)光標(biāo)，保存白板內(nèi)容到圖片文件，從圖片文件裝入內(nèi)容到白板。媒體流直播類：多個(gè)節(jié)點(diǎn)之間對(duì)等直播媒體流。通過中繼服務(wù)器還可以完成 IPV4和IPV6之間的轉(zhuǎn)換。4) 控件提供豐富的輔助功能Peergine在封裝成控件時(shí)，又增加實(shí)現(xiàn)了輔助功能，包括常用的文件操作、文件緩沖區(qū)操作、本地Cookie存儲(chǔ)、本