HarmonyOS鸿蒙Next中怎样访问公共目录

【背景知识】

• DOWNLOAD模式保存文件：直接保存文件到本地Download/${bundleName}目录并具备对此目录及其子目录和文件的持久访问权限。
• 访问DOWNLOAD模式保存的文件：访问通过DOWNLOAD模式保存的文件。
• 文件管理：提供文件操作（如：创建、读取、写入等）能力。
• 使用AVMetadataExtractor提取音视频元数据信息：查询音频文件的元数据。
• 选择用户文件：通过picker方式供用户选择文件。

【解决方案】

1. 应用下载歌曲后，通过DOWNLOAD模式保存歌曲到本地Download/${bundleName}目录，应用对自己包名${bundleName}目录及其子目录和文件具有持久访问权限。
2. 应用使用文件管理接口访问已下载的歌曲路径，使用AVMetadataExtractor查询歌曲的元数据。
   示例代码如下所示：

import { fileUri, picker } from '@kit.CoreFileKit';
import { fileIo as fs } from '@kit.CoreFileKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { common } from '@kit.AbilityKit';
import { media } from '@kit.MediaKit';

const TAG = 'DownloadDemo';

@Entry
@Component
struct DownloadDemo {
  /**
   * 音乐保存目录
   */
  musicDirPath: string = '';

  build() {
    Column({ space: 20 }) {
      Text('下载歌曲').fontSize(30).onClick(() => {
        this.downloadMusic();
      })
      Text('访问歌曲').fontSize(30).onClick(() => {
        this.listMusics();
      })
    }
    .height('100%')
    .width('100%')
    .justifyContent(FlexAlign.Center)
  }

  downloadMusic(): void {
    let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    const documentViewPicker = new picker.DocumentViewPicker(context);
    const saveOptions = new picker.DocumentSaveOptions();
    saveOptions.pickerMode = picker.DocumentPickerMode.DOWNLOAD;
    documentViewPicker.save(saveOptions)
      .then((saveResult: Array<string>) => {
        // 获得Download/${bundleName}目录, 应用对自己包名${bundleName}目录及其子目录和文件具有持久访问权限
        let bundleDirUri = saveResult[0];
        console.info(`${TAG}, bundleDirUri : ${bundleDirUri}`);
        // 创建Download/${bundleName}/music目录，用于保存下载的歌曲
        this.musicDirPath = `${new fileUri.FileUri(bundleDirUri).path}/music`;
        // 校验music目录是否存在
        let saveDirExist = fs.accessSync(this.musicDirPath);
        if (saveDirExist) {
          console.info(`${TAG}, musicDirPath exists`);
        } else {
          console.info(`${TAG}, musicDirPath not exists, start to mkdir`);
          fs.mkdirSync(this.musicDirPath);
          console.info(`${TAG}, create ${this.musicDirPath} success`);
        }
        // 创建文件保存路径
        const savePath = new fileUri.FileUri(this.musicDirPath + '/music1.mp3').path;
        console.info(`${TAG}, savePath : ${savePath}`);
        const saveFile = fs.openSync(savePath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
        console.info(`${TAG}, open saveFile success, fd : ${saveFile.fd}`);
        // 假设rawfile目录下的music1.mp3是将要下载的文件，读取其内容
        context.resourceManager.getRawFileContent('music1.mp3')
          .then((content: Uint8Array) => {
            console.info(`${TAG}, getRawFileContentSync, byteLength : ${content.buffer.byteLength}`);
            // 将下载的文件拷贝到保存路径
            fs.write(saveFile.fd, content.buffer)
              .then((writeLen: number) => {
                console.info(`${TAG}, write success, writeLen : ${writeLen}`);
                fs.closeSync(saveFile);
              })
              .catch((err: BusinessError) => {
                console.error(`${TAG}, write failed, err : ${JSON.stringify(err)}`);
              })
          })
          .catch((err: BusinessError) => {
            console.error(`${TAG}, getRawFileContentSync, err : ${JSON.stringify(err)}`);
          })
      })
      .catch((err: BusinessError) => {
        console.error(`${TAG}, save failed, err : ${JSON.stringify(err)}`);
      })
  }

  async listMusics(): Promise<void> {
    // 以获访问第一首歌曲为例
    let fileNames = fs.listFileSync(this.musicDirPath);
    let fileName = fileNames[0];
    let filePath = `${this.musicDirPath}/${fileName}`;
    console.info(`${TAG}, fileName : ${fileName}, filePath : ${filePath}`);
    // 访问歌曲路径
    let file = fs.openSync(filePath, fs.OpenMode.READ_WRITE);
    let avFileDescriptor: media.AVFileDescriptor = { fd: file.fd };
    // 创建avMetadataExtractor，查询歌曲的元数据
    let avMetadataExtractor: media.AVMetadataExtractor = await media.createAVMetadataExtractor();
    avMetadataExtractor.fdSrc = avFileDescriptor;
    avMetadataExtractor.fetchMetadata()
      .then((metadata: media.AVMetadata) => {
        console.info(`${TAG}, metadata, album : ${metadata.album}， title : ${metadata.title}, author : ${metadata.author}, duration : ${metadata.duration}`);
        avMetadataExtractor.release();
        fs.closeSync(file);
      })
      .catch((err: BusinessError) => {
        console.error(`${TAG}, fetchMetadata failed, err : ${JSON.stringify(err)}`);
      });
  }
}