到新公司上班,接收的第一个项目是视频会议系统,基于AnyChat进行二次开发,在官网下载了demo了解后,发现缺少了一个发送文件功能,所以自己在原有的demo进行修改,增加了一个发送文件功能。
AnyChat具有缓冲区及文件传输功能,文件传输API接口:BRAC_TransFile,A、B两用户登录服务器成功之后,便可使用文件传输API接口传送文件,当A使用API接口:BRAC_TransFile向B发送文件时,B收到文件后,将触发B的回调函数:文件传输回调函数。
传送文件接口说明:
int TransFile(int userid, String filepath, int wparam, int lparam,int flags, AnyChatOutParam outParam);
功能:传送文件给指定用户
返回值:0表示函数调用成功,否则为出错代码
参数:
userid: 目标用户编号,只针对某一个用户,不能为-1(所有人)
filepath: 本地文件名,含路径
wParam: 附带参数1,便于上层应用扩展
lParam: 附带参数2
dwFlags: 特殊功能标志,参考:“TransBufferEx”方法
outParam: 若函数调用成功,则内核通过该参数输出任务ID
在使用中,附带参数以及特殊功能标识是保留参数,不需要用到,赋值为0就可以了。一开始在设置outParam参数时设置为null,程序发生异常,查阅官方文档后发现,当函数调用成功,内核会通过outParam的SetIntValue方法设置任务ID(TaskId)。
B用户要实现接收文件传输回调函数需要做两个工作。
1、在需要接收的类实现AnyChatTransDataEvent接口
2、设置回调接收函数SetTransDataEvent
(注:AnyChatTransDataEvent和SetTransDataEvent是由AnyChat提供的api)
文件传输回调函数说明:
public void OnAnyChatTransFile(int dwUserid, String FileName,String TempFilePath, int dwFileLength, int wParam, int lParam, int dwTaskId);
参数:
dwUserid: 用户ID,指示发送用户
FileName: 文件名(含扩展名,不含路径)
TempFilePath: 接收完成后,SDK保存在本地的临时文件(包含完整路径)
dwFileLength: 文件总长度
wParam:
lParam:
dwTaskId: 该文件所对应的任务编号
主要代码如下,注释的也比较清楚。详细的可参考《AnyChat for Android SDK开发手册》。(AnyChat for Android SDK:http://www.anychat.cn/download.html)
RoomActivity.java
在传输过程中还可以通过QueryTransTaskInfo接口查询传输任务相关信息,需要传人用户id以及任务id等参数。
查询传输任务相关信息接口说明:
INT QueryTransTaskInfo(INT Userid, INT TaskId,int infoname, AnyChatOutParam outParam);
功能:查询与传输任务相关的信息,如传输进度、传输状态、传输码率等
返回值:0表示查询成功,否则为出错代码
参数:
dwUserid:任务发起者用户编号(并非传输目标用户编号)
dwTaskId:需要查询的任务编号
infoname 需要查询的信息代码(见备注附表)
outParam:若函数调用成功,则内核通过该参数输出查询结果
anychat.QueryTransTaskInfo(dwUserId,taskId,AnyChatDefine.BRAC_TRANSTASK_STATUS, outParam);
AnyChatDefine.BRAC_TRANSTASK_STATUS是一个常量值为3,用于查询任务当前状态,通过outParam.GetIntValue()取得任务状态值,2为传输状态,3为完成状态,
详细的可参考《AnyChat for Android SDK开发手册》