自定義電視端下載模塊

前一陣子，在給公司的智能電視做下載模塊的時候發現，android自帶的DownloadManager在有線網的情況下沒有反應。看了下源碼發現標準的手機版android的DownloaderManager就是沒有對有線網的情況作處理，於是花了些時間自己寫了個下載模塊。考慮到國內大多數的智能電視都是基於手機版android改的，所以這裏共享一下。

先發一下源碼地址：https://github.com/zhanglong1/ZlsamDownloadService。

ZlsamDownloadService是一個可以管理多個下載任務的android服務，你把它作爲DownloadManager的備選方案。具體功能如下：

1. 支持多任務

2. 線程安全

3. 支持有線網環境

4. 可以多app共享使用

5. 持久化狀態，下次啓動時可以繼續未完成任務

6. 支持插隊，對於緊急任務特別有用

最大等待隊列：20；

最大處理隊列：3；

最大成功隊列：20；

最大失敗隊列：20。

如果以上參數不能滿足你的需求，你可以直接在代碼中更改，具體位置在TaskQueueManager。

如何使用

如果你想將代碼嵌入到你自己的項目當中，你需要將ZlsamDownloadService項目改爲library，並在你的項目中引用。在onStart回調中啓動和綁定的代碼如下：

Intent intent = new Intent("com.zlsam.download.DOWNLOAD_SERVICE"); 
startService(intent); 
bindService(intent, mConnection, Context.BIND_AUTO_CREATE); 

IMainDownloadingService mDownloadService;
private ServiceConnection mConnection = new ServiceConnection() {
    @Override
    public void onServiceConnected(ComponentName name, IBinder service) {
        mDownloadService  = IMainDownloadingService.Stub.asInterface(service);
        appendLog("Bound to download service.");
    }

    @Override
    public void onServiceDisconnected(ComponentName name) {
        mDownloadService = null;
    }
};

綁定成功之後你可以調用相關方法，這些方法定義在com.zlsam.download.IMainDownloadingService。

下載：

try {
    int result = mDownloadService.add2Queue(url, null, null, false);
    if (result < 0) {
        appendLog("Add task failed, error code: " + result + ", url: " + url);
    } else {
        appendLog("Add task succeed, url: " + url);
    }
} catch (RemoteException e) {
    e.printStackTrace();
}

插隊下載：

try {
    int result = mDownloadService.add2Queue(url, null, null, true);
    if (result < 0) {
        appendLog("Add task jump failed, error code: " + result + ", url: " + url);
    } else {
        appendLog("Add task jump succeed, url: " + url);
    }
} catch (RemoteException e) {
    e.printStackTrace();
}

檢查任務狀態：

try {
    state = mDownloadService.queryState(url);
} catch (RemoteException e) {
    e.printStackTrace();
    appendLog("Check task state: exception, url: " + url);
}
switch (state) {
    case -1:
        appendLog("Check task state: not found, url: " + url);
        break;
    case 0:
        appendLog("Check task state: waiting, url: " + url);
        break;
    case 1:
        appendLog("Check task state: processing, url: " + url);
        break;
    case 2:
        appendLog("Check task state: succeed, url: " + url);
        break;
    case 3:
        appendLog("Check task state: failed, url: " + url);
        break;
}

如果你想清除一個已經結束的(成功或者失敗)任務(包括已下載的文件)：

try {
    mDownloadService.clearOne(mFinishedTasks.get(mFinishedTasks.size() - 1));
} catch (RemoteException e) {
    e.printStackTrace();
}

離開界面時你要在onStop回調中解綁服務：

unbindService(mConnection);

調試命令

adb logcat ZlsamDownloadService:V *:S

Demo

你可以直接build安裝並啓動ZlsamDownloaderService，代碼中自帶的TestActivity就是一個測試Demo。