文档管理中心
您当前浏览的HarmonyOS 5.0.0(API 12)文档归档不再维护,推荐您使用最新版本。详细请参考文档维护策略变更
指南媒体Media Library Kit(媒体文件管理服务)使用Picker选择媒体库资源

使用Picker选择媒体库资源

用户有时需要分享图片、视频等用户文件,开发者可以通过特定接口拉起系统图库,用户自行选择待分享的资源,然后最终完成分享。此接口本身无需申请权限,目前适用于界面UIAbility,使用窗口组件触发。具体使用方式如下:

  1. 导入选择器模块和文件管理模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { photoAccessHelper } from '@kit.MediaLibraryKit';
    2. import { fileIo } from '@kit.CoreFileKit';
    3. import { BusinessError } from '@kit.BasicServicesKit';
  2. 创建图片-音频类型文件选择选项实例。

    收起
    自动换行
    深色代码主题
    复制
    1. const photoSelectOptions = new photoAccessHelper.PhotoSelectOptions();
  3. 配置可选的媒体文件类型和媒体文件的最大数目。

    以下示例以图片选择为例,媒体文件类型请参见PhotoViewMIMETypes

    收起
    自动换行
    深色代码主题
    复制
    1. photoSelectOptions.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE; // 过滤选择媒体文件类型为IMAGE
    2. photoSelectOptions.maxSelectNumber = 5; // 选择媒体文件的最大数目
  4. 创建图库选择器实例,调用PhotoViewPicker.select接口拉起图库界面进行文件选择。文件选择成功后,返回PhotoSelectResult结果集。

    收起
    自动换行
    深色代码主题
    复制
    1. let uris: Array<string> = [];
    2. const photoViewPicker = new photoAccessHelper.PhotoViewPicker();
    3. photoViewPicker.select(photoSelectOptions).then((photoSelectResult: photoAccessHelper.PhotoSelectResult) => {
    4. uris = photoSelectResult.photoUris;
    5. console.info('photoViewPicker.select to file succeed and uris are:' + uris);
    6. }).catch((err: BusinessError) => {
    7. console.error(`Invoke photoViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
    8. })

    select返回的uri权限是只读权限,可以根据结果集中uri进行读取文件数据操作。注意不能在picker的回调里直接使用此uri进行打开文件操作,需要定义一个全局变量保存uri,类似使用一个按钮去触发打开文件。可参考指定URI读取文件数据

    也可以通过返回的uri获取图片或视频资源

    如有获取元数据需求,可以通过文件管理接口文件URI根据uri获取部分文件属性信息,比如文件大小、访问时间、修改时间、文件名、文件路径等。

指定URI读取文件数据

  1. 待界面从图库返回后,再通过一个类似按钮的组件去调用其他函数,使用fileIo.openSync接口,通过媒体文件uri打开这个文件得到fd。这里需要注意接口权限参数是fileIo.OpenMode.READ_ONLY。

    收起
    自动换行
    深色代码主题
    复制
    1. let uri: string = '';
    2. let file = fileIo.openSync(uri, fileIo.OpenMode.READ_ONLY);
    3. console.info('file fd: ' + file.fd);
  2. 通过fd使用fileIo.readSync接口读取这个文件内的数据,读取完成后关闭fd。

    收起
    自动换行
    深色代码主题
    复制
    1. let buffer = new ArrayBuffer(4096);
    2. let readLen = fileIo.readSync(file.fd, buffer);
    3. console.info('readSync data to file succeed and buffer size is:' + readLen);
    4. fileIo.closeSync(file);

指定URI获取图片或视频资源

媒体库支持Picker选择媒体文件URI后,根据指定URI获取图片或视频资源,下面以查询指定URI为'file://media/Photo/1/IMG_datetime_0001/displayName.jpg'为例。

收起
自动换行
深色代码主题
复制
  1. import { dataSharePredicates } from '@kit.ArkData';
  2. const context = getContext(this);
  3. let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
  4. class MediaDataHandler implements photoAccessHelper.MediaAssetDataHandler<ArrayBuffer> {
  5. onDataPrepared(data: ArrayBuffer) {
  6. if (data === undefined) {
  7. console.error('Error occurred when preparing data');
  8. return;
  9. }
  10. console.info('on image data prepared');
  11. // 应用自定义对资源数据的处理逻辑
  12. }
  13. }
  14. async function example() {
  15. let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
  16. let uri = 'file://media/Photo/1/IMG_datetime_0001/displayName.jpg' // 需保证此uri已存在。
  17. predicates.equalTo(photoAccessHelper.PhotoKeys.URI, uri.toString());
  18. let fetchOptions: photoAccessHelper.FetchOptions = {
  19. fetchColumns: [photoAccessHelper.PhotoKeys.TITLE],
  20. predicates: predicates
  21. };
  22. try {
  23. let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOptions);
  24. let photoAsset: photoAccessHelper.PhotoAsset = await fetchResult.getFirstObject();
  25. console.info('getAssets photoAsset.uri : ' + photoAsset.uri);
  26. // 获取属性值,以标题为例;对于非默认查询的属性,get前需要在fetchColumns中添加对应列名
  27. console.info('title : ' + photoAsset.get(photoAccessHelper.PhotoKeys.TITLE));
  28. // 请求图片资源数据
  29. let requestOptions: photoAccessHelper.RequestOptions = {
  30. deliveryMode: photoAccessHelper.DeliveryMode.HIGH_QUALITY_MODE,
  31. }
  32. await photoAccessHelper.MediaAssetManager.requestImageData(context, photoAsset, requestOptions, new MediaDataHandler());
  33. console.info('requestImageData successfully');
  34. fetchResult.close();
  35. } catch (err) {
  36. console.error('getAssets failed with err: ' + err);
  37. }
  38. }
在 指南 中进行搜索
请输入您想要搜索的关键词