接口名称 | 功能说明 |
---|---|
XL_Init | 初始化SDK,并使其为处理后续操作做好准备。 |
XL_UnInit | 反初始化SDK,释放模块运行期间申请的资源。 |
XL_DelTempFile | 删除临时文件 |
XL_SetSpeedLimit | 设置最大下载速度 |
XL_SetProxy | 设置全局代理 |
XL_SetUserAgent | 设置HTTP请求时客户端信息 |
XL_ParseThunderPrivateUrl | 将迅雷专用链转成实际URL |
XL_SetUploadSpeedLimit | 限制上传速度 |
XL_CreateTaskByURL | 简单封装了XL_CreateTask接口 |
XL_CreateTaskByThunder | 拉起迅雷7创建下载任务 |
XL_ForceStopTask | 强制暂停任务 |
接口名称 | 功能说明 |
---|---|
XL_CreateTask | 创建任务 |
XL_DeleteTask | 销毁任务 |
XL_StartTask | 开始任务 |
XL_StopTask | 停止任务 |
XL_QueryTaskInfoEx | 查询任务信息 |
参数: [in] stParam,创建任务需要的参数。
DownTaskParam参考:
struct DownTaskParam
{
int nReserved1;
TCHAR szTaskUrl[2084]; // 任务URL,支持http,https,ftp,ftps格式
TCHAR szRefUrl[2084]; // 可空,HTTP下载所在的网页URL
TCHAR szCookies[4096]; // 可空,浏览器cookie
TCHAR szFilename[MAX_PATH]; // 下载保存文件名.
TCHAR szReserved[MAX_PATH];
TCHAR szSavePath[MAX_PATH]; // 文件保存目录
HWND hReserved;
BOOL bReserved1;
TCHAR szReserved1[64];
TCHAR szReserved2[64];
BOOL IsOnlyOriginal; //是否只从原始地址下载
UINT nReserved2;
BOOL bReserved2;
BOOL IsResume; // 是否用续传
DWORD reserved[2048];
}
*返回值:*返回任务的句柄。
*说明:*任务创建后,是不会马上就下载的,需要调用XL_StartTask。异步执行。
参数: [in]hTask,任务句柄 [out] stTaskInfo, 任务信息。
DownTaskInfo参考:
struct DownTaskInfo
{
DOWN_TASK_STATUS stat; //任务状态
TASK_ERROR_TYPE fail_code; //错误码
TCHAR szFilename[MAX_PATH]; //文件名
TCHAR szReserved[MAX_PATH];
__int64 nTotalSize; // 该任务总大小(字节)
__int64 nTotalDownload; // 下载有效字节数(可能存在回退的情况)
float fPercent; // 下载进度
int nTotalTime; // 不提供该值
int nSrcTotal; // 总资源数
int nSrcUsing; // 可用资源数
int nReserved1;
int nReserved2;
int nReserved3;
int nReserved;
__int64 nTotalUpload; // 现不提供该值
__int64 nDonationP2P; // p2p资源贡献的数据长度
__int64 nReserved4;
__int64 nDonationOrgin; // 原始资源贡献的数据长度
__int64 nDonationP2S; // 镜像资源贡献的数据长度
__int64 nReserved5;
__int64 nReserved6;
int nSpeed; // 速度(字节/秒)
int nSpeedP2S; // 加速服务器资源的下载速度
int nSpeedP2P; // peer下载速度
bool IsOriginUsable; // 原始资源是否可用
float fReserved;
int bReserved;
DWORD reserved[64];
};
enum DOWN_TASK_STATUS
{
NOITEM = 0,
TSC_ERROR,
TSC_PAUSE,
TSC_DOWNLOAD,
TSC_COMPLETE,
TSC_STARTPENDING,
TSC_STOPPENDING
};
enum TASK_ERROR_TYPE
{
TASK_ERROR_UNKNOWN = 0x00, // 未知错误
TASK_ERROR_DISK_CREATE = 0x01, // 创建文件失败
TASK_ERROR_DISK_WRITE = 0x02, // 写文件失败
TASK_ERROR_DISK_READ = 0x03, // 读文件失败
TASK_ERROR_DISK_RENAME = 0x04, // 重命名失败
TASK_ERROR_DISK_PIECEHASH = 0x05, // 文件片校验失败
TASK_ERROR_DISK_FILEHASH = 0x06, // 文件全文校验失败
TASK_ERROR_DISK_DELETE = 0x07, // 删除文件失败失败
TASK_ERROR_DOWN_INVALID = 0x10, // 无效的DOWN地址
TASK_ERROR_PROXY_AUTH_TYPE_UNKOWN = 0x20, // 代理类型未知
TASK_ERROR_PROXY_AUTH_TYPE_FAILED = 0x21, // 代理认证失败
TASK_ERROR_HTTPMGR_NOT_IP = 0x30, // http下载中无ip可用
TASK_ERROR_TIMEOUT = 0x40, // 任务超时
TASK_ERROR_CANCEL = 0x41, // 任务取消
TASK_ERROR_TP_CRASHED= 0x42, // MINITP崩溃
TASK_ERROR_ID_INVALID = 0x43, // TaskId 非法
};
*返回值:*TRUE表示成功,FALSE表示失败。
*说明:*IsOriginUsable,原始资源是否可用,是一个布尔型的参数,但是原始连接原始资源是一个耗时的操作,意味着中间有段时间原始资源是否有效是未知的。这个参数的初始态是false,所以就存在原始资源是有效,但在任务刚开始时这个参数是false的问题。上层在使用该值的时候需要根据业务逻辑再做处理。
参数: [in]stProxyIfno 代理信息
DOWN_PROXY_INFO参考:
enum DOWN_PROXY_TYPE
{
PROXY_TYPE_IE = 0,
PROXY_TYPE_HTTP = 1,
PROXY_TYPE_RESERVED= 2, //不支持该代理
PROXY_TYPE_SOCK5 = 3,
PROXY_TYPE_UNKOWN = 255,
};
enum DOWN_PROXY_AUTH_TYPE
{
PROXY_AUTH_NONE =0,
PROXY_AUTH_AUTO,
PROXY_AUTH_BASE64,
PROXY_AUTH_NTLM,
PROXY_AUTH_DEGEST,
PROXY_AUTH_UNKOWN,
};
struct DOWN_PROXY_INFO
{
BOOL bIEProxy;
BOOL bProxy;
DOWN_PROXY_TYPE stPType;
DOWN_PROXY_AUTH_TYPE stResverd;
TCHAR szHost[2048];
INT32 nPort;
TCHAR szUser[50];
TCHAR szPwd[50];
TCHAR szDomain[2048];
};
*返回值:*TRUE表示成功,FALSE表示失败。参数非法返回FALSE
任务的操作是异步执行的。调用接口有两个操作:
接口层可以操作的任务都是虚任务,真实任务是在MiniThunderPlatfom进程创建的。
这种情况是不被欢迎的,但又不可避免。子进程异常退出后MiniThunderPlatfom创建的任务会销毁。这样,虚任务除了与真实任务的映射关系,其实并无意义。这时候,查询任务信息就会返回任务出错,错误码为TASK_ERROR_ID_INVALID(任务id非法)。这时需要重新创建续传任务,接口为XL_CreateTask,结构体中其他参数与创建普通任务相同,参数IsResume设为TRUE。
各个文件功能介绍:
文件名 | 功能 |
---|---|
xldl.dll | 导出MiniTP接口 |
MiniThunderPlatform.exe | 独立进程 |
download_engine.dll | MiniTP核心库 |
zlib1.dll | 压缩通信数据 |
dl_peer_id.dll | 获取迅雷客户端标识 |
XLBugReport.exe | 负责上报捕获到的崩溃 |
XLBugHandler.dll | 负责拉起XLBugReport .exe |
minizip.dll、mini_unzip.dll | 用于压缩文件崩溃堆栈 |
atl71.dll | 微软提供的程序库 |
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。