鸿蒙5.0&next开发【用户相册资源使用】媒体服务

美丽的神话  金牌会员 | 2025-3-15 06:10:25 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 947|帖子 947|积分 2841

用户相册资源使用指导

photoAccessHelper提供用户相册相干的接口，供开发者创建、删除用户相册，往用户相册中添加和删除图片和视频资源等。
   说明：
  在进行功能开发前，请开发者查阅[开发准备]，相识如何获取相册管理模块实例和如何申请相册管理模块功能开发相干权限。 文档中使用到photoAccessHelper的地方默认为使用开发准备中获取的对象，如未添加此段代码报photoAccessHelper未定义的错误请自行添加。
  为了保证应用的运行服从，大部门photoAccessHelper的接口调用都是异步的。以下异步调用的API示例均采用Promise函数。 如无特殊说明，文档中涉及的待获取的资源均视为已经预置且在数据库中存在相应数据。如出现按照示例代码实行出现获取资源为空的环境请确认文件是否已预置，数据库中是否存在该文件的数据。
创建用户相册（仅向系统应用开放）

通过[MediaAlbumChangeRequest.createAlbumRequest]和[PhotoAccessHelper.applyChanges]接口创建用户相册。
待创建的相册名参数规格为：


  • 相册名字符串长度为1~255。
  • 不允许出现的非法英文字符，包括：
    . \ / : * ? " ’ ` < > | { } [ ]
  • 英文字符巨细写不敏感。
  • 相册名不允许重名。
前提条件


  • 获取相册管理模块photoAccessHelper实例。
  • [申请相册管理模块权限]’ohos.permission.WRITE_IMAGEVIDEO’。
下面以创建一个用户相册为例。
开发步调

  • 设置相册名。
  • 调用MediaAlbumChangeRequest.createAlbumRequest接口创建相册变更请求。
  • 调用PhotoAccessHelper.applyChanges接口提交相册变更请求。
  1. import { photoAccessHelper } from '@kit.MediaLibraryKit';
  2. const context = getContext(this);
  3. let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
  5. async function example() {
  6.   try {
  7.     let albumName = 'albumName';
  8.     let albumChangeRequest: photoAccessHelper.MediaAlbumChangeRequest = photoAccessHelper.MediaAlbumChangeRequest.createAlbumRequest(context, albumName);
  9.     await phAccessHelper.applyChanges(albumChangeRequest);
  10.     let album: photoAccessHelper.Album = albumChangeRequest.getAlbum();
  11.     console.info('create album successfully, album name: ' + album.albumName + ' uri: ' + album.albumUri);
  12.   } catch (err) {
  13.     console.error('create album failed with err: ' + err);
  14.   }
  15. }
  16. ts
复制代码
获取用户相册

通过[PhotoAccessHelper.getAlbums]接口获取用户相册。
前提条件


  • 获取相册管理模块photoAccessHelper实例。
  • [申请相册管理模块权限]’ohos.permission.READ_IMAGEVIDEO’。
下面以获取一个相册名为’albumName’的用户相册为例。
开发步调

  • 建立检索条件，用于获取用户相册。
  • 调用PhotoAccessHelper.getAlbums接口获取用户相册资源。
  • 调用[FetchResult.getFirstObject]接口获取第一个用户相册。
  1. import { dataSharePredicates } from '@kit.ArkData';
  2. import { photoAccessHelper } from '@kit.MediaLibraryKit';
  3. const context = getContext(this);
  4. let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
  6. async function example() {
  7.   let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  8.   let albumName: photoAccessHelper.AlbumKeys = photoAccessHelper.AlbumKeys.ALBUM_NAME;
  9.   predicates.equalTo(albumName, 'albumName');
  10.   let fetchOptions: photoAccessHelper.FetchOptions = {
  11.     fetchColumns: [],
  12.     predicates: predicates
  13.   };
  15.   try {
  16.     let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.Album> = await phAccessHelper.getAlbums(photoAccessHelper.AlbumType.USER, photoAccessHelper.AlbumSubtype.USER_GENERIC, fetchOptions);
  17.     let album: photoAccessHelper.Album = await fetchResult.getFirstObject();
  18.     console.info('getAlbums successfully, albumName: ' + album.albumName);
  19.     fetchResult.close();
  20.   } catch (err) {
  21.     console.error('getAlbums failed with err: ' + err);
  22.   }
  23. }
  24. ts
复制代码
重定名用户相册

