接 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消息。