loliball/media
1
0
Fork 0
mirror of https://github.com/androidx/media.git synced 2025-04-30 06:46:50 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

DownloadService: Attempt to clarify the static map

Browse Source 
PiperOrigin-RevId: 463315188
This commit is contained in:
olly 2022-07-26 12:49:34 +00:00 committed by tonihei
parent 4adf199398
commit ac8d80a044
1 changed files with 10 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
libraries/exoplayer/src/main/java/androidx/media3/exoplayer/offline/DownloadService.java
View File

@ -171,9 +171,11 @@ public abstract class DownloadService extends Service {
private static final String TAG = "DownloadService";
// Keep a DownloadManagerHelper for each DownloadService as long as the process is running. The
// helper is needed to restart the DownloadService when there's no scheduler. Even when there is a
// scheduler, the DownloadManagerHelper is typically able to restart the DownloadService faster.
// Maps each concrete DownloadService subclass to a single DownloadManagerHelper instance. This
// ensures getDownloadManager is only called once per subclass, even if a new instance of the
// service is created. The DownloadManagerHelper wrapper also takes care of restarting the service
// when there's no scheduler, and is often able to restart the service faster than the scheduler
// even when there is one.
private static final HashMap<Class<? extends DownloadService>, DownloadManagerHelper>
downloadManagerHelpers = new HashMap<>();
@ -711,8 +713,11 @@ public abstract class DownloadService extends Service {
}
/**
* Returns a {@link DownloadManager} to be used to downloaded content. Called only once in the
* life cycle of the process.
* Returns a {@link DownloadManager} to be used to downloaded content. For each concrete download
* service subclass, this is called once in the lifecycle of the process when {@link #onCreate} is
* called on the first instance of the service. If the service is destroyed and a new instance is
* created later, the new instance will use the previously returned {@link DownloadManager}
* without this method being called again.
*/
protected abstract DownloadManager getDownloadManager();