到新公司上班,接收的第一个项目是视频会议系统,基于AnyChat进行二次开发,在官网下载了demo了解后,发现缺少了一个发送文件功能,所以自己在原有的demo进行修改,增加了一个发送文件功能。

AnyChat具有缓冲区及文件传输功能,文件传输API接口:BRAC_TransFileAB两用户登录服务器成功之后,便可使用文件传输API接口传送文件,当A使用API接口:BRAC_TransFileB发送文件时,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 SDKhttp://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开发手册》