前一陣子,在給公司的智能電視做下載模塊的時候發現,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。