Android 10中如何将默认下载管理器下载的视频保存至可被相册识别的公共目录
Android 10+ 公共目录视频下载适配方案
现有代码的核心问题
- Android Q及以上分支的
setDestinationInExternalFilesDir参数传递错误:该方法仅用于存储应用私有外部目录,第二个参数要求传入相对路径,你传入的绝对存储路径会被系统忽略,最终文件只会存在应用私有路径下,无法被系统相册识别。 - 依赖
android:requestLegacyExternalStorage="true"的方案兼容性差:该属性仅对Android 10生效,Android 11及以上系统会直接忽略,无法作为长期适配方案。 - 逻辑冗余:
doInBackground中手动创建HttpURLConnection读取网络流,但没有实际写入本地文件,同时又触发系统DownloadManager下载,两套逻辑并行会浪费资源、导致进度计算异常。
修正后的适配实现
下载逻辑核心修正
直接替换原来的callDownloadManager方法,分版本适配公共目录存储:
private void callDownloadManager() { Uri uri = Uri.parse(downurl); DownloadManager downloadManager = (DownloadManager) c.getSystemService(Context.DOWNLOAD_SERVICE); DownloadManager.Request request = new DownloadManager.Request(uri); request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED); request.setDescription("下载中"); filename = downurl.substring(downurl.lastIndexOf("/") + 1); String mimeType = MimeTypeMap.getSingleton().getMimeTypeFromExtension(MimeTypeMap.getFileExtensionFromUrl(downurl)); request.setMimeType(mimeType); request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_WIFI | DownloadManager.Request.NETWORK_MOBILE); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) { // Android 10+ 通过MediaStore获取公共Movies目录的可写Uri ContentValues values = new ContentValues(); values.put(MediaStore.Video.Media.DISPLAY_NAME, filename); values.put(MediaStore.Video.Media.MIME_TYPE, mimeType); // 指定存储到公共Movies目录下的Movie子文件夹 values.put(MediaStore.Video.Media.RELATIVE_PATH, Environment.DIRECTORY_MOVIES + "/Movie"); Uri collectionUri = MediaStore.Video.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY); Uri itemUri = c.getContentResolver().insert(collectionUri, values); // 将系统DownloadManager的存储目标指向公共目录Uri request.setDestinationUri(itemUri); } else { // Android 9及以下沿用原有公共目录逻辑 request.setDestinationInExternalPublicDir(Environment.DIRECTORY_MOVIES + "/Movie", filename); } StoreClass.stop_Id = downloadManager.enqueue(request); }
可选优化:下载完成后主动触发媒体扫描
如果需要让系统相册在下载完成后立刻识别视频文件,不需要等待系统定期扫描,可以在下载完成的广播接收器中添加扫描逻辑:
// 传入下载任务对应的downloadId即可 Uri contentUri = ContentUris.withAppendedId(MediaStore.Video.Media.EXTERNAL_CONTENT_URI, downloadId); c.sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, contentUri));
注意事项
- 该方案不需要申请额外的存储权限,完全符合Android分区存储规范,Android 10及以上全版本兼容。
- 不需要再保留
android:requestLegacyExternalStorage="true"属性,不会对兼容逻辑产生影响。 - 建议删掉原
doInBackground中手动创建HttpURLConnection读流的冗余逻辑,直接监听DownloadManager的进度回调即可,避免出现流占用、重复下载的问题。
内容的提问来源于stack exchange,提问作者Rahul Kasgar
相关产品推荐
相关产品推荐

