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参考：
@ohos.fileio API参考：