首页 > 代码库 > 快车移动端SDK使用说明

快车移动端SDK使用说明

快车SDK源自快车下载内核,在高速下载同时,维持超低资源占用。同时提供全面下载任务管理,大大减少下载开发工作。

加速节流
· P2S技术,多源并发下载,帮您减少主源流量
· 可针对单个任务,开启或关闭P2P,平衡节流和用户体验
· 可随时启用或停用P2P模块,无需担心P2P消耗用户电量和流量

完备下载管理
· 提供任务列表管理
· 提供任务的添加、删除、暂停、恢复操作,完美支持断点续传和文件校验
· 支持设定并发任务数,支持任务排队机制
· 提供下载zip数据快速解压缩功能

免费加速
· 利用快车云端资源,针对SDK用户数据提供免费加速

精简移动内核
· 超精简下载内核,专注提供下载服务
· 超低资源占用,稳定高效
· 多源下载、可选P2P、断点续传、多任务管理,满足您各种下载需求



获取Flashget SDK 

 

为了集成Flashget SDK,您首先需要到Flashget SDK官方网站注册并且创建应用,获得Flashget SDK的Appkey,然后到SDK的下载页面下载SDK的压缩包,解压以后可以得到如下图的目录结构: 

 

armeabi : 直接复制该文件到目标项目libs目录。

com.flashget :  在目标项目src下新建com.flashget包,复制com.flaget文件夹下的文件到新建包

FlashgetExamole:  Demo文件,直接添加已有项目运行即可。(UTF-8格式)

doc: 说明文档

 

 配置AndroidManifest.xml 

  首先您需要添加下面的权限列表: 

 <!-- 获取网络的权限 -->

     <uses-permission android:name="android.permission.INTERNET"/>

    <!-- 写外部储存的权限 -->

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

    <!-- 读外部储存的权限 -->

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

 

这些权限将允许您的项目和Flashget SDK获取连接网络的权限、获取您的设备网络状态的权限、实现https安全连接的权限、读取手机设备状态的权限和保存必要配置的权限。一般来说,即便不集成Flashget SDK,大部分的项目也都会注册申请这些权限。

 

紧接着您需要添加应用分配的appKey:

<!-- value:添加应用分配的appKey -->

          <meta-data

            android:name="FLASHGET_APPKEY"

            android:value="您的appKey" >

        </meta-data>

 

 添加代码 

集成Flashget SDK需要至少在两个地方添加代码,包括:

 1) 打开您项目的入口Activity,在其onCreate中插入下面的代码: 

String appKey = DownloadUtil.getAppKey(getApplicationContext());

DownloadUtil.downloader = new Downloader();

DownloadUtil.taskInfo = new DownloadTaskInfo();

int test = DownloadUtil.downloader.Init(appKey, DownloadUtil.DATA_PATH);

 

这行代码会初始化Flashget SDK,此后对Flashget SDK的操作都依次为基础。如果不在所有Flashget SDK的操作之前调用这行代码,会抛出空指针异常。 

 

2)在您项目的出口Activity的onDestroy方法的第一行插入下面的代码: 

DownloadUtil.downloader.Uninit();

 

这行代码会释放资源。

InitSDK是可以重复调用的,其实Flashget SDK建议在您不确定的时候调用这个方法,来保证Flashget SDK被正确初始化。而stopSDK一旦调用了,就必须重新调用InitSDK才能使用Flashget SDK的功能,否则会出现空指针异常。  

 

下面是Flashget SD方法的介绍使用

1) 初始化Flashget SDK:

 /**

     * 初始化

     * String strAppKey:注册时得到的key

     * strConfigDir:配置文件目录

     *  @return:见错误代码 

     */

    public native int Init(String strAppKey, String strConfigDir);

 

2) 添加下载任务

/**

     * 添加下载任务

     * 参数:strUrl:下载链接, strDir:保存目录,strName:保存文件名

     * @return:nTaskID:每个下载任务的唯一ID

     */

    public native int AddTask(String strUrl, String strDir, String strName);

 

 

 

 

 

 

3) 开始下载任务

  /**

     * 开始下载任务

     * nTaskID:AddTask()的返回值

     *  @return:见错误代码

     */

    public native int StartTask(int nTaskID);

注:第一次点击下载时必须先调用 AddTask();然后调用StartTask(int nTaskID);

暂停再从新开始下载时只需要调用StartTask(int nTaskID);即可。

 

4) 暂停下载任务

  /**

     * 暂停下载任务

     * nTaskID:AddTask()的返回值

     * @return:见错误代码

     */

    public native int PauseTask(int nTaskID);

 

5) 获取任务状态

 /**

     * 获取任务状态

     * strUrl:下载链接

     * 返回值:见任务状态

     */

    public native int GetTaskInfo(int nTaskID, DownloadTaskInfo taskInfo);

 

6) 删除下载任务

 /**

     * 获取任务状态

     * strUrl:下载链接

     * 返回值:见任务状态

     */

    public native int GetTaskInfo(int nTaskID, DownloadTaskInfo taskInfo);

 

7) 获取未完成下载任务列表

 /**

     * 获取未完成下载任务列表

     *  @return:未完成下载任务的nTaskID

     */

    public native ArrayList<Integer> GetUncompletedTaskIDs();

 

 

 

8) 获取已下载完成任务列表

/**

     * 获取已下载完成任务列表

     * @return:未完成下载任务的nTaskID

     */

    public native ArrayList<Integer> GetCompletedTaskIDs();

 

9) 退出程序的时候使用来释放资源

/**

     * 退出程序的时候使用来释放资源

     *  @return:见错误代码

     */

    public native int Uninit();

 

10) 设置同时下载的最大任务数(默认2个)

 /**

     * 设置同时下载的最大任务数(默认2个)

     * 设置数目没有上限

     *  @return:见错误代码

     */

    public native int SetMaxDownloadingTaskCount(int nCount);

点击打开链接 

11) 开启/关闭调试模式 

/**

     *开启/关闭调试模式 

     * @return:见错误代码

     */

    public native int SetDebugMode(boolean bSetDebug);

 

12) 解压缩文件

 /**

     * 解压缩文件

     * strSrcFile:压缩绝对路径

     * strDir:解压缩后的目录

     *  @return:任务失败代码

     */

    public native int UnzipFile(String strSrcFile, String strDir);

注:更详细可以下载压缩包里面有详细的使用文档:下载地址:http://sdk.flashget.com/down/flashget_SDK1.0.zip


快车移动端SDK使用说明