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

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

3.3.
數據傳輸事件接口
3.3.1.
接口定義
package com.bairuitech.anychat;
// 數據傳輸通知接口
public interface AnyChatTransDataEvent {
public void OnAnyChatTransFile(int dwUserid, String FileName, String TempFilePath, int dwFileLength, int wParam, int lParam, int dwTaskId); 第 18 頁 共 51 頁
AnyChat for Android SDK 開發手冊 佰銳科技 版權全部
public void OnAnyChatTransBuffer(int dwUserid, byte[] lpBuf, int dwLen);
public void OnAnyChatTransBufferEx(int dwUserid, byte[] lpBuf, int dwLen, int wparam, int lparam, int taskid);
public void OnAnyChatSDKFilterData(byte[] lpBuf, int dwLen);
}
3.3.2.
收到文件傳輸數據事件
public void OnAnyChatTransFile(int dwUserid, String FileName, String TempFilePath, int dwFileLength, int wParam, int lParam, int dwTaskId);
參數：
dwUserid： 用戶ID，指示發送用戶
FileName： 文件名（含擴展名，不含路徑）
TempFilePath： 接收完成後，SDK保存在本地的臨時文件（包含完整路徑）
dwFileLength： 文件總長度
wParam： 附帶參數1
lParam： 附帶參數2
dwTaskId： 該文件所對應的任務編號
說明：
當收到其它用戶使用「TransFile」方法發送的文件時，將會觸發該接口，等同於回調函數：BRAC_TransFile_CallBack。
特別提示：本SDK不會刪除「lpTempFilePath」所指示的臨時文件，上層應用在處理完畢後，須要主動刪除該臨時文件。
3.3.3.
收到透明通道數據事件
public void OnAnyChatTransBuffer(int dwUserid, byte[] lpBuf, int dwLen);
參數：
dwUserid： 用戶ID，指示發送用戶
lpBuf： 緩衝區地址
dwLen： 緩衝區大小
說明：
第 19 頁 共 51 頁
AnyChat for Android SDK 開發手冊 佰銳科技 版權全部
當收到其它用戶使用「TransBuffer」」方法發送的緩衝區數據時，將會觸發該接口，等同於回調函數：BRAC_TransBuffer_CallBack。
因爲該函數傳遞的數據是一個與本SDK無關的緩衝區（由上層應用本身填充內容），相對於本SDK來講是透明的，故稱爲透明通道，利用該通道，能夠向當前房間內的任何用戶傳輸上層應用自定義的數據。
3.3.4.
收到擴展透明通道數據事件
public void OnAnyChatTransBufferEx(int dwUserid, byte[] lpBuf, int dwLen, int wparam, int lparam, int taskid);
參數：
dwUserid： 用戶ID，指示發送用戶
lpBuf： 緩衝區地址
dwLen： 緩衝區大小
wParam： 緩衝區附帶參數（由發送者設置，上層應用可自定義用途）
lParam： 緩衝區附帶參數2
dwTaskId： 該緩衝區所對應的傳輸任務編號
說明：
當收到其它用戶使用「TransBufferEx」方法發送的緩衝區數據時，將會觸發該接口，等同於回調函數：BRAC_TransBufferEx_CallBack。
3.3.5.
收到SDK Filter數據事件
public void OnAnyChatSDKFilterData(byte[] lpBuf, int dwLen);
參數：
lpBuf： 緩衝區地址
dwLen： 緩衝區大小
說明：
當收到服務器「SDK Filter」或是「Server SDK」相關接口發送的緩衝區數據時，將會觸發該接口，等同於回調函數：BRAC_SDKFilterData_CallBack。

3.4. 文字消息事件接口 3.4.1. 接口定義 package com.bairuitech.anychat; // 文字聊天通知接口 public interface AnyChatTextMsgEvent { public void OnAnyChatTextMessage(int dwFromUserid, int dwToUserid, int bSecret, String message); } 3.4.2. 收到文字聊天消息事件 public void OnAnyChatTextMessage(int dwFromUserid, int dwToUserid, boolean bSecret, String message); 參數： dwFromUserid 消息發送者用戶ID dwToUserid 目標用戶，-1表示發送給你們，即房間全部人 bSecret 是否爲悄悄話，當目標用戶不爲-1時有效 message 消息字符串 說明：當進入房間成功以後，收到其餘用戶發送的文字聊天信息時將觸發該接口，等同於WIN32平臺的回調函數：BRAC_TextMessage_CallBack。本地用戶向其它用戶發送文字消息時，將不會觸發該接口。 3.5. 私聊控制事件接口 3.5.1. 接口定義 package com.bairuitech.anychat; // AnyChat私聊消息通知接口 public interface AnyChatPrivateChatEvent { public void OnAnyChatPrivateRequestMessage(int dwUserId, int dwRequestId); 第 21 頁 共 51 頁 AnyChat for Android SDK 開發手冊 佰銳科技 版權全部 public void OnAnyChatPrivateEchoMessage(int dwUserId, int dwErrorCode); public void OnAnyChatPrivateExitMessage(int dwUserId, int dwErrorCode); } 3.5.2. 用戶私聊請求事件 public void OnAnyChatPrivateRequestMessage(int dwUserId, int dwRequestId) 參數： dwUserId 表示發起者的用戶ID號，私聊請求者 dwRequestId 表示私聊請求編號，標識該請求 說明：當進入房間成功以後，當用戶發起私聊請求時，在被請求者端將觸發該接口，等同於WIN32平臺的WM_GV_PRIVATEREQUEST消息。 3.5.3. 用戶私聊回覆事件 public void OnAnyChatPrivateEchoMessage(int dwUserId, int dwErrorCode) 參數： dwUserId 表示回覆者的用戶ID號 dwErrorCode 返回代碼，表示對方是否贊成本身的邀請 說明：當進入房間成功以後，當用戶發起私聊請求時，其它用戶回覆該請求時將觸發該接口，等同於WIN32平臺的WM_GV_PRIVATEECHO消息。 3.5.4. 用戶私聊退出事件 public void OnAnyChatPrivateExitMessage(int dwUserId, int dwErrorCode) 參數： dwUserId 表示退出者的用戶ID號 dwErrorCode 返回代碼，表示退出私聊的緣由 說明：當進入房間成功以後，在本身私聊列表中的用戶退出，或網絡鏈接斷開時將觸發該接口，等同於WIN32平臺的WM_GV_PRIVATEEXIT消息。