本文详解如何在使用 CutOut 等图像处理库（如背景去除）后，正确利用 Uri 将处理结果保存至设备存储，涵盖 Bitmap 获取、输出流写入、权限适配及常见陷阱规避。
本文详解如何在使用 cutout 等图像处理库（如背景去除）后，正确利用 `uri` 将处理结果保存至设备存储，涵盖 bitmap 获取、输出流写入、权限适配及常见陷阱规避。
在 Android 开发中，调用第三方图像处理库（如 CutOut）完成背景去除后，通常会通过 onActivityResult 接收一个 Uri，该 Uri 指向临时生成的处理结果图像。但该 Uri 并非可直接写入的目标路径——它可能是 content:// 协议的临时内容 URI（如来自 MediaStore 或沙盒临时文件），不能直接用于 FileOutputStream；若强行拼接 file:// 路径（如原答案中的 file:// + Environment.getExternalStorageDirectory()），不仅违反 Android 10+ 的分区存储（Scoped Storage）规范，还会在 Android 7.0+ 因 FileProvider 限制导致 FileUriExposedException。
✅ 正确做法是：以目标 Uri 为写入终点，通过 ContentResolver.openOutputStream() 获取安全、兼容的输出流。以下是推荐实现（已适配 Android 10+）：
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == CutOut.CUTOUT_ACTIVITY_REQUEST_CODE) {
switch (resultCode) {
case Activity.RESULT_OK:
Uri imageUri = CutOut.getUri(data);
if (imageUri != null) {
saveImageFromUri(imageUri);
}
startActivity(new Intent(this, MainActivity.class));
break;
case CutOut.CUTOUT_ACTIVITY_RESULT_ERROR_CODE:
Exception ex = CutOut.getError(data);
Log.e("CutOut", "Error during background removal", ex);
break;
default:
Log.d("CutOut", "User cancelled");
startActivity(new Intent(this, AdvanceFeatures.class));
}
}
}
private void saveImageFromUri(Uri sourceUri) {
try {
// 1. 从 sourceUri 加载 Bitmap（自动适配 content:// 和 file://）
Bitmap bitmap = MediaStore.Images.Media.getBitmap(getContentResolver(), sourceUri);
// 2. 构造目标保存 URI：推荐使用 MediaStore 插入新条目（兼容 Scoped Storage）
ContentValues values = new ContentValues();
values.put(MediaStore.Images.Media.DISPLAY_NAME, "bg_removed_" + System.currentTimeMillis() + ".png");
values.put(MediaStore.Images.Media.MIME_TYPE, "image/png");
// ⚠️ 注意：Android 10+ 必须指定相对目录（如 DCIM、Pictures），否则插入失败
values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/CutOutResults");
Uri insertUri = getContentResolver().insert(
MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
values
);
if (insertUri != null) {
// 3. 打开输出流并写入压缩后的图像
try (OutputStream os = getContentResolver().openOutputStream(insertUri)) {
bitmap.compress(Bitmap.CompressFormat.PNG, 95, os); // 95 是平衡质量与体积的推荐值
}
// 4. 触发媒体扫描（可选，确保相册立即可见）
sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, insertUri));
Toast.makeText(this, "图像已保存至相册 → CutOutResults 文件夹", Toast.LENGTH_SHORT).show();
} else {
throw new IOException("Failed to insert image into MediaStore");
}
} catch (IOException e) {
Log.e("SaveImage", "Failed to save image from URI", e);
Toast.makeText(this, "保存失败：" + e.getMessage(), Toast.LENGTH_LONG).show();
}
}
? 关键注意事项：
- ✅ 不要硬编码 file:// 路径：自 Android 7.0 起禁止暴露 file:// URI 给其他应用；自 Android 10 起外部私有目录不可直接访问。
- ✅ 优先使用 MediaStore 写入：MediaStore.Images.Media.EXTERNAL_CONTENT_URI 是 Android 官方推荐的、符合分区存储规范的持久化方式。
- ✅ 动态申请存储权限：Android 6.0+ 需在运行时请求 Manifest.permission.READ_EXTERNAL_STORAGE（仅读取）或 WRITE_EXTERNAL_STORAGE（仅 Android 9 及以下）；Android 10+ 无需 WRITE_EXTERNAL_STORAGE，但需确保 targetSdkVersion >= 30 且未声明 requestLegacyExternalStorage=true。
- ✅ 异常处理必须完备：getBitmap() 和 openOutputStream() 均可能抛出 IOException，务必捕获并反馈用户。
- ✅ Bitmap 内存管理：大图建议先采样缩放（BitmapFactory.Options.inSampleSize），避免 OOM。
? 进阶提示：若需保存至 App 私有目录（不暴露给相册），可改用 getExternalFilesDir(Environment.DIRECTORY_PICTURES) + FileOutputStream，此路径无需权限且始终可用，但文件仅本应用可访问。
综上，保存 Uri 图像的本质是「解码 → 编码 → 安全写入」，核心在于尊重 Android 存储演进策略。采用 MediaStore 插入方案，既保障兼容性，又符合现代最佳实践。
