鸿蒙NEXT上传图片功能PhotoViewPicker核心功能解析 #ArkTS#鸿蒙Next#HarmonyOS_SDK应用服务#HarmonyOS 语言

PhotoViewPicker 是鸿蒙系统中用于媒体资源选择的核心组件，通过它可以便捷地实现图片、视频等媒体文件的选择功能。下面从基本用法、参数配置到高级应用进行全面解析：

一、PhotoViewPicker 基础用法

PhotoViewPicker 的使用流程主要分为三步：

1. 创建实例
2. 配置参数
3. 启动选择器获取结果

以下是最基本的使用示例：

import photoAccessHelper from "@ohos.photoAccess.photoAccessHelper";

async function pickImage() {
  try {
    // 1. 创建选择器实例
    const picker = photoAccessHelper.createPhotoViewPicker();

    // 2. 配置选择参数（此处使用默认配置）
    const options = {
      MIMEType: photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE, // 只选择图片
      maxSelectNumber: 1, // 最多选择张数
      isSearchSupported: true, // 显示搜索
      isPhotoTakingSupported: true, // 支持拍照
      recommendationOptions: true, // 智能推荐
      preselectedUris: true, // 预览文件
      isPreviewForSingleSelectionSupported: true, // 单选是否支持预览
    };

    // 3. 启动选择器并获取结果
    const selectedAssets = await picker.select(options);

    if (selectedAssets.photoUris.length) {
      // 处理选择的资源
      console.info("选择的资源:", selectedAssets.photoUris);
    }
  } catch (error) {
    console.error("选择图片失败:", error);
  }
}

二、关键参数详解

PhotoViewPicker 的参数配置非常灵活，可以根据需求定制选择器的行为：

const options = {
  MIMEType: photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE, // 只选择图片
  maxSelectNumber: 1, // 最多选择张数
  isSearchSupported: true, // 显示搜索
  isPhotoTakingSupported: true, // 支持拍照
  recommendationOptions: true, // 智能推荐
  preselectedUris: true, // 预览文件
  isPreviewForSingleSelectionSupported: true, // 单选是否支持预览
};

三、MIMEType 参数深度解析

MIMEType 参数是 PhotoViewPicker 中非常强大的一个配置项，它允许你精确控制选择器中显示的文件类型：

// 示例1：只允许选择JPEG和PNG图片
IMAGE_TYPE = 'image/*',
// 示例2：只允许选择视频文件
VIDEO_TYPE = 'video/*',
// 示例3：
MOVING_PHOTO_IMAGE_TYPE = 'image/movingPhoto'
// 示例4：允许所有
IMAGE_VIDEO_TYPE = '*/*',