鸿蒙-Media Library Kit 媒体文件管理服务

该模块提供相册管理模块能力，包括创建相册以及访问、修改相册中的媒体数据信息等。

官方地址：@ohos.file.photoAccessHelper (相册管理模块)-ArkTS API-Media Library Kit API参考-开发 | 华为开发者联盟 (huawei.com)https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-photoaccesshelper-0000001821001585#ZH-CN_TOPIC_0000001857875689__getalbums

核心API

获取图片和视频资源：photoAccessHelper.getAssets

获取相册文件：photoAccessHelper.getAlbums（）

1：导入模块

import { photoAccessHelper } from '@kit.MediaLibraryKit'

2：封装类

主要方法：

查询获取权限方法：requestClearPermissions()

获取图片/视频的资源photoAsset方法：getAssets()

获取相册屏幕截图列表方法：getScreenshotList()

获取视频列表方法：getVideoList()

删除图片方法：deletePhotos(uris: string[]) { // ['file/.....','file/...']

import { Permissions } from '@kit.AbilityKit'
import { dataSharePredicates } from '@kit.ArkData'
import { promptAction } from '@kit.ArkUI'
import { photoAccessHelper } from '@kit.MediaLibraryKit'
import { PermissionManager } from '.'

// 封装手机瘦身工具
// 调用 (相册管理模块)@ohos.file.photoAccessHelper等API
export class CleanerManager {
  // 权限
  static permissions: Permissions[] = ["ohos.permission.READ_IMAGEVIDEO", "ohos.permission.WRITE_IMAGEVIDEO"]
  // 图片资源
  static photoAssets: photoAccessHelper.PhotoAsset[] = []
  // 图片字段
  static columns: photoAccessHelper.PhotoKeys[] = [
    photoAccessHelper.PhotoKeys.DATE_ADDED,
    photoAccessHelper.PhotoKeys.SIZE,
  ]

  // 获取图片和视频权限
  static async requestClearPermissions() {
    try {
      // 申请权限
      await PermissionManager.requestPermissions(CleanerManager.permissions)
    } catch {
      // 未开启弹窗提示
      const dialogRes = await promptAction.showDialog({
        alignment: DialogAlignment.Center,
        title: '温馨提示',
        message: '手机瘦身功能需要获取权限，请在系统设置中打开相册开关',
        buttons: [
          { text: '取消', color: $r('app.color.font_sub') },
          { text: '立即开启', color: $r('app.color.brand') }
        ]
      })
      // 打开设置页
      if (dialogRes.index === 1) {
        PermissionManager.openPermissionSettingsPage()
      }
    }
  }

  // 获取图片/视频资源getPhotoAsset
  static async getAssets() {
    const phAccessHelper = photoAccessHelper.getPhotoAccessHelper(getContext()) // 获取照片访问助手
    const predicates = new dataSharePredicates.DataSharePredicates() // 创建数据共享断言
    const fetchOption: photoAccessHelper.FetchOptions = {
      fetchColumns: CleanerManager.columns,
      predicates: predicates
    }
    // 获取资源
    const assets = await phAccessHelper.getAssets(fetchOption)
    // getAssets是图片/视频资源,getAlbums是相册
    const photoAssets = await assets.getAllObjects() // 获取所有资源.getFirstObject是获取第一个资源文件

    return photoAssets //返回所有图片/视频资源列表
    //photoAsset
    // 包含媒体文件路径uri
    // 文件类型photoType
    // 文件名displayName
  }

  // 获取屏幕截图列表
  static async getScreenshotList() {
    const photoAssets = await CleanerManager.getAssets()
    // 返回photoAccessHelper.PhotoAsset[]
    return photoAssets.filter((item) => item.displayName.includes('screenshot'))
  }

  // 获取视频列表
  static async getVideoList() {
    const photoAssets = await CleanerManager.getAssets()
    // 返回photoAccessHelper.PhotoAsset[]
    return photoAssets.filter((item) => item.photoType === photoAccessHelper.PhotoType.VIDEO)
  }

  // 删除图片
  static async deletePhotos(uris: string[]) {   //  ['file/.....','file/...']
    // 获取到所有的PhotoAsset媒体资源文件组
    const photoAssets = await CleanerManager.getAssets()
    // 过滤出文件路径与传入的uri路径相等的文件的PhotoAsset
    const deleteAssets = photoAssets.filter(v => uris.includes(v.uri))
    // 调用删除deleteAssets进行删除对应的PhotoAsset操作
    await photoAccessHelper.MediaAssetChangeRequest.deleteAssets(getContext(), deleteAssets)
  }
}