HarmonyOS 鸿蒙Next中资源目录文件如何存媒体库？

HarmonyOS 鸿蒙Next中资源目录文件如何存媒体库？ 资源目录文件如何存媒体库？

3 回复

效果预览：

cke_1131.png cke_645.png

完整代码

import { photoAccessHelper } from '@kit.MediaLibraryKit';
import { fileIo } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';
import { promptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

async function savePhotoToGallery(context: common.UIAbilityContext) {
  let helper = photoAccessHelper.getPhotoAccessHelper(context);
  try {
    // onClick触发后5秒内通过createAsset接口创建图片文件，5秒后createAsset权限收回。
    let uri = await helper.createAsset(photoAccessHelper.PhotoType.IMAGE, 'jpg');
    // 使用uri打开文件，可以持续写入内容，写入过程不受时间限制
    let file = await fileIo.open(uri, fileIo.OpenMode.READ_WRITE | fileIo.OpenMode.CREATE);
    // $r('app.media.startIcon')需要替换为开发者所需的图像资源文件
    context.resourceManager.getMediaContent($r('app.media.startIcon').id, 0)
      .then(async value => {
        let media = value.buffer;
        // 写到媒体库文件中
        await fileIo.write(file.fd, media);
        await fileIo.close(file.fd);
        promptAction.showToast({ message: '已保存至相册！' });
      });
  }
  catch (error) {
    const err: BusinessError = error as BusinessError;
    console.error(`Failed to save photo. Code is ${err.code}, message is ${err.message}`);
  }
}

@Entry
@Component
struct Index {
  build() {
    Row() {
      Column({ space: 10 }) {
        // $r('app.media.startIcon')需要替换为开发者所需的图像资源文件
        Image($r('app.media.startIcon'))
          .height(400)
          .width('100%')

        SaveButton()
          .padding({top: 12, bottom: 12, left: 24, right: 24})
          .onClick(async (event: ClickEvent, result: SaveButtonOnClickResult) => {
            if (result === SaveButtonOnClickResult.SUCCESS) {
              const context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
              // 免去权限申请和权限请求等环节，获得临时授权，保存对应图片
              savePhotoToGallery(context);
            } else {
              promptAction.showToast({ message: '设置权限失败！' })
            }
          })
      }
      .width('100%')
    }
    .height('100%')
    .backgroundColor(0xF1F3F5)
  }
}

更多关于HarmonyOS 鸿蒙Next中资源目录文件如何存媒体库？的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中，将资源目录文件存入媒体库需使用MediaLibraryManager。首先获取媒体库实例，然后通过insert接口指定文件路径和媒体类型（如图片、视频），系统会自动将文件索引至媒体库。注意需在module.json5中声明ohos.permission.READ_MEDIA和WRITE_MEDIA权限。

在HarmonyOS Next中，将资源目录文件存入媒体库，核心是通过媒体库管理模块（@ohos.file.mediaLibrary）来实现。这不同于直接访问应用私有目录，需要用户授权并调用系统提供的接口。

主要步骤如下：

  1. 获取媒体库实例：首先获取单例对象mediaLibrary，这是所有操作的入口。

    import mediaLibrary from '@ohos.file.mediaLibrary';
const context = getContext(this);
const media = mediaLibrary.getMediaLibrary(context);

  2. 申请必要权限：在module.json5文件中声明存储权限（ohos.permission.READ_MEDIA 和 ohos.permission.WRITE_MEDIA），并在运行时动态请求用户授权。

  3. 确定目标目录：使用媒体库实例的方法（如getPublicDirectory）获取公共媒体目录（如相册DIR_CAMERA、视频DIR_VIDEO等）的FileAsset对象。

    let directoryType = mediaLibrary.DirectoryType.DIR_CAMERA;
let directory = await media.getPublicDirectory(directoryType);

  4. 创建文件资源：在目标目录下，使用createAsset方法创建对应的媒体文件资源（FileAsset）。需要指定文件名和相对路径（通常相对于你获取的公共目录）。

    let displayName = 'MyImage.jpg';
let fileAsset = await media.createAsset(mediaLibrary.MediaType.IMAGE, displayName, directory.relativePath);

  5. 写入文件数据：获取到FileAsset对象后，通过open方法以写模式（OpenMode.WRITE_ONLY）打开，获得文件描述符（fd）。然后使用fs模块的write或writeSync方法，将你资源目录中的文件数据（需先读取到缓冲区）写入该描述符。

    import fs from '@ohos.file.fs';
// 假设已从应用资源中读取数据到buffer
let fd = await fileAsset.open(mediaLibrary.OpenMode.WRITE_ONLY);
fs.write(fd, buffer);
fs.close(fd);

  6. 重要提示：

    • 应用资源文件（resources目录下的文件）通常需要先通过ResourceManager读取到内存（如ArrayBuffer），再将此数据写入媒体库。
    • 整个过程是异步的，需要使用async/await或Promise进行处理。
    • 操作完成后，系统媒体扫描器会自动索引该文件，使其在系统图库等应用中可见。

总结：HarmonyOS Next通过mediaLibrary API提供了标准的、安全的媒体文件创建和写入接口。你需要将资源文件数据读取后，通过媒体库接口在指定的公共目录中创建新文件并写入数据，而非直接“存储”资源文件本身。

回到顶部