HarmonyOS鸿蒙Next中应用内相册功能如何实现？

你现在的核心需求是：在鸿蒙应用内实现和安卓 MediaStore 类似的效果 —— 既能浏览应用自身之前保存到系统相册的图片（即使应用卸载重装后也能查询到），同时解决当前沙盒文件卸载丢失、系统相册有图但应用内无图的问题，本质是实现应用内浏览系统相册（优先筛选自身应用保存的图片）。

首先先明确鸿蒙的核心差异：鸿蒙的沙盒文件（应用私有目录）随应用卸载删除，而系统相册的图片存储在公共媒体目录，是持久化的（不会随应用卸载丢失），你的核心问题是没有正确读取系统相册中的持久化图片，而是依赖了沙盒内的副本。

下面提供两种可行方案，从简单到复杂，优先推荐方案一（符合你的需求且开发成本低）：

方案一：核心解决方案 —— 通过 PhotoAccessHelper 读取系统相册（持久化图片）

这是鸿蒙官方推荐的读取系统公共媒体文件（图片 / 视频）的 API，对应安卓的 MediaStore，能够读取到你之前通过 PhotoAccessHelper 保存到系统相册的图片（即使应用卸载重装，只要系统相册的图片没被用户删除，就能查询到），完全解决你的核心问题。

步骤 1：配置权限（必须）

和安卓一样，读取系统相册需要申请权限，且鸿蒙分为普通权限和危险权限，读取图片视频属于危险权限，需要两步配置：

1. 在 module.json5 中声明权限打开应用的 src/main/module.json5 文件，在 abilities 同级添加 requestPermissions 节点：

   {
     "module": {
       // 其他配置...
       "requestPermissions": [
         {
           "name": "ohos.permission.READ_IMAGEVIDEO", // 读取图片/视频权限
           "reason": "需要访问系统相册以显示应用保存的图片",
           "usedScene": {
             "abilities": [
               "your.package.name.MainAbility" // 替换为你的主Ability全类名
             ],
             "when": "always"
           }
         }
       ]
     }
   }
   

2. 在代码中动态申请危险权限鸿蒙的危险权限不能仅靠清单声明，必须在运行时动态申请（用户授权后才能使用），建议在应用启动页或相册页面初始化时申请：

   import ohos.aafwk.ability.Ability;
   import ohos.agp.window.dialog.ToastDialog;
   import ohos.security.SystemPermission;
   import ohos.security.permission.PermissionManager;
   import ohos.security.permission.PermissionRequestResult;
   
   public class AlbumAbility extends Ability {
       // 权限请求码，自定义即可
       private static final int PERMISSION_REQUEST_CODE = 1001;
   
       @Override
       public void onStart(Intent intent) {
           super.onStart(intent);
           // 检查并申请读取图片/视频权限
           checkAndRequestPermission();
       }
   
       // 检查权限并动态申请
       private void checkAndRequestPermission() {
           String permission = SystemPermission.READ_IMAGEVIDEO;
           // 检查权限是否已授权
           int permissionStatus = PermissionManager.checkPermission(this, permission);
           if (permissionStatus == PermissionManager.PERMISSION_GRANTED) {
               // 权限已授权，直接查询系统相册图片
               querySystemAlbumPhotos();
           } else {
               // 权限未授权，动态申请
               PermissionManager.requestPermissions(this, new String[]{permission}, PERMISSION_REQUEST_CODE,
                       new PermissionRequestResult() {
                           @Override
                           public void onResult(int requestCode, String[] permissions, int[] grantResults) {
                               if (requestCode == PERMISSION_REQUEST_CODE && grantResults.length > 0) {
                                   if (grantResults[0] == PermissionManager.PERMISSION_GRANTED) {
                                       // 用户授权成功，查询系统相册图片
                                       querySystemAlbumPhotos();
                                   } else {
                                       // 用户拒绝授权，提示无法访问相册
                                       new ToastDialog(AlbumAbility.this)
                                               .setText("未授权访问相册，无法显示应用保存的图片")
                                               .show();
                                   }
                               }
                           }
                       });
           }
       }
   }
   

步骤 2：通过 PhotoAccessHelper 查询系统相册中的图片