重定名用户相册修改的是相册的Album.albumName属性。
调用[MediaAlbumChangeRequest.setAlbumName]重定名用户相册后再通过[PhotoAccessHelper.applyChanges]更新到数据库中完成修改。
在重定名用户相册之前，必要先获取相册对象，可以通过[FetchResult]中的接口获取对应位置的用户相册。
重定名的相册名参数规格为：


  • 相册名字符串长度为1~255。
  • 不允许出现的非法英文字符，包括：
    . \ / : * ? " ’ ` < > | { } [ ]
  • 英文字符巨细写不敏感。
  • 相册名不允许重名。
前提条件


  • 获取相册管理模块photoAccessHelper实例。
  • [申请相册管理模块权限]’ohos.permission.READ_IMAGEVIDEO’和’ohos.permission.WRITE_IMAGEVIDEO’。
下面以将一个相册名为’albumName’的用户相册重定名为例。
开发步调

  • 建立检索条件，用于获取用户相册。
  • 调用PhotoAccessHelper.getAlbums接口获取用户相册资源。
  • 调用[FetchResult.getFirstObject]接口获取第一个用户相册。
  • 调用MediaAlbumChangeRequest.setAlbumName接口设置新的相册名。
  • 调用PhotoAccessHelper.applyChanges接口将修改的相册属性更新到数据中完成修改。
  1. import { dataSharePredicates } from '@kit.ArkData';
  2. import { photoAccessHelper } from '@kit.MediaLibraryKit';
  3. const context = getContext(this);
  4. let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
  6. async function example() {
  7.   let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  8.   let albumName: photoAccessHelper.AlbumKeys = photoAccessHelper.AlbumKeys.ALBUM_NAME;
  9.   predicates.equalTo(albumName, 'albumName');
  10.   let fetchOptions: photoAccessHelper.FetchOptions = {
  11.     fetchColumns: [],
  12.     predicates: predicates
  13.   };
  15.   try {
  16.     let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.Album> = await phAccessHelper.getAlbums(photoAccessHelper.AlbumType.USER, photoAccessHelper.AlbumSubtype.USER_GENERIC, fetchOptions);
  17.     let album: photoAccessHelper.Album = await fetchResult.getFirstObject();
  18.     console.info('getAlbums successfully, albumName: ' + album.albumName);
  19.     let albumChangeRequest: photoAccessHelper.MediaAlbumChangeRequest = new photoAccessHelper.MediaAlbumChangeRequest(album);
  20.     let newAlbumName: string = 'newAlbumName';
  21.     albumChangeRequest.setAlbumName(newAlbumName);
  22.     await phAccessHelper.applyChanges(albumChangeRequest);
  23.     console.info('setAlbumName successfully, new albumName: ' + album.albumName);
  24.     fetchResult.close();
  25.   } catch (err) {
  26.     console.error('setAlbumName failed with err: ' + err);
  27.   }
  28. }
  29. ts
复制代码
添加图片和视频到用户相册中

先[获取用户相册]对象和必要添加到相册中的图片或视频的对象数组，然后调用MediaAlbumChangeRequest.addAssets和[PhotoAccessHelper.applyChanges]接口往用户相册中添加图片或视频。
前提条件


  • 获取相册管理模块photoAccessHelper实例。
  • [申请相册管理模块权限]’ohos.permission.READ_IMAGEVIDEO’和’ohos.permission.WRITE_IMAGEVIDEO’。
下面以将往相册名为’albumName’的用户相册中添加一张图片为例。
开发步调

  • 建立相册检索条件，用于获取用户相册。
  • 建立图片检索条件，用于获取图片。
  • 调用PhotoAccessHelper.getAlbums接口获取用户相册资源。
  • 调用[FetchResult.getFirstObject]接口获取第一个用户相册。
  • 调用[PhotoAccessHelper.getAssets]接口获取图片资源。
  • 调用[FetchResult.getFirstObject]接口获取第一张图片。
  • 调用MediaAlbumChangeRequest.addAssets接口往用户相册中添加图片。
  • 调用PhotoAccessHelper.applyChanges接口提交相册变更请求。
  1. import { dataSharePredicates } from '@kit.ArkData';
  2. import { photoAccessHelper } from '@kit.MediaLibraryKit';
  3. const context = getContext(this);
  4. let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
  6. async function example() {
  7.   let albumPredicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  8.   let albumName: photoAccessHelper.AlbumKeys = photoAccessHelper.AlbumKeys.ALBUM_NAME;
  9.   albumPredicates.equalTo(albumName, 'albumName');
  10.   let albumFetchOptions: photoAccessHelper.FetchOptions = {
  11.     fetchColumns: [],
  12.     predicates: albumPredicates
  13.   };
  15.   let photoPredicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  16.   let photoFetchOptions: photoAccessHelper.FetchOptions = {
  17.     fetchColumns: [],
  18.     predicates: photoPredicates
  19.   };
  21.   try {
  22.     let albumFetchResult: photoAccessHelper.FetchResult<photoAccessHelper.Album> = await phAccessHelper.getAlbums(photoAccessHelper.AlbumType.USER, photoAccessHelper.AlbumSubtype.USER_GENERIC, albumFetchOptions);
  23.     let album: photoAccessHelper.Album = await albumFetchResult.getFirstObject();
  24.     console.info('getAlbums successfully, albumName: ' + album.albumName);
  25.     let photoFetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(photoFetchOptions);
  26.     let photoAsset: photoAccessHelper.PhotoAsset = await photoFetchResult.getFirstObject();
  27.     console.info('getAssets successfully, albumName: ' + photoAsset.displayName);
  28.     let albumChangeRequest: photoAccessHelper.MediaAlbumChangeRequest = new photoAccessHelper.MediaAlbumChangeRequest(album);
  29.     albumChangeRequest.addAssets([photoAsset]);
  30.     await phAccessHelper.applyChanges(albumChangeRequest);
  31.     console.info('succeed to add ' + photoAsset.displayName + ' to ' + album.albumName);
  32.     albumFetchResult.close();
  33.     photoFetchResult.close();
  34.   } catch (err) {
  35.     console.error('addAssets failed with err: ' + err);
  36.   }
  37. }
  38. ts
