【正文】 8) String omlDeleteEle(sEle, sPath, uSize, uPos)描述：從一個(gè)OML字符串中刪除指定的OML元素參數(shù)：sEle：OML字符串sPath：要?jiǎng)h除的元素在整個(gè)OML字符串的路徑uSize：刪除OML元素的個(gè)數(shù)uPos：刪除OML元素的起始位置返回值：[字符串] 刪除指定元素后的OML字符串。示例(JavaScript)：var sEle = “(PeerList){(Peer0){}(Peer1){}(Peer2){}(Peer4){}}”。示例(JavaScript)：var sNewEle = (“Name0”, “Class0”, “aaaaaaaaaa”)。不需要對(duì)此參數(shù)進(jìn)行OML編碼。不需要對(duì)此參數(shù)進(jìn)行OML編碼。不需要對(duì)此參數(shù)進(jìn)行OML編碼。var sNewEle = (sEle, “Name0”, “XXXXX”)。返回值：[字符串] 設(shè)置元素內(nèi)容后的整個(gè)OML字符串。5) String omlSetContent(sEle, sPath, sContent)描述：設(shè)置一個(gè)OML元素的內(nèi)容參數(shù)：sEle：OML字符串sPath：需要設(shè)置名稱的OML元素在整個(gè)OML字符串中的路徑sContent：設(shè)置的新內(nèi)容。示例(JavaScript)：var sEle = “(Name0)[Class0]{aaaaa}(Name1)[Class0]{bbbb}”。不需要對(duì)此參數(shù)進(jìn)行OML編碼。var sNewEle = (sEle, “Name0”, “NameX”)。返回值：[字符串] 設(shè)置元素名稱后的整個(gè)OML字符串。參數(shù)：sEle：OML字符串sPath：需要設(shè)置名稱的OML元素在整個(gè)OML字符串中的路徑sName：設(shè)置的新名字。Eklm”)。Aefgamp。參數(shù)：sEle：[字符串] 需要解碼的字符串返回值： [字符串] 解碼后的字符串。示例(JavaScript)：var sEncEle = (“abc(efg[hij{klm”)。如果該字符串中包含OML的標(biāo)記字符，則這些標(biāo)記字符將轉(zhuǎn)換成轉(zhuǎn)義后的標(biāo)記，請(qǐng)參考“對(duì)象標(biāo)記語(yǔ)言(OML)”章節(jié)。示例(JavaScript)：// 啟動(dòng)一個(gè) Node的功能(0)。while ((0)) { // TO DO}10) int Start(uOption)描述：?jiǎn)?dòng)節(jié)點(diǎn)功能參數(shù)：uOption：[整型] 選項(xiàng)，必須為0。返回值：[整型] 1: 成功，0: 失?。ㄊ盏絎M_QUIT消息）。這種情況下，可以在JavaScript容器的運(yùn)行線程中主動(dòng)調(diào)用PumpMessage()函數(shù)來(lái)處理消息。控件與應(yīng)用程序之間的交互需要通過(guò)消息隊(duì)列投遞消息。(“Server”, 0, “I am fine.”, uHandle)。返回值：[整型] 0: 成功，0: 失敗的錯(cuò)誤碼。參數(shù)：sObject：[字符串] 對(duì)象的名稱uErr：[整型] 錯(cuò)誤碼。// PG_CLASS_Peer類的PG_METH_PEER_Call方法的ID為35(“Server”, 35, “How are you?”, “SendCall”)。如果返回=0，則操作已經(jīng)完成，返回值表示執(zhí)行結(jié)果。返回值：[整型] 1: 異步處理，0: 成功，0: 錯(cuò)誤碼。sIn：[字符串] 請(qǐng)求的輸入?yún)?shù)。7) int ObjectRequest(sObject, uMeth, sIn, sParam)描述：發(fā)送一個(gè)請(qǐng)求操作。示例(JavaScript)：// 觸發(fā)“OnlineGroup”對(duì)象在“Server”節(jié)點(diǎn)上進(jìn)行同步。uAction：[整型] 同步動(dòng)作，1: 已同步，0: 去同步。參數(shù)：sObject：[字符串] 對(duì)象的名稱sPeer：[字符串] 對(duì)等節(jié)點(diǎn)名稱。示例(JavaScript)：// 獲取對(duì)象“OnlineGroup”的關(guān)聯(lián)組var sGroup = (“OnlineGroup”)。5) String ObjectGetGroup(sObject)描述：獲取對(duì)象的關(guān)聯(lián)組。返回值：[整型] 1: 成功，0: 失敗。它是一個(gè)PG_CLASS_Peer或PG_CLASS_Group類型的對(duì)象的名稱。4) int ObjectSetGroup(sObject, sGroup)描述：指定對(duì)象的關(guān)聯(lián)組。參數(shù)：sObject：[字符串] 對(duì)象的名稱返回值：[字符串] 該對(duì)象的類型。參數(shù)：sObject：[字符串] 對(duì)象的名稱返回值：無(wú)示例(JavaScript)：// 刪除名為“OnlineGroup”的對(duì)象(“OnlineGroup”)。(“OnlineGroup”, “PG_CLASS_Group”, “Server”, 0x1)。示例(JavaScript)：// 添加一個(gè)名為“OnlineGroup”的通信組對(duì)象。uFlag：[整型] 指定創(chuàng)建對(duì)象的選項(xiàng)標(biāo)志，參考“節(jié)點(diǎn)功能類的編程參考”中的“標(biāo)志”章節(jié)。它是一個(gè)PG_CLASS_Peer或PG_CLASS_Group類型的對(duì)象的名稱。sClass：[字符串] 該對(duì)象的類型，參考“節(jié)點(diǎn)功能類的編程參考”章節(jié)。參數(shù)：sObject：[字符串] 對(duì)象的名稱。} = pgOnReply。返回值：[整型] 0: 成功，0: 失敗的錯(cuò)誤碼。當(dāng)接收到異步操作應(yīng)答時(shí)，系統(tǒng)調(diào)用該函數(shù)。} = pgOnExtRequest。示例(JavaScript)：function pgOnExtRequest(sObject, uMeth, sIn, uHandle, sPeer){ // TO DO … (sObject, 0, “”, uHandle)。如果返回值為1，表示處理還沒(méi)有完成，后續(xù)需要調(diào)用ObjectExtReply()函數(shù)發(fā)送應(yīng)答。sIn: [字符串] 請(qǐng)求的輸入?yún)?shù)，OML格式uHandle: [整型] 請(qǐng)求句柄，在ObjectExtReply()函數(shù)中返回控件。當(dāng)控件接收到其他節(jié)點(diǎn)的請(qǐng)求時(shí)，通過(guò)此函數(shù)上報(bào)給應(yīng)用程序，處理該請(qǐng)求。PG_CLASS_Video:4”。PG_CLASS_File:16。參數(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ù)。”隔開(kāi)。 6) Class描述：指定使能的Peergine 功能類以及每種類的最大實(shí)例數(shù)。第1個(gè)為HTTP隧道/IPV6地址，第2個(gè)為TCP隧道/IPV4地址。參考“配置和運(yùn)行中繼服務(wù)器”章節(jié)參數(shù)：Type：中繼轉(zhuǎn)發(fā)的隧道協(xié)議類型。 5) Relay描述：配置中繼服務(wù)的器的隧道參數(shù)，可以同時(shí)指定多個(gè)隧道。Addr=0:0:0::3000:0。如果啟用摘要方式，則需要調(diào)用PG_METH_PEER_DigVerify方法對(duì)密碼進(jìn)行驗(yàn)證。Addr: 服務(wù)器節(jié)點(diǎn)的網(wǎng)絡(luò)地址Digest: 是否以摘要的方式發(fā)送登錄密碼。如果該節(jié)點(diǎn)為服務(wù)器，則不要指定服務(wù)器Peer對(duì)象的名稱。 4) Server描述：配置節(jié)點(diǎn)的服務(wù)器參數(shù)。示例(JavaScript)：// 指定服務(wù)器節(jié)點(diǎn)的名稱為“Server”，地址為“0:0:0::3000:0” = “Name=Server。作為普通節(jié)點(diǎn)時(shí)，即使指定了本地地址，系統(tǒng)依然會(huì)根據(jù)服務(wù)器的地址選擇合適的本地地址使用。如果該節(jié)點(diǎn)為普通節(jié)點(diǎn)，則不要指定本地Peer對(duì)象的名稱。3) Local描述：配置節(jié)點(diǎn)的本地參數(shù)。 = “Type=1。0為二進(jìn)制（在C/C++編程中使用），1為OML格式，2為JSON格式（未支持）示例(JavaScript)：// 指定該節(jié)點(diǎn)為服務(wù)器和最大的對(duì)象數(shù)目。0為普通節(jié)點(diǎn)，1為登錄服務(wù)器節(jié)點(diǎn)Cert：證書(shū)文件的路徑。2) Node描述：配置節(jié)點(diǎn)的性能參數(shù)。缺省為啟用。Update：是否啟用在線升級(jí)?？丶壳爸С忠韵鹿δ埽?：使能對(duì)等通信節(jié)點(diǎn)功能。在缺省情況下，可以使用“控件的OML解析器函數(shù)”和“控件的輔助函數(shù)”。請(qǐng)參考“音頻錄制”和“視頻錄制”章節(jié)。3) 媒體流錄制在收看節(jié)點(diǎn)上調(diào)用PG_METH_LIVE_Record方法可以把媒體流錄制到 Path參數(shù)指定的AVI文件中。待老的源節(jié)點(diǎn)上調(diào)用PG_METH_LIVE_Close方法關(guān)閉原來(lái)的媒體流后，新的源節(jié)點(diǎn)上立即執(zhí)行PG_LIVE_CTRL_Play動(dòng)作開(kāi)始播放。(2) 在不同的節(jié)點(diǎn)上切換不同的媒體流，例如切換到另外一個(gè)節(jié)點(diǎn)的實(shí)時(shí)捕捉視頻流。切換媒體源有2種情況：(1) 在同一個(gè)節(jié)點(diǎn)上切換不同的媒體流，例如播放另外一個(gè)AVI文件。在收看節(jié)點(diǎn)上，媒體流要經(jīng)過(guò)一段時(shí)間的緩沖后才輸出。如果通信組內(nèi)存在2個(gè)以上的源節(jié)點(diǎn)，則會(huì)導(dǎo)致直播狀態(tài)混亂。11. 使用媒體流直播類(PG_CLASS_Live)1) 媒體流的播放和收看媒體流直播類支持三種媒體流類型：實(shí)時(shí)捕捉的音頻流、實(shí)時(shí)捕捉的視頻流和播放AVI文件影音流。3) 強(qiáng)制同步傳輸如果數(shù)據(jù)表中某些記錄已經(jīng)沒(méi)有源（添加這些記錄的節(jié)點(diǎn)已經(jīng)不在通信組里了），則數(shù)據(jù)表的同步操作就會(huì)停止在這些記錄上，不能再繼續(xù)傳輸數(shù)據(jù)，這種情況稱為記錄空洞(Hole)。數(shù)據(jù)表同步文件屬性信息的同時(shí)，也把文件內(nèi)容也同步到通信組內(nèi)的其他節(jié)點(diǎn)。2) 文件傳輸模式文件傳輸模式是數(shù)據(jù)表傳輸類的增強(qiáng)功能，用PG_ADD_TABLE_File選項(xiàng)開(kāi)啟。在一個(gè)節(jié)點(diǎn)上調(diào)用PG_METH_TABLE_Insert、PG_METH_TABLE_Update和PG_METH_TABLE_Delete方法對(duì)數(shù)據(jù)表記錄進(jìn)行插入、修改和刪除時(shí)，數(shù)據(jù)所作的變更會(huì)實(shí)時(shí)地同步到通信組內(nèi)的其他節(jié)點(diǎn)。10. 使用數(shù)據(jù)表傳輸類(PG_CLASS_Table)1) 數(shù)據(jù)表傳輸數(shù)據(jù)表傳輸類以類似操作數(shù)據(jù)庫(kù)的方式，在多點(diǎn)之間傳輸數(shù)據(jù)。這個(gè)功能的用途是方便實(shí)現(xiàn)媒體流文件的一邊下載一邊播放。當(dāng)獲取到數(shù)據(jù)塊時(shí)，會(huì)實(shí)時(shí)轉(zhuǎn)發(fā)到本地HTTP服務(wù)器上。使用HttpConfig命令啟動(dòng)本地HTTP服務(wù)器，請(qǐng)參考“控件的命令列表”章節(jié)。4) 轉(zhuǎn)發(fā)到本地HTTP服務(wù)器控件提供了本地HTTP服務(wù)器功能，可以在節(jié)點(diǎn)本地的私網(wǎng)地址或環(huán)回地址上啟動(dòng)一個(gè)HTTP服務(wù)器，允許HTTP客戶端在本地通過(guò)HTTP方式訪問(wèn)Peergine的內(nèi)容。例如，假設(shè)共享的文件名為“”，則系統(tǒng)創(chuàng)建的兩個(gè)文件名分別為“”和“”，傳輸完成后系統(tǒng)把“”刪除，把“”重命名為“”。這兩個(gè)文件的文件名分別為共享文件名加上后綴“.pgshs”和“.pgshi”。3) 文件的存儲(chǔ)和種子調(diào)用PG_METH_SHARE_Open 方法打開(kāi)文件分塊共享對(duì)象時(shí)，系統(tǒng)先檢查指定的本地存儲(chǔ)路徑下是否存在該文件。與順序傳輸模式相反，分散傳輸模式盡力避免按照從前到后的順序傳輸數(shù)據(jù)塊。這種模式的用途是傳輸媒體流文件，按照從前到后的順序獲取數(shù)據(jù)塊有利于媒體流文件一邊下載一邊播放。使用該模式時(shí)，系統(tǒng)優(yōu)先按照從前到后的順序獲取數(shù)據(jù)塊。這里的圖片文件必須是“.png”文件。4) 保存和載入文件調(diào)用 PG_METH_BOARD_Save方法把當(dāng)前白板的內(nèi)容保存到指定的圖片文件。3) 實(shí)現(xiàn)橡皮功能白板共享類沒(méi)有專門的橡皮功能，但可以用繪制線條的方法來(lái)實(shí)現(xiàn)橡皮。在一個(gè)節(jié)點(diǎn)上繪圖時(shí)，通信組內(nèi)的其他節(jié)點(diǎn)上會(huì)實(shí)時(shí)顯示。請(qǐng)參考“音頻錄制”章節(jié)。如果調(diào)用時(shí)指定Path參數(shù)為空，則停止當(dāng)前正在進(jìn)行的錄制操作。Path參數(shù)指定保存照片的文件路徑，照片文件必須是“.jpg”文件。如果改變了窗口的句柄，則把視頻轉(zhuǎn)移到另一個(gè)窗口中顯示。4) 視頻窗口調(diào)整和轉(zhuǎn)移調(diào)用PG_METH_VIDEO_Move方法可以調(diào)整視頻在窗口中顯示的位置和尺寸，或者從當(dāng)前的窗口轉(zhuǎn)移到另一個(gè)窗口中。調(diào)用PG_METH_VIDEO_Open打開(kāi)視頻會(huì)議后，缺省沒(méi)有視頻通話加進(jìn)來(lái)，需要PG_METH_VIDEO_Join和PG_METH_VIDEO_Leave使視頻加入或離開(kāi)。所以，為了使通信范圍更加準(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)。發(fā)起端調(diào)用PG_METH_VIDEO_Open方法發(fā)起呼叫請(qǐng)求，對(duì)端接收到呼叫請(qǐng)求后，通過(guò)返回應(yīng)答的錯(cuò)誤碼來(lái)確認(rèn)接受或拒絕，錯(cuò)誤碼等于0表示接受，錯(cuò)誤碼大于0表示拒絕及其原因。兩點(diǎn)模式允許經(jīng)過(guò)呼叫協(xié)商之后才建立通話。預(yù)覽模式用PG_ADD_VIDEO_Preview選項(xiàng)開(kāi)啟，用來(lái)顯示從本地視頻捕捉設(shè)備上輸入的視頻圖像。請(qǐng)參考“視頻錄制”章節(jié)。如果調(diào)用時(shí)指定Path參數(shù)為空，則停止當(dāng)前正在進(jìn)行的錄制操作。應(yīng)用程序可以依此在圖像界面上顯示輸入/輸出音量的變化。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)的音量。會(huì)議模式下可以調(diào)用PG_METH_AUDIO_Speech方法來(lái)控制指定節(jié)點(diǎn)的發(fā)言狀態(tài)。2) 會(huì)議模式及發(fā)言控制通過(guò)PG_ADD_AUDIO_Conference選項(xiàng)開(kāi)啟會(huì)議模式。兩點(diǎn)模式時(shí)，如果音頻傳輸