【HarmonyOS】如何获取公共目录的图片等文件（API7 FA模型JS语言）

【关键字】

API7、JS、公共目录、@ohos.multimedia.mediaLibrary

【前言】

在使用API7 JS开发HarmonyOS应用时，需要获取非应用目录即内部存储公共目录下的图片，查找资料发现官网提供 @ohos.multimedia.medialibrary (媒体库管理) 可以访问和修改个人媒体数据信息，尝试后发现可以通过getFileAssets和getAllObject配合使用，获取公共目录下的所有图片；若获取其他格式的文件，通过此方法可同样获取，此处以图片为例。

【开发步骤】

步骤1：根据官方文档，调用getFileAssets方法需要申请ohos.permission.READ_MEDIA权限，需要在配置文件module.json5中添加权限，如下：

"requestPermissions": [
  {
    "name": "ohos.permission.READ_MEDIA",
    "usedScene": {
      "when": "always"
    }
  }
]

步骤2：获取媒体库实例，支持在FA模型下使用，代码如下所示：

import mediaLibrary from '@ohos.multimedia.mediaLibrary';

let media = mediaLibrary.getMediaLibrary();

步骤3：调用getFileAssets获取文件资源，并通过getAllObject方法获取所有的返回结果，获取返回结果中获取thumbnailUri数据在image的src中显示（经测试，uri无法正确显示，thumbnailUri可以），代码如下所示：

// js文件中，定义数组
data: {
    imgList: [],
},

// js文件获取文件资源并处理返回结果
let fileKeyObj = mediaLibrary.FileKey;
let imageType = mediaLibrary.MediaType.IMAGE;
let imagesFetchOp = {
    selections: fileKeyObj.MEDIA_TYPE + '= ?',
    selectionArgs: [imageType.toString()],
};
let fetchFileResult = await media.getFileAssets(imagesFetchOp);
fetchFileResult.getAllObject((err, fileAsset) => {
    if (err) {
        console.error('Failed ');
        return;
    }
    let tempList = [];
    for (let i = 0; i < fetchFileResult.getCount(); i++) {
        console.log('fileAsset : ' + JSON.stringify(fileAsset[i]));
        console.log('fileAsset.thumbnailUri : ' + fileAsset[i].thumbnailUri);
        tempList[i] = fileAsset[i].thumbnailUri;
    }
    this.imgList = tempList;
})

步骤4：获取到imageList数组后，就可以通过for循环显示image了。

// html中for循环显示图片
<image class="imglist" for="{{imgList}}" src="{{$item}}"></image>

【注意事项】

1、使用个人媒体数据信息时，一定要申请ohos.permission.READ_MEDIA权限；

2、此方法为获取公共目录下文件，若需要获取应用沙箱路径下文件资源，可使用 @ohos.fileio 中开放API接口；

3、@ohos.multimedia.medialibrary 媒体库管理从API9开始废弃，部分功能变更为系统接口，仅供系统应用使用，媒体资源选择和保存功能仍开放给普通应用，请使用@ohos.file.picker相应接口替代。

4、此方法获取的文件资源信息fileAsset中，有大小、名称、路径等信息，若需要获取某一个公共路径下的资源文件，可利用返回结果中relativePath去判断，返回完整信息参考如下：

{"id_":2410,"uri_":"dataability:///media/external/images/media/2410","mimeType_":"image/jpeg","mediaType_":"1","displayName_":"111.jpg","title_":"111","relativePath_":"DCIM/Camera/","parent_":1249,"size_":960917,"dateAdded_":1686014825,"dateModified_":1679041572,"dateTaken_":0,"artist_":"","audioAlbum_":"","width_":2340,"height_":2340,"orientation_":0,"duration_":0,"albumId_":-1739773001,"albumUri_":"dataability:///media/external/images/media/2410","albumName_":"Camera","thumbnailUri_":"dataability:///media/external/images/media/53687091200002410","isFavorite_":0,"isTrashed_":0,"extendedValues_":{},"osMediaType":"1","osRelativePath":"DCIM/Camera/","oldTitle":"111"}

【参考文档】

@ohos.multimedia.medialibrary API参考：

https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-medialibrary-0000001544584077-V3

@ohos.fileio API参考：

https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-fileio-0000001478181641-V3