Android DownloadManager详细使用方法

我们可以为ACTION_NOTIFICATION_CLICKED action注册一个广播接受者,当用户从通知栏点击了一个下载项目或者从Downloads app点击可一个下载的项目的

时候,系统就会发出一个点击下载项的广播。

代码片段如下:

[java]  view plain copy

  1. IntentFilter filter = new IntentFilter(DownloadManager.ACTION_NOTIFICATION_CLICKED);

  2. BroadcastReceiver receiver = new BroadcastReceiver() {

  3. @Override

  4. public void onReceive(Context context, Intent intent) {

  5. String extraID = DownloadManager.EXTRA_NOTIFICATION_CLICK_DOWNLOAD_IDS;

  6. long[] references = intent.getLongArrayExtra(extraID);

  7. for (long reference : references)

  8. if (reference == myDownloadReference) {

  9. // Do something with downloading file.

  10. }

  11. }

  12. };

  13. registerReceiver(receiver, filter);

[java]  view plain  copy

  1. IntentFilter filter = new IntentFilter(DownloadManager.ACTION_NOTIFICATION_CLICKED);

  2. BroadcastReceiver receiver = new BroadcastReceiver() {

  3. @Override

  4. public void onReceive(Context context, Intent intent) {

  5. String extraID = DownloadManager.EXTRA_NOTIFICATION_CLICK_DOWNLOAD_IDS;

  6. long[] references = intent.getLongArrayExtra(extraID);

  7. for (long reference : references)

  8. if (reference == myDownloadReference) {

  9. // Do something with downloading file.

  10. }

  11. }

  12. };

  13. registerReceiver(receiver, filter);

定制Download Manager Notifications的样式


默认情况下,通知栏中会显示被Download Manager管理的每一个download每一个Notification会显示当前的下载进度和文件的名字,如下图所示:

通过Download Manager可以为每一个download request定制Notification的样式,包括完全隐藏Notification。下面的代码片段显示了通过setTitle和setDescription

方法来定制显示在文件下载Notification中显示的文字。

[java]  view plain copy

  1. request.setTitle(“Earthquakes”);

  2. request.setDescription(“Earthquake XML”);

[java]  view plain  copy

  1. request.setTitle(“Earthquakes”);

  2. request.setDescription(“Earthquake XML”);

setNotificationVisibility方法可以用来控制什么时候显示Notification,甚至是隐藏该request的Notification。有以下几个参数:

Request.VISIBILITY_VISIBLE:在下载进行的过程中,通知栏中会一直显示该下载的Notification,当下载完成时,该Notification会被移除,这是默认的参数值。

Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED:在下载过程中通知栏会一直显示该下载的Notification,在下载完成后该Notification会继续显示,直到用户点击该

Notification或者消除该Notification。

Request.VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION:只有在下载完成后该Notification才会被显示。

Request.VISIBILITY_HIDDEN:不显示该下载请求的Notification。如果要使用这个参数,需要在应用的清单文件中加上DOWNLOAD_WITHOUT_NOTIFICATION权限。

指定下载保存地址


默认情况下,所有通过Download Manager下载的文件都保存在一个共享下载缓存中,使用系统生成的文件名每一个Request对象都可以制定一个下载

保存的地址,通常情况下,所有的下载文件都应该保存在外部存储中,所以我们需要在应用清单文件中加上WRITE_EXTERNAL_STORAGE权限:

[html]  view plain copy

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

[html]  view plain  copy

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

下面的代码片段是在外部存储中指定一个任意的保存位置的方法:

[java]  view plain copy

  1. request.setDestinationUri(Uri.fromFile(f));

[java]  view plain  copy

  1. request.setDestinationUri(Uri.fromFile(f));

f是一个File对象。

如果下载的这个文件是你的应用所专用的,你可能会希望把这个文件放在你的应用在外部存储中的一个专有文件夹中。注意这个文件夹不提供访问控制,

所以其他的应用也可以访问这个文件夹。在这种情况下,如果你的应用卸载了,那么在这个文件夹也会被删除。

下面的代码片段是指定存储文件的路径是应用在外部存储中的专用文件夹的方法:

[java]  view plain copy

  1. request.setDestinationInExternalFilesDir(this,

  2. Environment.DIRECTORY_DOWNLOADS, “Bugdroid.png”);

[java]  view plain  copy

  1. request.setDestinationInExternalFilesDir(this,

  2. Environment.DIRECTORY_DOWNLOADS, “Bugdroid.png”);

