HarmonyOS鸿蒙Next中如何把相册图片文件保存沙箱

核心步骤：

1. 使用PhotoViewPicker选择图片：通过系统图库选择器获取用户选中的图片URI。
2. 将图片拷贝至应用沙箱：使用文件系统API将图片从相册URI复制到应用沙箱路径。

具体代码示例：

import { picker } from '@kit.CoreFileKit';
import { fileIo } from '@kit.CoreFileKit';
import { fileUri } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

async function saveAlbumImageToSandbox() {
  const photoSelectOptions = new picker.PhotoSelectOptions();
  photoSelectOptions.MIMEType = picker.PhotoViewMIMETypes.IMAGE_TYPE; // 选择图片类型
  photoSelectOptions.maxSelectNumber = 1; // 每次选择一张图片

  const photoViewPicker = new picker.PhotoViewPicker();
  try {
    // 1. 拉起图库选择图片
    const photoSelectResult: picker.PhotoSelectResult = await photoViewPicker.select(photoSelectOptions);
    const imageUri = photoSelectResult.photoUris[0]; // 获取选中图片的URI

    // 2. 准备沙箱存储路径
    const context = getContext(); // 获取应用上下文
    const filesDir = context.filesDir; // 应用沙箱文件目录
    const fileName = "saved_image"; // 自定义文件名
    const fileExtension = imageUri.split('.').pop(); // 从原URI提取扩展名（如jpg）
    const sandboxPath = `${filesDir}/${fileName}.${fileExtension}`;

    // 3. 拷贝图片到沙箱
    const sourceFile = await fileIo.open(imageUri, fileIo.OpenMode.READ_ONLY);
    const targetFile = await fileIo.open(sandboxPath, fileIo.OpenMode.READ_WRITE | fileIo.OpenMode.CREATE);
    await fileIo.copyFile(sourceFile.fd, targetFile.fd);
    
    // 4. 关闭文件释放资源
    fileIo.closeSync(sourceFile);
    fileIo.closeSync(targetFile);

    console.info(`图片已保存到沙箱路径: ${sandboxPath}`);
    return sandboxPath; // 返回沙箱路径供后续使用
  } catch (err) {
    console.error(`保存失败，错误码: ${(err as BusinessError).code}, 信息: ${(err as BusinessError).message}`);
  }
}

关键说明：

1. 权限要求：此操作需要申请相册访问权限（如ohos.permission.READ_IMAGEVIDEO）。
2. 路径处理：
   • 相册返回的URI格式为媒体库URI（如datashare:///media/image/1）
   • 沙箱路径需使用context.filesDir等应用专属目录
3. 文件操作：
   • 使用fileIo.copyFileSync（同步）或fileIo.copyFile（异步）进行文件复制
   • 操作完成后必须关闭文件描述符（closeSync）

⚠️ 注意：鸿蒙文档中多次强调（如《js-apis-photoAccessHelper.md》），直接手动拼接URI可能无效，必须通过系统API获取正规URI后再进行操作。

此方案适用于从系统相册选择图片并保存到应用沙箱的场景。如果需处理视频或其他媒体类型，需调整MIMEType参数和文件扩展名处理逻辑。

调用系统相机并保存到沙箱的方法主要涉及使用CameraPicker接口。以下是详细步骤和代码示例：

步骤概述：

1. 导入所需接口：从@kit.CameraKit和@kit.CoreFileKit导入相关模块。
2. 配置保存参数（PickerProfile）：指定saveUri为应用沙箱内的文件路径，以避免默认保存到媒体库。
3. 调用拍照接口：使用picker.pick方法触发系统相机界面，并获取拍摄结果。

详细代码示例：

import { camera, cameraPicker as picker } from '@kit.CameraKit';
import { fileIo, fileUri } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';

// 创建PickerProfile，配置沙箱保存路径
function createPickerProfile(context: common.Context): picker.PickerProfile {
  let pathDir = context.filesDir; // 获取应用沙箱文件目录
  let fileName = `${new Date().getTime()}`; // 使用时间戳生成文件名
  let filePath = pathDir + `/${fileName}.jpg`; // 文件路径，例如.jpg格式
  // 创建可写文件
  fileIo.createRandomAccessFileSync(filePath, fileIo.OpenMode.CREATE | fileIo.OpenMode.READ_WRITE);
  
  let uri = fileUri.getUriFromPath(filePath); // 将路径转换为URI
  let pickerProfile: picker.PickerProfile = {
    cameraPosition: camera.CameraPosition.CAMERA_POSITION_BACK, // 可选：设置相机位置
    saveUri: uri // 关键：设置保存URI为沙箱路径
  };
  return pickerProfile;
}

// 调用拍照接口并获取结果
async function getPickerResult(context: common.Context, pickerProfile: picker.PickerProfile): Promise<picker.PickerResult> {
  try {
    let result: picker.PickerResult = await picker.pick(
      context,
      [picker.PickerMediaType.PHOTO, picker.PickerMediaType.VIDEO], // 支持拍照和录像
      pickerProfile
    );
    console.info(`picker resultCode: ${result.resultCode}, resultUri: ${result.resultUri}, mediaType: ${result.mediaType}`);
    return result;
  } catch (error) {
    console.error(`Failed to pick: ${error}`);
    throw error;
  }
}

// 使用示例（在UIAbility中调用）
async function openCameraAndSaveToSandbox(context: common.Context) {
  let pickerProfile = createPickerProfile(context);
  let result = await getPickerResult(context, pickerProfile);
  // 结果中的resultUri即为沙箱中的文件URI，可直接访问或处理
  console.info('File saved to sandbox at: ' + result.resultUri);
}

关键说明：

• 保存到沙箱：通过设置PickerProfile的saveUri属性为应用沙箱内的文件路径（需确保文件存在且可写），系统相机会将拍摄结果直接覆盖写入该文件。
• 权限：使用CameraPicker无需申请相机权限，因为系统相机界面会处理权限问题。
• 文件处理：拍摄完成后，文件保存在沙箱中，您可以通过result.resultUri获取文件URI进行后续操作。

注意事项：

• 如果未配置saveUri，照片和视频会默认存入媒体库。
• 沙箱路径的文件管理（如读取、删除）需使用fileIo或fileUri模块。
• 此方法适用于拍照和录像，通过PickerMediaType指定类型。

获取沙箱存储路径

import { fileUri } from '@kit.CoreFileKit';
import { context } from '@kit.AbilityKit';

// 获取应用沙箱目录（filesDir或cacheDir）
let sandboxPath = context.getApplicationContext().filesDir;

文件复制到沙箱

import { fileIo } from '@kit.CoreFileKit';

async function copyToSandbox(srcPath: string): Promise<string> {
  // 生成目标路径（防止重复）
  let timestamp = new Date().getTime();
  let destPath = `${sandboxPath}/${timestamp}.jpg`;
  
  // 执行文件复制
  try {
    fileIo.copyFileSync(srcPath, destPath);
    return destPath;
  } catch (err) {
    console.error(`File copy failed: ${err.message}`);
    throw err;
  }
}

路径转换为URI

// 转换沙箱路径为可识别的URI
let uri = fileUri.getUriFromPath(destPath);
Image().src(uri); // 在UI组件中使用