复制代码
获取用户相册中的图片和视频

先[获取用户相册]对象，然后调用[Album.getAssets]接口获取用户相册中的图片资源。
前提条件


  • 获取相册管理模块photoAccessHelper实例。
  • [申请相册管理模块权限]’ohos.permission.READ_IMAGEVIDEO’和’ohos.permission.WRITE_IMAGEVIDEO’。
下面以获取相册名为’albumName’的用户相册中的一张图片为例。
开发步调

  • 建立相册检索条件，用于获取用户相册。
  • 建立图片检索条件，用于获取图片。
  • 调用PhotoAccessHelper.getAlbums接口获取用户相册资源。
  • 调用[FetchResult.getFirstObject]接口获取第一个用户相册。
  • 调用Album.getAssets接口获取用户相册中的图片资源。
  • 调用[FetchResult.getFirstObject]接口获取第一张图片。
  1. import { dataSharePredicates } from '@kit.ArkData';
  2. import { photoAccessHelper } from '@kit.MediaLibraryKit';
  3. const context = getContext(this);
  4. let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
  6. async function example() {
  7.   let albumPredicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  8.   let albumName: photoAccessHelper.AlbumKeys = photoAccessHelper.AlbumKeys.ALBUM_NAME;
  9.   albumPredicates.equalTo(albumName, 'albumName');
  10.   let albumFetchOptions: photoAccessHelper.FetchOptions = {
  11.     fetchColumns: [],
  12.     predicates: albumPredicates
  13.   };
  15.   let photoPredicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  16.   let photoFetchOptions: photoAccessHelper.FetchOptions = {
  17.     fetchColumns: [],
  18.     predicates: photoPredicates
  19.   };
  21.   try {
  22.     let albumFetchResult: photoAccessHelper.FetchResult<photoAccessHelper.Album> = await phAccessHelper.getAlbums(photoAccessHelper.AlbumType.USER, photoAccessHelper.AlbumSubtype.USER_GENERIC, albumFetchOptions);
  23.     let album: photoAccessHelper.Album = await albumFetchResult.getFirstObject();
  24.     console.info('getAlbums successfully, albumName: ' + album.albumName);
  25.     let photoFetchResult = await album.getAssets(photoFetchOptions);
  26.     let photoAsset = await photoFetchResult.getFirstObject();
  27.     console.info('album getAssets successfully, albumName: ' + photoAsset.displayName);
  28.     albumFetchResult.close();
  29.     photoFetchResult.close();
  30.   } catch (err) {
  31.     console.error('album getAssets failed with err: ' + err);
  32.   }
  33. }
  34. ts
复制代码
从用户相册中移除图片和视频

先[获取用户相册]对象，然后调用[Album.getAssets]接口获取用户相册中的资源。
选择其中要移除的资源，然后调用[MediaAlbumChangeRequest.removeAssets]和[PhotoAccessHelper.applyChanges]接口移除。
前提条件


  • 获取相册管理模块photoAccessHelper实例。
  • [申请相册管理模块权限]’ohos.permission.READ_IMAGEVIDEO’和’ohos.permission.WRITE_IMAGEVIDEO’。
