目录

使用RecentPhoto组件获取最近一张图片

应用可以在布局中嵌入最近图片组件,通过此组件,应用无需申请权限,即可指定配置访问公共目录中最近的一个图片或视频文件。授予的权限仅包含只读权限。

界面效果如图所示。

开发步骤

  1. 导入最近图片组件模块文件。

    import { BaseItemInfo } from '@ohos.file.PhotoPickerComponent';
    import {
      PhotoSource,
      RecentPhotoComponent,
      RecentPhotoOptions,
      photoAccessHelper
    } from '@kit.MediaLibraryKit';
  2. 创建最近图片组件选择选项实例(RecentPhotoOptions)。

    通过RecentPhotoOptions,开发者可配置显示多长时间段内的图片、文件类型、文件内容来源,详见RecentPhotoOptions API参考。

    // 最近图片组件初始化。
    recentPhotoOptions: RecentPhotoOptions = new RecentPhotoOptions();
  3. 初始化最近图片组件选择选项实例(RecentPhotoOptions)。

    // 设置数据类型,IMAGE_VIDEO_TYPE:图片和视频(默认值)、IMAGE_TYPE:图片、VIDEO_TYPE:视频、MOVING_PHOTO_IMAGE_TYPE:动态图片。
    this.recentPhotoOptions.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_VIDEO_TYPE;
    
    // 设置最近图片的时间范围,单位(秒),有效范围为(0,86400],设置为小于等于0、大于86400或者未配置时默认按最长时间段1天显示最近图片。
    this.recentPhotoOptions.period = 0;
    
    // 设置资源的来源,ALL:所有、CAMERA:相机、SCREENSHOT:截图。
    this.recentPhotoOptions.photoSource = PhotoSource.ALL;
  4. 创建RecentPhotoComponent组件。

    RecentPhotoComponent({
      // 设置最近图片组件选择选项实例。
      recentPhotoOptions: this.recentPhotoOptions,
        
       /**
       * 选择最近图片触发的回调事件,点击会申请授权该最近图片的读权限,入参recentPhotoInfo为最近图片信息。
       * BaseItemInfo(uri, mimeType, width, height, size, duration)
       */
      onRecentPhotoClick: (recentPhotoInfo: BaseItemInfo): boolean => this.onRecentPhotoClick(recentPhotoInfo),
    
      // 检查是否存在最近的资源。
      onRecentPhotoCheckResult: (recentPhotoExists: boolean) => this.onReceiveCheckResult(recentPhotoExists),
    })
  5. 实现相关回调。

    实现onReceiveCheckResult回调,可查询是否存在最近图片,仅返回true时才可进一步实现控制是否显示最近图片。

    实现onRecentPhotoClick回调,将上报返回图片/视频相关信息BaseItemInfo。

    // 返回值为true表示最近图片处理完成。
    private onRecentPhotoClick(recentPhotoInfo: BaseItemInfo): boolean {
      if (!recentPhotoInfo) {
        return false;
      }
      return true;
    }
    
    private onReceiveCheckResult(recentPhotoExists: boolean): void {
      if (!recentPhotoExists) {
        console.info('not exist recent photo');
      }
      // 存在最近图片的话,可以实现业务需求,如去控制RecentPhotoComponent是否显示。
    }

完整示例

完整示例请查阅示例。