Android移動端音視頻的快速開發教程（九）

接 Android移動端音視頻的快速開發教程（八）

4.6.
私聊函數
4.6.1.
更改當前的聊天模式
INT ChangeChatMode(INT ChatMode);
功能：更改本身的聊天模式（默認爲公聊模式）
返回值：0表示成功，不然爲出錯代碼
參數：
dwChatMod： 聊天模式，定義爲：
GV_CHATMODE_PUBLIC 0 公聊模式
GV_CHATMODE_PRIVATE 1 私聊模式
備註：
不一樣的聊天模式下對語音視頻數據的發送方式採起了不一樣的策略，公聊模式下能夠接收全部的視頻和語音信息，而私聊模式下只接收與本身私聊的用戶的語音和視頻數據，在私聊模式下，本身的語音視頻數據也只向私聊對象傳送。
該方法必須在進入房間成功以後調用方纔有效，在私聊模式下，接收不到其它用戶的語音和視頻數據，僅能接收到本身私聊對象的語音和視頻數據，文字消息不受模式影響，關於私聊模式與公聊模式之間的關係，請參考「關於私聊的實現思路」 部分。
第 41 頁 共 51 頁
AnyChat for Android SDK 開發手冊 佰銳科技 版權全部
4.6.2.
獲取指定用戶聊天模式
INT GetUserChatMode(INT Userid, INT& dwChatMode);
功能：獲取指定用戶當前的聊天模式。
返回值：0表示成功，不然爲出錯代碼
參數：
dwUserid： 用戶ID號，-1表示獲取本身的聊天模式；
dwChatMod： 聊天模式
備註：
該方法必須在進入房間成功以後調用方纔有效。
4.6.3.
請求與對方私聊
INT PrivateChatRequest(INT Userid);
功能：請求與對方私聊，向對方發起私聊請求。
返回值：0表示成功，不然爲出錯代碼
參數：
dwUserid： 對方的用戶ID號
備註：
該方法必須在進入房間成功以後調用方纔有效。若是對方接受請求，則系統將會自動切換到私聊模式，調用該方法後，對方將會收到消息：WM_GV_PRIVATEREQUEST。
4.6.4.
回覆對方的私聊請求
INT PrivateChatEcho(INT Userid, INT Requestid, BOOLEAN bAccept);
功能：回覆對方的私聊請求。
返回值：0表示成功，不然爲出錯代碼
參數：
第 42 頁 共 51 頁
AnyChat for Android SDK 開發手冊 佰銳科技 版權全部
dwUserid： 對方的用戶ID號
dwRequestid： 請求ID號，在請求消息中傳過來，標示是哪個請求
bAccept： 是否贊成對方的私聊請求
備註：
該方法必須在進入房間成功以後調用方纔有效。當收到其它用戶的私聊請求時，能夠調用該方法贊成，或是拒絕對方的請求，調用該方法後，對方將會收到消息：WM_GV_PRIVATEECHO。
4.6.5.
回覆對方的私聊請求（擴展）
INT PrivateChatEchoEx(INT Userid, INT Requestid, INT ErrorCode);
功能：回覆對方的私聊請求。
返回值：0表示成功，不然爲出錯代碼
參數：
dwUserid： 對方的用戶ID號
dwRequestid： 請求ID號，在請求消息中傳過來，標示是哪個請求
dwErrorCode： 是否贊成對方的私聊請求(errorcode=GV_ERR_SUCCESS表示贊成與對方私聊，不然表示拒絕與對方私聊)
備註：
該方法與「PrivateChatEcho」功能相同，可是該方法能夠讓上層傳入相應的出錯代碼，指示拒絕的緣由，便於上層擴展，傳入的errorcode將會附帶在對方收到的WM_GV_PRIVATEECHO消息中。
4.6.6.
退出與某用戶的私聊
INT PrivateChatExit(INT Userid);
功能：退出與某用戶的私聊，或者將某用戶從本身的私聊列表中清除。
返回值：0表示成功，不然爲出錯代碼
參數：
第 43 頁 共 51 頁
AnyChat for Android SDK 開發手冊 佰銳科技 版權全部
dwUserid： 對方的用戶ID號
備註：
該方法必須在進入房間成功以後調用方纔有效。由於同時能夠和多個用戶之間進行私聊，因此斷開與該用戶的私聊鏈接後，不影響與其它用戶的私聊，調用該方法後，本身和對方都將會收到消息：WM_GV_PRIVATEEXIT