选择用户文件

终端用户有时需要分享、保存一些图片、视频等用户文件，开发者需要在应用中支持此类使用场景。此时，开发者可以使用OpenHarmony系统预置的文件选择器（FilePicker），实现用户文件选择及保存能力。

根据用户文件的常见类型，文件选择器（FilePicker）分别提供以下接口：

PhotoViewPicker：适用于图片或视频类文件的选择与保存。
DocumentViewPicker：适用于文档类文件的选择与保存。
AudioViewPicker：适用于音频类文件的选择与保存。

选择图片或视频类文件

导入选择器模块和文件管理模块。

import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs';

创建图库选择选项实例。

const photoSelectOptions = new picker.PhotoSelectOptions();

选择媒体文件类型和选择媒体文件的最大数目。以下示例以图片选择为例，媒体文件类型请参见PhotoViewMIMETypes。

photoSelectOptions.MIMEType = picker.PhotoViewMIMETypes.IMAGE_TYPE; // 过滤选择媒体文件类型为IMAGE
photoSelectOptions.maxSelectNumber = 5; // 选择媒体文件的最大数目

创建图库选择器实例，调用select()接口拉起FilePicker界面进行文件选择。文件选择成功后，返回PhotoSelectResult结果集。

select返回的URI权限是只读权限，可以根据结果集中URI进行读取文件数据操作。注意不能在picker的回调里直接使用此URI进行打开文件操作，需要定义一个全局变量保存URI，使用类似一个按钮去触发打开文件。
```
let URI = null;
const photoViewPicker = new picker.PhotoViewPicker();
photoViewPicker.select(photoSelectOptions).then((photoSelectResult) => {
  URI = photoSelectResult.photoUris[0];
  console.info('photoViewPicker.select to file succeed and URI is:' + URI);
}).catch((err) => {
  console.error(`Invoke photoViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
})
```
待界面从FilePicker返回后，再通过类似一个按钮调用其他函数，使用fs.openSync接口，通过URI打开这个文件得到fd。这里需要注意接口权限参数是fs.OpenMode.READ_ONLY。
```
let file = fs.openSync(URI, fs.OpenMode.READ_ONLY);
console.info('file fd: ' + file.fd);
```

通过fd使用fs.readSync接口读取这个文件内的数据，读取完成后关闭fd。

let buffer = new ArrayBuffer(4096);
let readLen = fs.readSync(file.fd, buffer);
console.info('readSync data to file succeed and buffer size is:' + readLen);
fs.closeSync(file);

选择文档类文件

导入选择器模块和文件管理模块。

import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs';

创建文档选择选项实例。

const documentSelectOptions = new picker.DocumentSelectOptions();

创建文档选择器实例。调用select()接口拉起FilePicker界面进行文件选择。文件选择成功后，返回被选中文档的URI结果集。

select返回的URI权限是只读权限，开发者可以根据结果集中URI做进一步的处理。注意不能在picker的回调里直接使用此URI进行打开文件操作，需要定义一个全局变量保存URI，使用类似一个按钮去触发打开文件。

例如通过文件管理接口根据URI获取部分文件属性信息，比如文件大小、访问时间、修改时间等。如有获取文件名称需求，请暂时使用startAbilityForResult获取。

说明：

目前DocumentSelectOptions不支持参数配置，默认可以选择所有类型的用户文件。

let URI = null;
const documentViewPicker = new picker.DocumentViewPicker(); // 创建文件选择器实例
documentViewPicker.select(documentSelectOptions).then((documentSelectResult) => {
  URI = documentSelectResult[0];
  console.info('documentViewPicker.select to file succeed and URI is:' + URI);
}).catch((err) => {
  console.error(`Invoke documentViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
})

说明：

目前DocumentSelectOptions功能不完整, 如需获取文件名称，请使用startAbilityForResult接口。

let config = {
  action: 'ohos.want.action.OPEN_FILE',
  parameters: {
    startMode: 'choose',
  }
}
try {
  let result = await context.startAbilityForResult(config, {windowMode: 1});
  if (result.resultCode !== 0) {
    console.error(`documentViewPicker.select failed, code is ${result.resultCode}, message is ${result.want.parameters.message}`);
    return;
  }
  // 获取到文档文件的URI
  let select_item_list = result.want.parameters.select_item_list;
  // 获取到文档文件的文件名称
  let file_name_list = result.want.parameters.file_name_list;
} catch (err) {
  console.error(`Invoke documentViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
}

待界面从FilePicker返回后，再通过类似一个按钮调用其他函数，使用fs.openSync接口，通过URI打开这个文件得到fd。这里需要注意接口权限参数是fs.OpenMode.READ_ONLY。
```
let file = fs.openSync(URI, fs.OpenMode.READ_ONLY);
console.info('file fd: ' + file.fd);
```

通过fd使用fs.readSync接口读取这个文件内的数据，读取完成后关闭fd。

let buffer = new ArrayBuffer(4096);
let readLen = fs.readSync(file.fd, buffer);
console.info('readSync data to file succeed and buffer size is:' + readLen);
fs.closeSync(file);

选择音频类文件

导入选择器模块和文件管理模块。

import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs';

创建音频选择选项实例。

const audioSelectOptions = new picker.AudioSelectOptions();

创建音频选择器实例。调用select()接口拉起FilePicker界面进行文件选择。文件选择成功后，返回被选中音频的URI结果集。

select返回的URI权限是只读权限，开发者可以根据结果集中URI做读取文件数据操作。注意不能在 picker的回调里直接使用此URI进行打开文件操作，需要定义一个全局变量保存URI，使用类似一个按钮去触发打开文件。

例如通过文件管理接口根据URI拿到音频资源的文件句柄（FD），再配合媒体服务实现音频播放的开发，具体请参考音频播放开发指导。

说明：

目前AudioSelectOptions不支持参数配置，默认可以选择所有类型的用户文件。
```
let URI = null;
const audioViewPicker = new picker.AudioViewPicker();
audioViewPicker.select(audioSelectOptions).then(audioSelectResult => {
  URI = audioSelectOptions[0];
  console.info('audioViewPicker.select to file succeed and URI is:' + URI);
}).catch((err) => {
  console.error(`Invoke audioViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
})
```
待界面从FilePicker返回后，再通过类似一个按钮调用其他函数，使用fs.openSync接口，通过URI打开这个文件得到fd。这里需要注意接口权限参数是fs.OpenMode.READ_ONLY。
```
let file = fs.openSync(URI, fs.OpenMode.READ_ONLY);
console.info('file fd: ' + file.fd);
```

通过fd使用fs.readSync接口读取这个文件内的数据，读取完成后关闭fd。

let buffer = new ArrayBuffer(4096);
let readLen = fs.readSync(file.fd, buffer);
console.info('readSync data to file succeed and buffer size is:' + readLen);
fs.closeSync(file);