【正文】 制到同一個AVI文件中，則在開始錄制音頻和視頻時，都給Path參數(shù)指定同一個AVI文件。請參考“視頻錄制”章節(jié)。7. 使用視頻傳輸類(PG_CLASS_Video)1) 預(yù)覽模式視頻傳輸類有三種模式：預(yù)覽模式、兩點模式和會議模式。預(yù)覽模式用PG_ADD_VIDEO_Preview選項開啟，用來顯示從本地視頻捕捉設(shè)備上輸入的視頻圖像。2) 兩點模式缺省為兩點模式。兩點模式允許經(jīng)過呼叫協(xié)商之后才建立通話。一端發(fā)起請求之后，另一端可以選擇接受或拒絕，只有對端選擇接受后通話才建立。發(fā)起端調(diào)用PG_METH_VIDEO_Open方法發(fā)起呼叫請求，對端接收到呼叫請求后，通過返回應(yīng)答的錯誤碼來確認(rèn)接受或拒絕，錯誤碼等于0表示接受，錯誤碼大于0表示拒絕及其原因。兩點模式時，如果視頻傳輸對象關(guān)聯(lián)的通信組對象有多個成員，則系統(tǒng)選擇第1個成員作為對端節(jié)點。所以，為了使通信范圍更加準(zhǔn)確，建議視頻傳輸對象關(guān)聯(lián)節(jié)點對象作為對端節(jié)點，或者關(guān)聯(lián)的通信組對象始終保持只有1個成員作為對端節(jié)點。3) 會議模式及視頻的加入和離開會議模式用PG_ADD_VIDEO_Conference選項開啟。調(diào)用PG_METH_VIDEO_Open打開視頻會議后，缺省沒有視頻通話加進來，需要PG_METH_VIDEO_Join和PG_METH_VIDEO_Leave使視頻加入或離開。視頻加入需要經(jīng)過呼叫協(xié)商，對端選擇接受之后，視頻才能加入到會議中。4) 視頻窗口調(diào)整和轉(zhuǎn)移調(diào)用PG_METH_VIDEO_Move方法可以調(diào)整視頻在窗口中顯示的位置和尺寸，或者從當(dāng)前的窗口轉(zhuǎn)移到另一個窗口中。調(diào)用此方法時，如果只是改變了參數(shù)中的坐標(biāo)參數(shù)，則調(diào)整視頻在窗口中的顯示位置和尺寸。如果改變了窗口的句柄，則把視頻轉(zhuǎn)移到另一個窗口中顯示。5) 拍照片調(diào)用PG_METH_VIDEO_Camera方法對輸出的視頻拍照片。Path參數(shù)指定保存照片的文件路徑，照片文件必須是“.jpg”文件。6) 視頻錄制調(diào)用PG_METH_VIDEO_Record方法可將視頻輸出錄制到由Path參數(shù)指定的AVI文件中。如果調(diào)用時指定Path參數(shù)為空，則停止當(dāng)前正在進行的錄制操作。如果想將視頻和音頻錄制到同一個AVI文件中，則在開始錄制視頻和音頻時，都給Path參數(shù)指定同一個AVI文件。請參考“音頻錄制”章節(jié)。8. 使用白板共享類(PG_CLASS_Board)1) 設(shè)置繪制圖形的參數(shù)調(diào)用PG_METH_BOARD_Shape方法可設(shè)置繪圖的參數(shù)，包括圖案類型、線條寬度、線條顏色和線條樣式。在一個節(jié)點上繪圖時，通信組內(nèi)的其他節(jié)點上會實時顯示。2) 設(shè)置繪制不同圖形時的鼠標(biāo)光標(biāo)調(diào)用PG_METH_BOARD_Cursor方法可設(shè)置圖案類型下的鼠標(biāo)光標(biāo)，讓用戶可以直觀地知道當(dāng)前的繪圖狀態(tài)。3) 實現(xiàn)橡皮功能白板共享類沒有專門的橡皮功能，但可以用繪制線條的方法來實現(xiàn)橡皮。設(shè)置線條的顏色與背景顏色相同、設(shè)置較寬的線條寬度、設(shè)置橡皮形狀的鼠標(biāo)光標(biāo)，繪制這樣的線條時就等同于橡皮的效果。4) 保存和載入文件調(diào)用 PG_METH_BOARD_Save方法把當(dāng)前白板的內(nèi)容保存到指定的圖片文件。調(diào)用PG_METH_BOARD_Load方法把指定圖片文件的內(nèi)容裝入到白板中。這里的圖片文件必須是“.png”文件。9. 使用文件分塊共享類(PG_CLASS_Share)1) 順序傳輸模式順序傳輸模式是缺省的傳輸模式。使用該模式時，系統(tǒng)優(yōu)先按照從前到后的順序獲取數(shù)據(jù)塊。只有當(dāng)某個數(shù)據(jù)塊還沒有源時，才跳到后面獲取已經(jīng)有源的數(shù)據(jù)塊。這種模式的用途是傳輸媒體流文件，按照從前到后的順序獲取數(shù)據(jù)塊有利于媒體流文件一邊下載一邊播放。2) 分散傳輸模式分散傳輸模式用PG_ADD_SHARE_Distribute選項開啟。與順序傳輸模式相反，分散傳輸模式盡力避免按照從前到后的順序傳輸數(shù)據(jù)塊。這種模式的用途是盡量保持參與共享的節(jié)點以相同的進度獲取文件，避免某些節(jié)點過早傳輸完成后就關(guān)閉了共享。3) 文件的存儲和種子調(diào)用PG_METH_SHARE_Open 方法打開文件分塊共享對象時，系統(tǒng)先檢查指定的本地存儲路徑下是否存在該文件。如果文件不存在，則系統(tǒng)創(chuàng)建兩個文件分別用來存儲文件數(shù)據(jù)塊和傳輸?shù)臓顟B(tài)。這兩個文件的文件名分別為共享文件名加上后綴“.pgshs”和“.pgshi”。文件傳輸完成后系統(tǒng)把“.pgshi”文件刪除，把“.pgshs”重命名為共享文件名。例如，假設(shè)共享的文件名為“”，則系統(tǒng)創(chuàng)建的兩個文件名分別為“”和“”，傳輸完成后系統(tǒng)把“”刪除，把“”重命名為“”。某個節(jié)點獲取到所有的文件數(shù)據(jù)塊后，作為種子給其他節(jié)點繼續(xù)共享文件。4) 轉(zhuǎn)發(fā)到本地HTTP服務(wù)器控件提供了本地HTTP服務(wù)器功能，可以在節(jié)點本地的私網(wǎng)地址或環(huán)回地址上啟動一個HTTP服務(wù)器，允許HTTP客戶端在本地通過HTTP方式訪問Peergine的內(nèi)容。文件分塊共享類能夠把正在傳輸?shù)奈募?shù)據(jù)實時轉(zhuǎn)發(fā)到本地HTTP服務(wù)器上，提供給HTTP客戶端訪問。使用HttpConfig命令啟動本地HTTP服務(wù)器，請參考“控件的命令列表”章節(jié)。調(diào)用PG_METH_SHARE_Open方法打開文件分塊共享對象時，如果指定了HttpURL參數(shù)，則該文件分塊共享對象在本地HTTP服務(wù)器上建立一個轉(zhuǎn)發(fā)關(guān)聯(lián)。當(dāng)獲取到數(shù)據(jù)塊時，會實時轉(zhuǎn)發(fā)到本地HTTP服務(wù)器上。HTTP客戶端可以使用HttpURL參數(shù)指定的URL從HTTP服務(wù)器下載共享文件。這個功能的用途是方便實現(xiàn)媒體流文件的一邊下載一邊播放。使用順序傳輸模式獲取媒體流文件并實時轉(zhuǎn)發(fā)到本地HTTP服務(wù)器上，然后使用具有網(wǎng)絡(luò)播放功能的播放器播放該媒體流文件的URL。10. 使用數(shù)據(jù)表傳輸類(PG_CLASS_Table)1) 數(shù)據(jù)表傳輸數(shù)據(jù)表傳輸類以類似操作數(shù)據(jù)庫的方式，在多點之間傳輸數(shù)據(jù)。一個數(shù)據(jù)表傳輸對象對應(yīng)一個數(shù)據(jù)表，數(shù)據(jù)表內(nèi)的數(shù)據(jù)以記錄、字段的方式存儲。在一個節(jié)點上調(diào)用PG_METH_TABLE_Insert、PG_METH_TABLE_Update和PG_METH_TABLE_Delete方法對數(shù)據(jù)表記錄進行插入、修改和刪除時，數(shù)據(jù)所作的變更會實時地同步到通信組內(nèi)的其他節(jié)點。調(diào)用PG_METH_TABLE_Query方法查詢或同步到來自其他節(jié)點的數(shù)據(jù)變更時，系統(tǒng)調(diào)用PG_METH_TABLE_Report方法上報給應(yīng)用程序。2) 文件傳輸模式文件傳輸模式是數(shù)據(jù)表傳輸類的增強功能，用PG_ADD_TABLE_File選項開啟。開啟文件傳輸模式后，數(shù)據(jù)表的一條記錄存儲一個文件的屬性信息，包括URL、路徑、長度、修改時間、摘要和傳輸狀態(tài)。數(shù)據(jù)表同步文件屬性信息的同時，也把文件內(nèi)容也同步到通信組內(nèi)的其他節(jié)點。請參考“說明：文件傳輸模式”章節(jié)。3) 強制同步傳輸如果數(shù)據(jù)表中某些記錄已經(jīng)沒有源（添加這些記錄的節(jié)點已經(jīng)不在通信組里了），則數(shù)據(jù)表的同步操作就會停止在這些記錄上，不能再繼續(xù)傳輸數(shù)據(jù)，這種情況稱為記錄空洞(Hole)。調(diào)用PG_METH_TABLE_Sync方法可以跳過這些沒有源的記錄繼續(xù)同步后面有源的記錄。11. 使用媒體流直播類(PG_CLASS_Live)1) 媒體流的播放和收看媒體流直播類支持三種媒體流類型：實時捕捉的音頻流、實時捕捉的視頻流和播放AVI文件影音流。在直播通信組中只能由一個節(jié)點作為源節(jié)點播放媒體流，其他節(jié)點都是收看節(jié)點。如果通信組內(nèi)存在2個以上的源節(jié)點，則會導(dǎo)致直播狀態(tài)混亂。調(diào)用PG_METH_LIVE_Open方法打開媒體流直播對象后，還需要調(diào)用PG_METH_LIVE_Ctrl方法執(zhí)行PG_LIVE_CTRL_Play動作，才能開始播放或收看媒體流。在收看節(jié)點上，媒體流要經(jīng)過一段時間的緩沖后才輸出。2) 媒體源的切換媒體流直播過程中有時需要切換到新的媒體源，恰當(dāng)?shù)牟僮髂苁骨袚Q過程平滑，產(chǎn)生的停頓較短。切換媒體源有2種情況：(1) 在同一個節(jié)點上切換不同的媒體流，例如播放另外一個AVI文件。這種情況時，應(yīng)先調(diào)用PG_METH_LIVE_Close方法關(guān)閉原來的媒體流，再調(diào)用PG_METH_LIVE_Open方法打開新的媒體流，然后執(zhí)行PG_LIVE_CTRL_Play動作開始播放。(2) 在不同的節(jié)點上切換不同的媒體流，例如切換到另外一個節(jié)點的實時捕捉視頻流。這樣情況時，可先在新的源節(jié)點上調(diào)用PG_METH_LIVE_Open打開媒體流，但不要執(zhí)行PG_LIVE_CTRL_Play動作。待老的源節(jié)點上調(diào)用PG_METH_LIVE_Close方法關(guān)閉原來的媒體流后，新的源節(jié)點上立即執(zhí)行PG_LIVE_CTRL_Play動作開始播放。不管是哪種情況，切換前和切換后的媒體流類型和媒體流格式必須一致，否則收看節(jié)點將不接受新的媒體流。3) 媒體流錄制在收看節(jié)點上調(diào)用PG_METH_LIVE_Record方法可以把媒體流錄制到 Path參數(shù)指定的AVI文件中。如果調(diào)用時指定Path參數(shù)為空，則停止當(dāng)前正在進行的錄制操作。請參考“音頻錄制”和“視頻錄制”章節(jié)。pgATX控件的編程參考：1. 控件的屬性配置項:1) Control描述：指定使能pgATX控件的哪些功能。在缺省情況下，可以使用“控件的OML解析器函數(shù)”和“控件的輔助函數(shù)”。參數(shù)：Type：用bit位或操作組合多個值可以同時使能多種功能?？丶壳爸С忠韵鹿δ埽?：使能對等通信節(jié)點功能。使能對等通信節(jié)點功能后“控件的節(jié)點功能函數(shù)”才能生效。Update：是否啟用在線升級。0為禁用，1為啟用。缺省為啟用。示例(JavaScript)：// 使能控件的Node功能 = “Type=1”。2) Node描述：配置節(jié)點的性能參數(shù)。參數(shù)：Type：節(jié)點類型。0為普通節(jié)點，1為登錄服務(wù)器節(jié)點Cert：證書文件的路徑。作為登錄服務(wù)器時必須指定此參數(shù)（請從本軟件作者處獲取證書）MaxPeer：節(jié)點對象的最大數(shù)目，取值范圍：1 ~ 32768MaxGroup：組對象的最大數(shù)目，取值范圍：1 ~ 32768MaxObject：對象的最大數(shù)目，取值范圍：1 ~ 65534MaxMCast：組播句柄的最大數(shù)目，取值范圍：1 ~ 65534MaxHandle：常駐接口事件隊列的最大長度，取值范圍：1 ~ 65534MaxNotify：常駐內(nèi)部事件隊列的最大長度，取值范圍：1 ~ 65534SKTBufSize0：消息流的Socket隊列長度（報文個數(shù)），取值范圍：1 ~ 1024SKTBufSize1：音頻流的Socket隊列長度（報文個數(shù)），取值范圍：1 ~ 1024SKTBufSize2：視頻流的Socket隊列長度（報文個數(shù)），取值范圍：1 ~ 1024SKTBufSize3：文件流的Socket隊列長度（報文個數(shù)），取值范圍：1 ~ 1024SocketMode：節(jié)點的Socket模式（同節(jié)點類型Type）ParamMode：節(jié)點函數(shù)接口的參數(shù)模式。0為二進制（在C/C++編程中使用），1為OML格式，2為JSON格式（未支持）示例(JavaScript)：// 指定該節(jié)點為服務(wù)器和最大的對象數(shù)目。如果不指定某個參數(shù)的值，則使用系統(tǒng)的缺省值。 = “Type=1。MaxObject=256”。3) Local描述：配置節(jié)點的本地參數(shù)。參數(shù)：Name: 本地Peer對象的名稱。如果該節(jié)點為普通節(jié)點，則不要指定本地Peer對象的名稱。Addr: 本地節(jié)點的網(wǎng)絡(luò)地址。作為普通節(jié)點時，即使指定了本地地址，系統(tǒng)依然會根據(jù)服務(wù)器的地址選擇合適的本地地址使用。只有無法根據(jù)服務(wù)器地址選擇本地地址時，才會使用指定的本地地址。示例(JavaScript)：// 指定服務(wù)器節(jié)點的名稱為“Server”，地址為“0:0:0::3000:0” = “Name=Server。Addr=0:0:0::3000:0”。 4) Server描述：配置節(jié)點的服務(wù)器參數(shù)。參數(shù)：Name: 服務(wù)器Peer對象的名稱。如果該節(jié)點為服務(wù)器，則不要指定服務(wù)器Peer對象的名稱。也就是說只有作為客戶端的時候才需要指定服務(wù)器Peer對象的名稱。Addr: 服務(wù)器節(jié)點的網(wǎng)絡(luò)地址Digest: 是否以摘要的方式發(fā)送登錄密碼。0為明文方式，1為摘要方式。如果啟用摘要方式，則需要調(diào)用PG_METH_PEER_DigVerify方法對密碼進行驗證。示例(JavaScript)：// 指定服務(wù)器節(jié)點的名稱為“Server”，地址為“0:0:0::3000:0”，以摘要方式發(fā)送密碼 = “Name=Server。Addr=0:0:0::3000:0。Digest=1”。 5) Relay描述：配置中繼服務(wù)的器的隧道參數(shù)，可以同時指定多個隧道。節(jié)點會自動選擇可用的隧道。參考“配置和運行中繼服務(wù)器”章節(jié)參數(shù)：Type：中繼轉(zhuǎn)發(fā)的隧道協(xié)議類型。0為TCP隧道，1為HTTP隧道，2為WebSocket隧道（未支持）Load：中繼服務(wù)器的負(fù)荷Addr：中繼服務(wù)器的偵聽地址示例(JavaScript)：// 指定2個隧道參數(shù)。第1個為HTTP隧道/IPV6地址，第2個為TCP隧道/IPV4地址。 = “(Relay0){(Type){1}(Load){0}(Addr){FE800000:0:01B05996:42CFB70D:80:0}} (Relay1){(Type){0}(Load){0}(Addr){0:0:0::443:0}}”。 6) Class描述：指定使能的Peergine 功能類以及每種類的最大實例數(shù)。本配置項的格式為“類名稱:類的最大實例數(shù)”，可以同時配置多個類，用分號“?！备糸_。注：PG_CLASS_Peer 和PG_CLASS_Group類是系統(tǒng)的內(nèi)建類，由系統(tǒng)在控件初始化時默認(rèn)使能。參數(shù)：PG_CLASS_Data：消息傳輸類PG_CLASS_File：文