DownloadManagerAPI和封装

作者: CokeNello | 来源:发表于2019-03-24 16:53 被阅读33次

0 .Thanks

官方文档

Android系统下载管理DownloadManager功能介绍及使用示例

1 .概述

DowanloadManger:系统的服务,系统开放给第三方应用使用的类,用于管理下载。
DownloadManager.Query:用来查询下载信息
DownloadManager.Request:用来请求一个下载

2 .DownloadManager.Request

  • addRequestHeader(String header, String value)

Add an HTTP header to be included with the download request.
添加一个Http的头到下载的请求。

  • allowScanningByMediaScanner()

If the file to be downloaded is to be scanned by MediaScanner, this method should be called before enqueue(Request) is called.
可以理解为,允许媒体的扫描。需要在任务开始前调用。

  • setAllowedNetworkTypes(int flags)
    Restrict the types of networks over which this download may proceed.
    限制什么类型的网络可以下载:
    • DownloadManager.Request.NETWORK_MOBILE-Wifi或者移动网络可以下载
    • DownloadManager.Request.NETWORK_WIFI-只允许Wifi的环境下,下载。
  • setAllowedOverMetered(boolean allow)计量网络下载?不懂。默认允许。

  • setAllowedOverRoaming(boolean allowed)允许漫游网络?默认运行。

  • setDescription(CharSequence description)
    Set a description of this download, to be displayed in notifications (if enabled)
    设置下载的描述,会显示在通知栏,如果允许的话。

  • setDestinationInExternalFilesDir(Context context, String dirType, String subPath)
    Set the local destination for the downloaded file to a path within the application's external files directory (as returned by getExternalFilesDir(String).
    设置文件的存放目录。这个方法设置的是,应用程序内能访问的。其可以用的路径:context.getExternalFilesDir(String).

  • setDestinationInExternalPublicDir(String dirType, String subPath)
    Set the local destination for the downloaded file to a path within the public external storage directory (as returned by getExternalStoragePublicDirectory(String)).
    设置文件的存放目录。这个方法设置的是,程序的外部存储。其可以用的路径:Environment.getExternalFilesDir(String).
    或者,可以自定义。

  • setDestinationUri(Uri uri)
    Set the local destination for the downloaded file.
    设置下载地址。为uri.

  • setMimeType(String mimeType)
    Set the MIME content type of this download.
    设置下载类型:MIME 参考手册
    apk的Mime:application/vnd.android

  • setNotificationVisibility(int visibility)
    Control whether a system notification is posted by the download manager while this download is running or when it is completed.
    设置通知栏是否显示和显示的规则:

    • VISIBILITY_HIDDEN :不显示在通知栏
    • VISIBILITY_VISIBLE :显示在通知栏,下载完成后,消失。
    • VISIBILITY_VISIBLE_NOTIFY_COMPLETED :显示在通知栏,下载完成后,也显示。
    • VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION :显示在通知栏,只是完成后显示。下载的时候,不显示。
  • setRequiresCharging(boolean requiresCharging)需要插入才下载?不懂

  • setRequiresDeviceIdle(boolean requiresDeviceIdle)空闲的时候才下载?

  • setTitle(CharSequence title)
    设置下载题目,显示在通知栏,如果可以的话。

  • setVisibleInDownloadsUi(boolean isVisible)
    Set whether this download should be displayed in the system's Downloads UI.
    设置下载的地址URI是否能在通知栏上可见。

3 .DownloadManager.Query

查询任务。

  • setFilterById(long... ids)
    Include only the downloads with the given IDs.
    根据下载的ID返回任务:DownloadManager.Query

  • setFilterByStatus(int flags)
    include only downloads with status matching any the given status flags.
    根据Flags去过滤返回:DownloadManager.Query

查询可以通过:

