将Bitmap插入系统相册

Android 10之前

// 保存 Bitmap 到系统相册并返回 Uri
public Uri saveBitmapToGallery(Context context, Bitmap bitmap, String title) {
    String displayName = title + ".png"; // 图片显示的名称
    OutputStream outputStream = null;
    File imageFile;
    try {
        // 创建保存图片的路径
        File imagesDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
        if (!imagesDir.exists()) {
            imagesDir.mkdirs();
        }

        // 创建图片文件
        imageFile = new File(imagesDir, displayName);
        outputStream = new FileOutputStream(imageFile);

        // 将 Bitmap 保存到文件
        bitmap.compress(Bitmap.CompressFormat.PNG, 100, outputStream);

        // 通知系统相册刷新
        MediaScannerConnection.scanFile(context,
                new String[]{imageFile.getAbsolutePath()}, null,
                (path, uri) -> {
                    // 图片保存成功后的回调
                    // 可以在这里进行额外的操作，比如显示图片等
                    // 打开图片
                    openImageWithGallery(context, uri);
                });

        // 返回保存图片的 Uri
        return Uri.fromFile(imageFile);
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        try {
            if (outputStream != null) {
                outputStream.close();
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    return null;
}

// 通过 Intent.ACTION_VIEW 打开图片
public void openImageWithGallery(Context context, Uri imageUri) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setDataAndType(imageUri, "image/*");
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
    context.startActivity(intent);
}

Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES)

Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES) 方法用于获取外部存储上的公共图片目录路径。

在 Android 设备中，存在两种类型的存储空间：内部存储和外部存储。内部存储是应用程序私有的，只能由应用程序本身访问。而外部存储是共享的存储空间，可以被多个应用程序和用户访问。

Environment.DIRECTORY_PICTURES 是一个常量，表示图片目录。通过调用 Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES) 方法，你可以获取指向外部存储上的公共图片目录的路径。

这个方法返回的路径可能类似于 /storage/emulated/0/Pictures，其中 /storage/emulated/0 是外部存储的根目录路径，Pictures 是公共图片目录的子目录。

通过获取公共图片目录的路径，你可以在该目录下创建文件、保存图片等操作。这样，其他应用程序和用户也可以在相同的路径下访问这些图片文件。

需要注意的是，访问外部存储需要相应的权限。在 AndroidManifest.xml 文件中添加以下权限声明：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Android 10 以后

从 Android 10（API 级别 29）开始，需要使用分区存储机制来访问外部存储。你需要在应用程序中处理文件和目录的访问权限。详细信息可以参考 Android 官方文档中的关于分区存储的说明。

// 保存 Bitmap 到系统相册或公共图片目录
public Uri saveBitmapToGallery(Context context, Bitmap bitmap, String title) {
    String displayName = title + ".png"; // 图片显示的名称
    OutputStream outputStream = null;
    Uri imageUri = null;
    ContentResolver resolver = context.getContentResolver();
    ContentValues contentValues = new ContentValues();
    contentValues.put(MediaStore.Images.Media.DISPLAY_NAME, displayName);
    contentValues.put(MediaStore.Images.Media.MIME_TYPE, "image/png");

    // 在 Android 10 及更高版本中，将图片保存到系统相册需要使用 MediaStore API
    
    contentValues.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES);
    contentValues.put(MediaStore.Images.Media.IS_PENDING, 1);

    // 插入图片数据
    Uri collection = MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY);
    imageUri = resolver.insert(collection, contentValues);

    if (imageUri != null) {
       try {
           outputStream = resolver.openOutputStream(imageUri);
           bitmap.compress(Bitmap.CompressFormat.PNG, 100, outputStream);
           contentValues.put(MediaStore.Images.Media.IS_PENDING, 0);
           resolver.update(imageUri, contentValues, null, null);
        } catch (IOException e) {
           e.printStackTrace();
           if (imageUri != null) {
               resolver.delete(imageUri, null, null);
               imageUri = null;
           }
       } finally {
           try {
               if (outputStream != null) {
                   outputStream.close();
               }
           } catch (IOException e) {
               e.printStackTrace();
           }
       }
       return imageUri;
    }

MediaStore.Images.Media.IS_PENDING

MediaStore.Images.Media.IS_PENDING 是用于标识媒体文件是否处于挂起状态的字段。

在 Android 10 及更高版本中，引入了分区存储机制，通过 MediaStore API 插入或更新媒体文件时，可以使用 IS_PENDING 字段来管理文件的挂起状态。

当你向 MediaStore 插入一条新的媒体记录时，可以将 IS_PENDING 字段设置为 1（MediaStore.Images.Media.IS_PENDING = 1），表示该媒体文件处于挂起状态。在这种状态下，媒体文件不会立即对外可见，其他应用程序无法访问和使用该文件。

一旦你完成了媒体文件的创建或更新操作，可以将 IS_PENDING 字段设置为 0（MediaStore.Images.Media.IS_PENDING = 0），表示媒体文件不再处于挂起状态。此时，媒体文件将对外可见，其他应用程序可以访问和使用该文件。

这种挂起状态的管理机制可以确保在你完全准备好媒体文件之前，其他应用程序不会立即访问或使用该文件。这对于确保媒体文件的完整性和一致性非常有用。

在上述代码示例中，当保存 Bitmap 到系统相册时，通过设置 IS_PENDING 字段的值来管理图片的挂起状态。在保存完 Bitmap 后，将 IS_PENDING 设置为 0，表示媒体文件不再处于挂起状态，然后通过 resolver.update() 方法更新图片记录的状态`。

需要注意的是，如果在插入或更新媒体文件后出现异常或错误，应及时删除已创建的媒体记录和对应的媒体文件，以避免出现不完整或无效的媒体数据。

MediaStore.VOLUME_EXTERNAL_PRIMARY

MediaStore.VOLUME_EXTERNAL_PRIMARY 是一个常量，用于表示主要的外部存储卷的标识符。

在某些设备上，可能存在多个外部存储卷，例如内置存储和可插拔的 SD 卡。其中，主要的外部存储卷通常是指设备上的主要存储空间，即内置存储。而其他外部存储卷则是指额外的可插拔存储介质。

MediaStore.VOLUME_EXTERNAL_PRIMARY 提供了一个标识符，用于表示主要的外部存储卷。在使用 MediaStore API 时，可以使用该标识符来指定主要的外部存储卷。

例如，在保存媒体文件时，可以使用以下代码：

Uri collection = MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY);

通过使用 MediaStore.VOLUME_EXTERNAL_PRIMARY，你可以确保操作针对的是主要的外部存储卷，而不是其他可插拔的存储介质。

需要注意的是，MediaStore.VOLUME_EXTERNAL_PRIMARY 是在 Android 10 引入的，如果你的应用程序需要与 Android 10 及更高版本一起使用 MediaStore API，应该在代码中进行版本检查，以兼容旧版本的 Android。