如果下载的文件希望被其他的应用共享,特别是那些你下载下来希望被Media Scanner扫描到的文件(比如音乐文件),那么你可以指定你的下载路径在

外部存储的公共文件夹之下,下面的代码片段是将文件存放到外部存储中的公共音乐文件夹的方法:

[java]  view plain copy

  1. request.setDestinationInExternalPublicDir(Environment.DIRECTORY_MUSIC,

  2. “Android_Rock.mp3”);

[java]  view plain  copy

  1. request.setDestinationInExternalPublicDir(Environment.DIRECTORY_MUSIC,

  2. “Android_Rock.mp3”);

在默认的情况下,通过Download Manager下载的文件是不能被Media Scanner扫描到的,进而这些下载的文件(音乐、视频等)就不会在Gallery和

Music Player这样的应用中看到。

为了让下载的音乐文件可以被其他应用扫描到,我们需要调用Request对象的allowScaningByMediaScanner方法。

如果我们希望下载的文件可以被系统的Downloads应用扫描到并管理,我们需要调用Request对象的setVisibleInDownloadsUi方法,传递参数true。

取消和删除下载


Download Manager的remove方法可以用来取消一个准备进行的下载,中止一个正在进行的下载,或者删除一个已经完成的下载。

remove方法接受若干个download 的ID作为参数,你可以设置一个或者几个你想要取消的下载的ID,如下代码段所示:

[java]  view plain copy

  1. downloadManager.remove(REFERENCE_1, REFERENCE_2, REFERENCE_3);

[java]  view plain  copy

  1. downloadManager.remove(REFERENCE_1, REFERENCE_2, REFERENCE_3);

该方法返回成功取消的下载的个数,如果一个下载被取消了,所有相关联的文件,部分下载的文件和完全下载的文件都会被删除。

查询Download Manager


你可以通过查询Download Manager来获得下载任务的状态,进度,以及各种细节,通过query方法返回一个包含了下载任务细节的Cursor。

query方法传递一个DownloadManager.Query对象作为参数,通过DownloadManager.Query对象的setFilterById方法可以筛选我们希望查询的下

载任务的ID。也可以使用setFilterByStatus方法筛选我们希望查询的某一种状态的下载任务,传递的参数是DownloadManager.STATUS_*常量,可以指定

正在进行、暂停、失败、完成四种状态。

Download Manager包含了一系列COLUMN_*静态String常量,可以用来查询Cursor中的结果列索引。我们可以查询到下载任务的各种细节,包括状态,

文件大小,已经下载的字节数,标题,描述,URI,本地文件名和URI,媒体类型以及Media Provider download URI。

下面的代码段是通过注册监听下载完成事件的广播接受者来查询下载完成文件的本地文件名和URI的实现方法:

[java]  view plain copy

  1. @Override

  2. public void onReceive(Context context, Intent intent) {

  3. long reference = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);

  4. if (myDownloadReference == reference) {

  5. Query myDownloadQuery = new Query();

  6. myDownloadQuery.setFilterById(reference);

  7. Cursor myDownload = downloadManager.query(myDownloadQuery);

  8. if (myDownload.moveToFirst()) {

  9. int fileNameIdx =

  10. myDownload.getColumnIndex(DownloadManager.COLUMN_LOCAL_FILENAME);

  11. int fileUriIdx =

  12. myDownload.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI);

  13. String fileName = myDownload.getString(fileNameIdx);

  14. String fileUri = myDownload.getString(fileUriIdx);

  15. // TODO Do something with the file.

  16. Log.d(TAG, fileName + " : " + fileUri);

  17. }

  18. myDownload.close();

  19. }

  20. }

[java]  view plain  copy

  1. @Override

  2. public void onReceive(Context context, Intent intent) {

  3. long reference = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);

  4. if (myDownloadReference == reference) {

  5. Query myDownloadQuery = new Query();

  6. myDownloadQuery.setFilterById(reference);

  7. Cursor myDownload = downloadManager.query(myDownloadQuery);

  8. if (myDownload.moveToFirst()) {

  9. int fileNameIdx =

  10. myDownload.getColumnIndex(DownloadManager.COLUMN_LOCAL_FILENAME);

  11. int fileUriIdx =

  12. myDownload.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI);

  13. String fileName = myDownload.getString(fileNameIdx);

  14. String fileUri = myDownload.getString(fileUriIdx);

  15. // TODO Do something with the file.

  16. Log.d(TAG, fileName + " : " + fileUri);

  17. }

  18. myDownload.close();

  19. }

  20. }