private void queryDownloadStatus() {
        DownloadManager.Query query = new DownloadManager.Query();
        final DownloadManager downloadManager= (DownloadManager) 
                  this.getSystemService(Context.DOWNLOAD_SERVICE);
        query.setFilterById(TaskID);
        Cursor c = downloadManager.query(query);
        if(c.moveToFirst()) {
            int status = c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS));
            switch(status) {
                case DownloadManager.STATUS_PAUSED:
                case DownloadManager.STATUS_PENDING:
                case DownloadManager.STATUS_RUNNING:
                case DownloadManager.STATUS_SUCCESSFUL:
            }
       }
}

去查询任务的状态。

下载的监听:

 /**
     * 得到下载的状态
     * @param context       上下文
     * @param downloadId    ID
     * @return  0 : 已经下载的量(bytes) , 1 : 总的大小, 2 : 下载的状态
     */
    public static int[] getBytesAndStatus(Context context, long downloadId) {
        int[] bytesAndStatus = new int[] { -1, -1, -1 };
        DownloadManager.Query query = new DownloadManager.Query()
                                      .setFilterById(downloadId);
        DownloadManager downloadManager = (DownloadManager)   
                  context.getSystemService(Context.DOWNLOAD_SERVICE);
        Cursor c = null;
        try {
            c = downloadManager.query(query);
            if (c != null && c.moveToFirst()) {
                bytesAndStatus[0] = c.getInt(c.getColumnIndexOrThrow(DownloadManager
                                .COLUMN_BYTES_DOWNLOADED_SO_FAR));
                bytesAndStatus[1] = c.getInt(c.getColumnIndexOrThrow(DownloadManager
                                .COLUMN_TOTAL_SIZE_BYTES));
                bytesAndStatus[2] = c.getInt(c.getColumnIndex(DownloadManager
                                .COLUMN_STATUS));
            }
        } finally {
            if (c != null) {
                c.close();
            }
        }
        return bytesAndStatus;
    }

相关文章

  • DownloadManagerAPI和封装

    0 .Thanks 官方文档 Android系统下载管理DownloadManager功能介绍及使用示例 1 .概...

  • JavaScript面向对象与设计模式

    1. 面向对象 1.1 封装 封装的目的在于将信息隐藏。广义的封装不仅包括封装数据和封装实现,还包括封装类型和封装...

  • java基础2. 基本数据类型的封装类

    1.基本类型和封装类型的对应表格 2.基本类型和封装类型的 == 判断 -封装类型和基本类型比较 -封装类型和封装...

  • JavaScript的面向对象--封装的实现、类型、变化

    封装的目的是将信息隐藏。一般而言,我们讨论的封装是封装数据和封装实现。这里将讨论更广义的封装,不仅包括封装数据和封...

  • 02.OOP面向对象-3.一些理解

    对封装的理解?封装,类本身就是一个封装,封装了属性和方法。方法也是封装,对一些业务逻辑的封装。私有也是封装,将一些...

  • python 文件及文件夹的操作和异常捕获

    1、面向对象的特征:封装、继承、多态 1.1、封装: 函数一种封装,封装了一些逻辑代码 类也是一种封装,封装属性和...

  • Java面向对象-封装性

    一、Java封装性的使用 封装性的产生目的:保护某些属性和方法不被外部所看见。封装性的实现:为属性和方法进行封装是...

  • 多态和封装

    继承 : 提高代码的重用性,规范代码(要就继承父类的子类都实现相同的方法:抽象类、接口) 当你开始编写两个类的时...

  • 动画和封装

    动画的种类 闪现匀速缓动 动画原理 盒子的位置 = 盒子本身所在的位置+步长。 缓动动画 三个函数 Math.ce...

  • 多态和封装

    多态和封装 多态 多态:指允许不同类的对象对同一消息做出响应。即同一消息可以根据发送对象不同而采用多种不同的行为方...

网友评论

    本文标题:DownloadManagerAPI和封装

    本文链接:https://www.haomeiwen.com/subject/pgbuvqtx.html