No examples for this method.
Frequently called with: [Clear]
-1
| java.lang.Object | |
| ↳ | android.app.DownloadManager.Request |
This class contains all the information necessary to request a new download. The URI is the only required parameter. Note that the default download destination is a shared volume where the system might delete your file if it needs to reclaim space for system use. If this is a problem, use a location on external storage (see setDestinationUri(Uri).
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| int | NETWORK_MOBILE | Bit flag for setAllowedNetworkTypes(int) corresponding to TYPE_MOBILE. |
|||||||||
| int | NETWORK_WIFI | Bit flag for setAllowedNetworkTypes(int) corresponding to TYPE_WIFI. |
|||||||||
| int | VISIBILITY_HIDDEN | This download doesn't show in the UI or in the notifications. | |||||||||
| int | VISIBILITY_VISIBLE | This download is visible but only shows in the notifications while it's in progress. | |||||||||
| int | VISIBILITY_VISIBLE_NOTIFY_COMPLETED | This download is visible and shows in the notifications while in progress and after completion. | |||||||||
| int | VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION | This download shows in the notifications after completion ONLY. | |||||||||
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
Add an HTTP header to be included with the download request.
|
|||||||||
|
|
|
If the file to be downloaded is to be scanned by MediaScanner, this method should be called before
enqueue(Request) is called.
|
|||||||||
|
|
|
Restrict the types of networks over which this download may proceed.
|
|||||||||
|
|
|
Set whether this download may proceed over a metered network connection.
|
|||||||||
|
|
|
Set whether this download may proceed over a roaming connection.
|
|||||||||
|
|
|
Set a description of this download, to be displayed in notifications (if enabled)
|
|||||||||
|
|
|
Set the local destination for the downloaded file to a path within the application's external files directory (as returned by
getExternalFilesDir(String).
|
|||||||||
|
|
|
Set the local destination for the downloaded file to a path within the public external storage directory (as returned by
getExternalStoragePublicDirectory(String).
|
|||||||||
|
|
|
Set the local destination for the downloaded file.
|
|||||||||
|
|
|
Set the MIME content type of this download.
|
|||||||||
|
|
|
Control whether a system notification is posted by the download manager while this download is running or when it is completed.
|
|||||||||
|
|
|
This method was deprecated in API level 11. use setNotificationVisibility(int)
|
|||||||||
|
|
|
Set the title of this download, to be displayed in notifications (if enabled).
|
|||||||||
|
|
|
Set whether this download should be displayed in the system's Downloads UI.
|
|||||||||
| [Expand]
Inherited Methods
|
|||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
 From class java.lang.Object
|
|||||||||||
Bit flag for setAllowedNetworkTypes(int) corresponding to TYPE_MOBILE.
Bit flag for setAllowedNetworkTypes(int) corresponding to TYPE_WIFI.
This download doesn't show in the UI or in the notifications.
This download is visible but only shows in the notifications while it's in progress.
This download is visible and shows in the notifications while in progress and after completion.
This download shows in the notifications after completion ONLY. It is usuable only with addCompletedDownload(String, String, boolean, String, String, long, boolean).
| uri | the HTTP URI to download. |
|---|
Add an HTTP header to be included with the download request. The header will be added to the end of the list.
| header | HTTP header name |
|---|---|
| value | header value |
If the file to be downloaded is to be scanned by MediaScanner, this method should be called before enqueue(Request) is called.
Restrict the types of networks over which this download may proceed. By default, all network types are allowed. Consider using setAllowedOverMetered(boolean) instead, since it's more flexible.
| flags | any combination of the NETWORK_* bit flags. |
|---|
Set whether this download may proceed over a metered network connection. By default, metered networks are allowed.
Set whether this download may proceed over a roaming connection. By default, roaming is allowed.
| allowed | whether to allow a roaming connection to be used |
|---|
Set a description of this download, to be displayed in notifications (if enabled)
Set the local destination for the downloaded file to a path within the application's external files directory (as returned by getExternalFilesDir(String).
The downloaded file is not scanned by MediaScanner. But it can be made scannable by calling allowScanningByMediaScanner().
| context | the Context to use in determining the external files directory |
|---|---|
| dirType | the directory type to pass to getExternalFilesDir(String) |
| subPath | the path within the external directory, including the destination filename |
Set the local destination for the downloaded file to a path within the public external storage directory (as returned by getExternalStoragePublicDirectory(String).
The downloaded file is not scanned by MediaScanner. But it can be made scannable by calling allowScanningByMediaScanner().
| dirType | the directory type to pass to getExternalStoragePublicDirectory(String) |
|---|---|
| subPath | the path within the external directory, including the destination filename |
Set the local destination for the downloaded file. Must be a file URI to a path on external storage, and the calling application must have the WRITE_EXTERNAL_STORAGE permission.
The downloaded file is not scanned by MediaScanner. But it can be made scannable by calling allowScanningByMediaScanner().
By default, downloads are saved to a generated filename in the shared download cache and may be deleted by the system at any time to reclaim space.
Set the MIME content type of this download. This will override the content type declared in the server's response.
Control whether a system notification is posted by the download manager while this download is running or when it is completed. If enabled, the download manager posts notifications about downloads through the system NotificationManager. By default, a notification is shown only when the download is in progress.
It can take the following values: VISIBILITY_HIDDEN, VISIBILITY_VISIBLE, VISIBILITY_VISIBLE_NOTIFY_COMPLETED.
If set to VISIBILITY_HIDDEN, this requires the permission android.permission.DOWNLOAD_WITHOUT_NOTIFICATION.
| visibility | the visibility setting value |
|---|
This method was deprecated in API level 11.
use setNotificationVisibility(int)
Control whether a system notification is posted by the download manager while this download is running. If enabled, the download manager posts notifications about downloads through the system NotificationManager. By default, a notification is shown. If set to false, this requires the permission android.permission.DOWNLOAD_WITHOUT_NOTIFICATION.
| show | whether the download manager should show a notification for this download. |
|---|
Set the title of this download, to be displayed in notifications (if enabled). If no title is given, a default one will be assigned based on the download filename, once the download starts.
Set whether this download should be displayed in the system's Downloads UI. True by default.
| isVisible | whether to display this download in the Downloads UI |
|---|