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