下面以将往相册名为’albumName’的用户相册中移除一张图片为例。
开发步调

  • 建立相册检索条件，用于获取用户相册。
  • 建立图片检索条件，用于获取图片。
  • 调用PhotoAccessHelper.getAlbums接口获取用户相册资源。
  • 调用[FetchResult.getFirstObject]接口获取第一个用户相册。
  • 调用Album.getAssets接口获取图片资源。
  • 调用[FetchResult.getFirstObject]接口获取第一张图片。
  • 调用MediaAlbumChangeRequest.removeAssets接口从用户相册中移除图片。
  • 调用PhotoAccessHelper.applyChanges接口提交相册变更请求。
  1. import { dataSharePredicates } from '@kit.ArkData';
  2. import { photoAccessHelper } from '@kit.MediaLibraryKit';
  3. const context = getContext(this);
  4. let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
  6. async function example() {
  7.   let albumPredicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  8.   let albumName: photoAccessHelper.AlbumKeys = photoAccessHelper.AlbumKeys.ALBUM_NAME;
  9.   albumPredicates.equalTo(albumName, 'albumName');
  10.   let albumFetchOptions: photoAccessHelper.FetchOptions = {
  11.     fetchColumns: [],
  12.     predicates: albumPredicates
  13.   };
  15.   let photoPredicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  16.   let photoFetchOptions: photoAccessHelper.FetchOptions = {
  17.     fetchColumns: [],
  18.     predicates: photoPredicates
  19.   };
  21.   try {
  22.     let albumFetchResult: photoAccessHelper.FetchResult<photoAccessHelper.Album> = await phAccessHelper.getAlbums(photoAccessHelper.AlbumType.USER, photoAccessHelper.AlbumSubtype.USER_GENERIC, albumFetchOptions);
  23.     let album: photoAccessHelper.Album = await albumFetchResult.getFirstObject();
  24.     console.info('getAlbums successfully, albumName: ' + album.albumName);
  25.     let photoFetchResult = await album.getAssets(photoFetchOptions);
  26.     let photoAsset = await photoFetchResult.getFirstObject();
  27.     console.info('album getAssets successfully, albumName: ' + photoAsset.displayName);
  28.     let albumChangeRequest: photoAccessHelper.MediaAlbumChangeRequest = new photoAccessHelper.MediaAlbumChangeRequest(album);
  29.     albumChangeRequest.removeAssets([photoAsset]);
  30.     await phAccessHelper.applyChanges(albumChangeRequest);
  31.     console.info('succeed to remove ' + photoAsset.displayName + ' from ' + album.albumName);
  32.     albumFetchResult.close();
  33.     photoFetchResult.close();
  34.   } catch (err) {
  35.     console.error('removeAssets failed with err: ' + err);
  36.   }
  37. }
  38. ts
复制代码
删除用户相册（仅向系统应用开放）

先[获取用户相册]对象，然后调用[MediaAlbumChangeRequest.deleteAlbums]删除用户相册。
前提条件


  • 获取相册管理模块photoAccessHelper实例。
  • [申请相册管理模块权限]ohos.permission.READ_IMAGEVIDEO’和’ohos.permission.WRITE_IMAGEVIDEO’。
下面以删除一个相册名为’albumName’的用户相册为例。
开发步调

  • 建立检索条件，用于获取用户相册。
  • 调用PhotoAccessHelper.getAlbums接口获取用户相册资源。
  • 调用FetchResult.getFirstObject接口获取第一个用户相册。
  • 调用MediaAlbumChangeRequest.deleteAlbums接口删除第一个用户相册。
  1. import { dataSharePredicates } from '@kit.ArkData';
  2. import { photoAccessHelper } from '@kit.MediaLibraryKit';
  3. const context = getContext(this);
  4. let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
  6. async function example() {
  7.   let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  8.   let albumName: photoAccessHelper.AlbumKeys = photoAccessHelper.AlbumKeys.ALBUM_NAME;
  9.   predicates.equalTo(albumName, 'albumName');
  10.   let fetchOptions: photoAccessHelper.FetchOptions = {
  11.     fetchColumns: [],
  12.     predicates: predicates
  13.   };
  15.   try {
  16.     let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.Album> = await phAccessHelper.getAlbums(photoAccessHelper.AlbumType.USER, photoAccessHelper.AlbumSubtype.USER_GENERIC, fetchOptions);
  17.     let album: photoAccessHelper.Album = await fetchResult.getFirstObject();
  18.     console.info('getAlbums successfully, albumName: ' + album.albumName);
  19.     await photoAccessHelper.MediaAlbumChangeRequest.deleteAlbums(context, [album]);
  20.     fetchResult.close();
  21.   } catch (err) {
  22.     console.error('deleteAlbums failed with err: ' + err);
  23.   }
  24. }
复制代码
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

美丽的神话

金牌会员
这个人很懒什么都没写!

楼主热帖

标签云

运维 CIO 存储 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表