PhotoAccessHelper 不仅能保存图片到系统相册，更能查询 / 读取系统相册中的所有图片（包括你应用之前保存的），核心是通过 query() 方法查询媒体数据库，和安卓的 ContentResolver.query() 类似。

核心代码实现（查询 + 读取图片）

import ohos.app.Context;
import ohos.media.image.ImageSource;
import ohos.media.image.PixelMap;
import ohos.media.photo.PhotoAccessHelper;
import ohos.media.photo.PhotoColumn;
import ohos.utils.net.Uri;
import ohos.data.resultset.ResultSet;
import java.util.ArrayList;
import java.util.List;

// 定义图片实体类，存储图片信息
class AlbumPhoto {
    private String id; // 图片唯一标识
    private Uri uri; // 图片Uri（用于读取图片内容）
    private String displayName; // 图片文件名
    private long size; // 图片大小
    private long dateAdded; // 图片添加时间

    // 构造方法、getter/setter 省略...
}

// 查询系统相册图片的核心方法
private List<AlbumPhoto> querySystemAlbumPhotos() {
    List<AlbumPhoto> photoList = new ArrayList<>();
    Context context = this; // 此处为Ability，可直接作为Context

    try {
        // 1. 获取 PhotoAccessHelper 实例
        PhotoAccessHelper photoHelper = PhotoAccessHelper.getPhotoAccessHelper(context);

        // 2. 定义需要查询的列（和安卓 MediaStore 的列类似）
        String[] columns = {
                PhotoColumn.ID, // 图片唯一ID
                PhotoColumn.URI, // 图片Uri（关键，用于后续读取图片）
                PhotoColumn.DISPLAY_NAME, // 文件名
                PhotoColumn.SIZE, // 文件大小
                PhotoColumn.DATE_ADDED // 添加时间
        };

        // 3. 构建查询条件（可选：优先筛选你应用保存的图片）
        // 如果你保存图片时自定义了文件名前缀/后缀，可通过 DISPLAY_NAME 筛选
        // 例如：你的应用图片都以 "MyApp_" 开头，查询条件可写为 PhotoColumn.DISPLAY_NAME + " LIKE 'MyApp_%'"
        String selection = null; // 为 null 时查询所有图片
        String[] selectionArgs = null;

        // 4. 定义排序方式（按添加时间倒序，最新的图片在前面）
        String sortOrder = PhotoColumn.DATE_ADDED + " DESC";

        // 5. 执行查询，获取结果集
        ResultSet resultSet = photoHelper.query(
                PhotoAccessHelper.PHOTO_URI, // 查询图片（视频为 VIDEO_URI）
                columns,
                selection,
                selectionArgs,
                sortOrder
        );

        // 6. 解析结果集，封装为图片实体列表
        if (resultSet != null && resultSet.goToFirstRow()) {
            do {
                AlbumPhoto photo = new AlbumPhoto();
                // 读取查询结果的对应列（通过列名获取索引）
                photo.setId(resultSet.getString(resultSet.getColumnIndex(PhotoColumn.ID)));
                photo.setUri(Uri.parse(resultSet.getString(resultSet.getColumnIndex(PhotoColumn.URI))));
                photo.setDisplayName(resultSet.getString(resultSet.getColumnIndex(PhotoColumn.DISPLAY_NAME)));
                photo.setSize(resultSet.getLong(resultSet.getColumnIndex(PhotoColumn.SIZE)));
                photo.setDateAdded(resultSet.getLong(resultSet.getColumnIndex(PhotoColumn.DATE_ADDED)));

                photoList.add(photo);
            } while (resultSet.goToNextRow()); // 遍历所有结果行
        }

        // 7. 关闭结果集，释放资源
        if (resultSet != null) {
            resultSet.close();
        }

    } catch (Exception e) {
        e.printStackTrace();
        new ToastDialog(context).setText("查询相册图片失败：" + e.getMessage()).show();
    }

    // 8. 后续：将 photoList 绑定到你的相册列表控件（如 ListView、RecyclerView）进行展示
    showAlbumPhotos(photoList);
    return photoList;
}

