harmony 鸿蒙相册管理模块开发概述

  • 2023-10-30
  • 浏览 (628)

相册管理模块开发概述

PhotoAccessHelper提供相册管理模块相关能力,包括创建相册以及访问、修改相册中的媒体数据信息等,具体分为:

说明:

本开发指导基于API Version 10,仅适用于Stage模型。

应用需要先获取相册管理模块实例,才能访问和修改相册中的媒体数据信息。相册管理模块涉及用户个人数据信息,所以应用需要向用户申请相册管理模块读写操作权限才能保证功能的正常运行。在使用相册管理模块相关接口时如无其他注明则默认在工程代码的pages/index.ets或者其他自创的ets文件中使用。

开发者在使用PhotoAccessHelper进行功能开发前,请先掌握以下内容:

获取相册管理模块实例

应用需要使用应用上下文Context通过接口getPhotoAccessHelper,获取相册管理模块实例,用于访问和修改相册中媒体数据信息(如图片、视频)。

开发步骤:

  1. 导入photoAccessHelper模块以使用相册管理模块相关接口。
  2. 通过getContext获取应用上下文。
  3. 获取相册管理模块实例。
import photoAccessHelper from '@ohos.file.photoAccessHelper';

// 此处获取的photoAccessHelper实例为全局对象,后续文档中使用到的地方默认为使用此处获取的对象,如未添加此段代码报未定义的错误请自行添加。
const context = getContext(this);
let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);

申请相册管理模块功能相关权限

相册管理模块的读写操作需要相应权限,在申请权限前,请保证符合权限使用的基本原则。涉及的权限如下表。

权限名 说明 授权方式
ohos.permission.READ_IMAGEVIDEO 允许应用读取用户外部存储中的图片和视频媒体文件信息。 user_grant
ohos.permission.WRITE_IMAGEVIDEO 允许应用读写用户外部存储中的图片和视频媒体文件信息。 user_grant

以上权限的授权方式均为user_grant(用户授权),即开发者在module.json5文件中配置对应的权限后,需要使用接口abilityAccessCtrl.requestPermissionsFromUser去校验当前用户是否已授权。如果是,应用可以直接访问/操作目标对象;否则需要弹框向用户申请授权。

开发步骤参考:

  1. 在配置文件module.json5中声明权限
  2. 向用户申请授权

说明:

即使用户曾经授予权限,应用在调用受此权限保护的接口前,也应该先检查是否有权限。不能把之前授予的状态持久化,因为用户在动态授予后还可以通过“设置”取消应用的权限。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙文件

harmony 鸿蒙应用文件访问

harmony 鸿蒙应用接入数据备份恢复

harmony 鸿蒙应用数据备份恢复概述

harmony 鸿蒙应用触发数据备份/恢复(仅对系统应用开放)

harmony 鸿蒙应用文件概述

harmony 鸿蒙应用文件上传下载

harmony 鸿蒙应用及文件系统空间统计

harmony 鸿蒙应用沙箱目录

harmony 鸿蒙开发用户文件管理器(仅对系统应用开放)

0  赞