对于暂停和失败的下载,我们可以通过查询COLUMN_REASON列查询出原因的整数码。

对于STATUS_PAUSED状态的下载,可以通过DownloadManager.PAUSED_*静态常量来翻译出原因的整数码,进而判断出下载是由于等待网络连接

还是等待WiFi连接还是准备重新下载三种原因而暂停。

对于STATUS_FAILED状态的下载,我们可以通过DownloadManager.ERROR_*来判断失败的原因,可能是错误码(失败原因)包括没有存储设备,

存储空间不足,重复的文件名,或者HTTP errors。

下面的代码是如何查询出当前所有的暂停的下载任务,提取出暂停的原因以及文件名称,下载标题以及当前进度的实现方法:

[java]  view plain copy

  1. // Obtain the Download Manager Service.

  2. String serviceString = Context.DOWNLOAD_SERVICE;

  3. DownloadManager downloadManager;

  4. downloadManager = (DownloadManager)getSystemService(serviceString);

  5. // Create a query for paused downloads.

  6. Query pausedDownloadQuery = new Query();

  7. pausedDownloadQuery.setFilterByStatus(DownloadManager.STATUS_PAUSED);

  8. // Query the Download Manager for paused downloads.

  9. Cursor pausedDownloads = downloadManager.query(pausedDownloadQuery);

  10. // Find the column indexes for the data we require.

  11. int reasonIdx = pausedDownloads.getColumnIndex(DownloadManager.COLUMN_REASON);

  12. int titleIdx = pausedDownloads.getColumnIndex(DownloadManager.COLUMN_TITLE);

  13. int fileSizeIdx =

  14. pausedDownloads.getColumnIndex(DownloadManager.COLUMN_TOTAL_SIZE_BYTES);

  15. int bytesDLIdx =

  16. pausedDownloads.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR);

  17. // Iterate over the result Cursor.

  18. while (pausedDownloads.moveToNext()) {

  19. // Extract the data we require from the Cursor.

  20. String title = pausedDownloads.getString(titleIdx);

  21. int fileSize = pausedDownloads.getInt(fileSizeIdx);

  22. int bytesDL = pausedDownloads.getInt(bytesDLIdx);

  23. // Translate the pause reason to friendly text.

  24. int reason = pausedDownloads.getInt(reasonIdx);

  25. String reasonString = “Unknown”;

  26. switch (reason) {

小福利:

在当下这个碎片化信息环境的时代,很多资源都可以在网络上找到,只取决于你愿不愿意找或是找的方法对不对了

很多朋友不是没有资料,大多都是有几十上百个G,但是杂乱无章,不知道怎么看从哪看起,甚至是看后就忘

如果大家觉得自己在网上找的资料非常杂乱、不成体系的话,我也分享一套给大家,比较系统,我平常自己也会经常研读。

2021大厂最新Android面试真题解析

Android大厂面试真题解析

各个模块学习视频:如数据结构与算法

算法与数据结构资料图

只有系统,有方向的学习,才能在段时间内迅速提高自己的技术。
一线互联网架构师

这份体系学习笔记,适应人群:**第一,**学习知识比较碎片化,没有合理的学习路线与进阶方向。**第二,**开发几年,不知道如何进阶更进一步,比较迷茫。第三,到了合适的年纪,后续不知道该如何发展,转型管理,还是加强技术研究。如果你有需要,我这里恰好有为什么,不来领取!说不定能改变你现在的状态呢!点赞+评论即可获得!

网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友,可以戳这里获取

一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!

构与算法**

[外链图片转存中…(img-Eu31SEpn-1714274692619)]

只有系统,有方向的学习,才能在段时间内迅速提高自己的技术。
[外链图片转存中…(img-PBkcLM3U-1714274692619)]

[外链图片转存中…(img-KOGICvUZ-1714274692619)]

这份体系学习笔记,适应人群:**第一,**学习知识比较碎片化,没有合理的学习路线与进阶方向。**第二,**开发几年,不知道如何进阶更进一步,比较迷茫。第三,到了合适的年纪,后续不知道该如何发展,转型管理,还是加强技术研究。如果你有需要,我这里恰好有为什么,不来领取!说不定能改变你现在的状态呢!点赞+评论即可获得!

网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友,可以戳这里获取

一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!

  • 55
    点赞
  • 36
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值