// 读取图片 Uri 对应的 PixelMap（用于界面展示）
private PixelMap getPixelMapFromUri(Context context, Uri uri) {
    try {
        // 通过 PhotoAccessHelper 打开 Uri 对应的图片流
        PhotoAccessHelper photoHelper = PhotoAccessHelper.getPhotoAccessHelper(context);
        ImageSource imageSource = ImageSource.create(photoHelper.openAssetFile(uri, "r"), null);
        // 构建图片读取选项（可自定义尺寸，避免大图内存溢出）
        ImageSource.DecodingOptions options = new ImageSource.DecodingOptions();
        options.desiredSize = new ohos.media.image.Size(400, 400); // 缩放到 400x400 展示
        return imageSource.createPixelMap(options);
    } catch (Exception e) {
        e.printStackTrace();
        return null;
    }
}

// 展示相册图片（绑定到列表控件，此处为伪代码，需替换为你的实际UI逻辑）
private void showAlbumPhotos(List<AlbumPhoto> photoList) {
    // 示例：遍历图片列表，获取 PixelMap 并设置到 Image 组件
    // for (AlbumPhoto photo : photoList) {
    //     PixelMap pixelMap = getPixelMapFromUri(this, photo.getUri());
    //     imageComponent.setPixelMap(pixelMap);
    // }
}

关键说明

1. 持久化保障：通过 PhotoAccessHelper 查询的是系统公共媒体目录的图片，不是应用沙盒内的文件，因此即使应用卸载重装，只要用户没删除系统相册中的图片，就能查询到（和安卓 MediaStore 效果一致）。
2. 筛选应用自身图片：如果想只显示你应用保存的图片（而不是系统所有图片），有两种可靠方式：
   • 文件名约定：保存图片时，给文件名加上固定前缀（如 MyApp_20240520_100000.jpg），查询时通过 selection 条件筛选（PhotoColumn.DISPLAY_NAME + " LIKE 'MyApp_%'"）。
   • 保存时写入自定义属性：鸿蒙 PhotoAccessHelper 支持保存图片时写入自定义 Exif 信息，查询时通过 Exif 信息筛选（适合更灵活的场景，开发成本稍高）。
3. 沙盒副本可移除：实现该方案后，你可以不再需要在沙盒中保存副本，直接读取系统相册的图片即可，既节省存储空间，又解决了卸载丢失的问题。

方案二：跳转至系统指定相册（备选方案）

如果你的需求是直接跳转到系统相册的指定分类（如你应用保存的图片相册），而不是在应用内嵌入浏览界面，鸿蒙支持通过隐式意图跳转系统相册应用，核心是使用 Intent 调用系统相册的能力。

核心代码

import ohos.aafwk.content.Intent;
import ohos.aafwk.content.Operation;
import ohos.utils.Uri;

// 跳转系统相册（优先打开图片分类）
private void jumpToSystemAlbum() {
    Intent intent = new Intent();
    Operation operation = new Intent.OperationBuilder()
            .withAction("ohos.intent.action.VIEW_MEDIA") // 系统媒体查看动作
            .withUri(Uri.parse("content://media/external/images/media")) // 系统图片目录Uri
            .build();
    intent.setOperation(operation);

    // 启动系统相册应用
    if (this.canStartAbility(intent)) {
        this.startAbility(intent);
    } else {
        new ToastDialog(this).setText("设备不支持跳转系统相册").show();
    }
}

说明

1. 该方案无需自己实现相册浏览界面，直接复用系统相册，开发成本极低。
2. 局限性：无法精准跳转到 “你应用专属” 的相册（鸿蒙系统相册的分类由系统管理，第三方应用无法直接指定自定义相册），只能跳转到系统图片总目录或默认分类。
3. 适用场景：如果应用内相册的核心需求是让用户查看图片，而非复杂的编辑 / 操作，可作为备选方案。

方案对比与选型建议

总结

1. 核心解决方案是方案一，通过 PhotoAccessHelper 读取系统相册的持久化图片，完全解决卸载重装后应用内无图的问题，且和安卓 MediaStore 功能对齐。
2. 实现关键步骤：配置并动态申请 ohos.permission.READ_IMAGEVIDEO 权限、通过 PhotoAccessHelper.query() 查询系统图片、解析 ResultSet 并展示图片。
3. 如需精准筛选应用自身图片，可通过约定文件名前缀或自定义 Exif 信息实现，优先选择文件名前缀（简单高效）。
4. 方案二可作为备选，用于快速实现跳转系统相册的需求，但其灵活性和定制化程度较低。