HarmonyOS实战开发：@ohos.file.picker (选择器)

最新推荐文章于 2024-08-16 15:13:27 发布
最新推荐文章于 2024-08-16 15:13:27 发布
阅读量1.3k 收藏 9
点赞数 7
分类专栏： 鸿蒙 文章标签： harmonyos 华为 鸿蒙 鸿蒙系统 android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_84194030/article/details/139426064
版权

说明：

该模块接口从API version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

选择器(Picker)是一个封装PhotoViewPicker、DocumentViewPicker、AudioViewPicker等API模块，具有选择与保存的能力。应用可以自行选择使用哪种API实现文件选择和文件保存的功能。该类接口，需要应用在界面UIAbility中调用，否则无法拉起photoPicker应用或FilePicker应用。

导入模块

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

PhotoViewPicker

图库选择器对象，用来支撑选择图片/视频和保存图片/视频等用户场景。选择文件推荐使用PhotoAccessHelper的PhotoViewPicker。在使用前，需要先创建PhotoViewPicker实例。

系统能力：SystemCapability.FileManagement.UserFileService

示例：

let photoPicker = new picker.PhotoViewPicker();

select

select(option?: PhotoSelectOptions): Promise<PhotoSelectResult>

通过选择模式拉起photoPicker界面，用户可以选择一个或多个图片/视频。接口采用Promise异步返回形式，传入可选参数PhotoSelectOptions对象，返回PhotoSelectResult对象。

注意：此接口返回的PhotoSelectResult对象中的photoUris只能通过临时授权的方式调用photoAccessHelper.getAssets接口去使用，具体使用方式参见用户文件uri介绍中的媒体文件uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
选择PhotoSelectOptions否photoPicker选择选项，若无此参数，则默认选择媒体文件类型为图片和视频类型，选择媒体文件数量的默认最大值为50

返回值：

类型说明
Promise<PhotoSelectResult>Promise对象。返回photoPicker选择后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example01() {
  try {  
    let PhotoSelectOptions = new picker.PhotoSelectOptions();
    PhotoSelectOptions.MIMEType = picker.PhotoViewMIMETypes.IMAGE_TYPE;
    PhotoSelectOptions.maxSelectNumber = 5;
    let photoPicker = new picker.PhotoViewPicker();
    photoPicker.select(PhotoSelectOptions).then((PhotoSelectResult: picker.PhotoSelectResult) => {
      console.info('PhotoViewPicker.select successfully, PhotoSelectResult uri: ' + JSON.stringify(PhotoSelectResult));
    }).catch((err: BusinessError) => {
      console.error('PhotoViewPicker.select failed with err: ' + JSON.stringify(err));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('PhotoViewPicker failed with err: ' + JSON.stringify(err));
  }
}

select

select(option: PhotoSelectOptions, callback: AsyncCallback<PhotoSelectResult>): void

通过选择模式拉起photoPicker界面，用户可以选择一个或多个图片/视频。接口采用callback异步返回形式，传入参数PhotoSelectOptions对象，返回PhotoSelectResult对象。

注意：此接口返回的PhotoSelectResult对象中的photoUris只能通过临时授权的方式调用photoAccessHelper.getAssets接口去使用，具体使用方式参见用户文件uri介绍中的媒体文件uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
optionPhotoSelectOptions是photoPicker选择选项
callbackAsyncCallback<PhotoSelectResult>是callback 返回photoPicker选择后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example02() {
  try {
    let PhotoSelectOptions = new picker.PhotoSelectOptions();
    PhotoSelectOptions.MIMEType = picker.PhotoViewMIMETypes.IMAGE_TYPE;
    PhotoSelectOptions.maxSelectNumber = 5;
    let photoPicker = new picker.PhotoViewPicker();
    photoPicker.select(PhotoSelectOptions, (err: BusinessError, PhotoSelectResult: picker.PhotoSelectResult) => {
      if (err) {
        console.error('PhotoViewPicker.select failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('PhotoViewPicker.select successfully, PhotoSelectResult uri: ' + JSON.stringify(PhotoSelectResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('PhotoViewPicker failed with err: ' + JSON.stringify(err));
  }
}

select

select(callback: AsyncCallback<PhotoSelectResult>): void

通过选择模式拉起photoPicker界面，用户可以选择一个或多个图片/视频。接口采用callback异步返回形式，返回PhotoSelectResult对象。

注意：此接口返回的PhotoSelectResult对象中的photoUris只能通过临时授权的方式调用photoAccessHelper.getAssets接口去使用，具体使用方式参见用户文件uri介绍中的媒体文件uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
callbackAsyncCallback<PhotoSelectResult>是callback 返回photoPicker选择后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example03() {
  try {
    let photoPicker = new picker.PhotoViewPicker();
    photoPicker.select((err: BusinessError, PhotoSelectResult: picker.PhotoSelectResult) => {
      if (err) {
        console.error('PhotoViewPicker.select failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('PhotoViewPicker.select successfully, PhotoSelectResult uri: ' + JSON.stringify(PhotoSelectResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('PhotoViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(option?: PhotoSaveOptions): Promise<Array<string>>

通过保存模式拉起photoPicker界面，用户可以保存一个或多个图片/视频。接口采用Promise异步返回形式，传入可选参数PhotoSaveOptions对象，返回保存文件的uri数组。

注意：此接口会将文件保存在文件管理器，而不是图库。返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
optionPhotoSaveOptions否photoPicker保存图片或视频文件选项，若无此参数，则拉起photoPicker界面后需用户自行输入保存的文件名

返回值：

类型说明
Promise<Array<string>>Promise对象。返回photoPicker保存图片或视频文件后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example04() {
  try {
    let PhotoSaveOptions = new picker.PhotoSaveOptions();
    PhotoSaveOptions.newFileNames = ['PhotoViewPicker01.jpg', 'PhotoViewPicker01.mp4'];
    let photoPicker = new picker.PhotoViewPicker();
    photoPicker.save(PhotoSaveOptions).then((PhotoSaveResult: Array<string>) => {
      console.info('PhotoViewPicker.save successfully, PhotoSaveResult uri: ' + JSON.stringify(PhotoSaveResult));
    }).catch((err: BusinessError) => {
      console.error('PhotoViewPicker.save failed with err: ' + JSON.stringify(err));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
      console.error('PhotoViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(option: PhotoSaveOptions, callback: AsyncCallback<Array<string>>): void

通过保存模式拉起photoPicker界面，用户可以保存一个或多个图片/视频。接口采用callback异步返回形式，传入参数PhotoSaveOptions对象，返回保存文件的uri数组。

注意：此接口会将文件保存在文件管理器，而不是图库。返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
optionPhotoSaveOptions是photoPicker保存图片或视频文件选项
callbackAsyncCallback<Array<string>>是callback 返回photoPicker保存图片或视频文件后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example05() {
  try {
    let PhotoSaveOptions = new picker.PhotoSaveOptions();
    PhotoSaveOptions.newFileNames = ['PhotoViewPicker02.jpg','PhotoViewPicker02.mp4'];
    let photoPicker = new picker.PhotoViewPicker();
    photoPicker.save(PhotoSaveOptions, (err: BusinessError, PhotoSaveResult: Array<string>) => {
      if (err) {
        console.error('PhotoViewPicker.save failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('PhotoViewPicker.save successfully, PhotoSaveResult uri: ' + JSON.stringify(PhotoSaveResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('PhotoViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(callback: AsyncCallback<Array<string>>): void

通过保存模式拉起photoPicker界面，用户可以保存一个或多个图片/视频。接口采用callback异步返回形式，返回保存文件的uri数组。

注意：此接口会将文件保存在文件管理器，而不是图库。返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
callbackAsyncCallback<Array<string>>是callback 返回photoPicker保存图片或视频文件后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example06() {
  try {
    let photoPicker = new picker.PhotoViewPicker();
    photoPicker.save((err: BusinessError, PhotoSaveResult: Array<string>) => {
      if (err) {
        console.error('PhotoViewPicker.save failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('PhotoViewPicker.save successfully, PhotoSaveResult uri: ' + JSON.stringify(PhotoSaveResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('PhotoViewPicker failed with err: ' + JSON.stringify(err));
  }
}

DocumentViewPicker

文件选择器对象，用来支撑选择和保存各种格式文档。在使用前，需要先创建DocumentViewPicker实例。

系统能力：SystemCapability.FileManagement.UserFileService

示例：

let documentPicker = new picker.DocumentViewPicker();

select

select(option?: DocumentSelectOptions): Promise<Array<string>>

通过选择模式拉起documentPicker界面，用户可以选择一个或多个文件。接口采用Promise异步返回形式，传入可选参数DocumentSelectOptions对象，返回选择文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
optionDocumentSelectOptions否documentPicker选择选项，若无此参数，则默认拉起documentPicker主界面

返回值：

类型说明
Promise<Array<string>>Promise对象。返回documentPicker选择后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example07() {
  try {
    let DocumentSelectOptions = new picker.DocumentSelectOptions();
    let documentPicker = new picker.DocumentViewPicker();
    documentPicker.select(DocumentSelectOptions).then((DocumentSelectResult: Array<string>) => {
      console.info('DocumentViewPicker.select successfully, DocumentSelectResult uri: ' + JSON.stringify(DocumentSelectResult));
    }).catch((err: BusinessError) => {
      console.error('DocumentViewPicker.select failed with err: ' + JSON.stringify(err));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('DocumentViewPicker failed with err: ' + JSON.stringify(err));
  }
}

select

select(option: DocumentSelectOptions, callback: AsyncCallback<Array<string>>): void

通过选择模式拉起documentPicker界面，用户可以选择一个或多个文件。接口采用callback异步返回形式，传入参数DocumentSelectOptions对象，返回选择文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
optionDocumentSelectOptions是documentPicker选择选项
callbackAsyncCallback<Array<string>>是callback 返回documentPicker选择后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example08() {
  try {
    let DocumentSelectOptions = new picker.DocumentSelectOptions();
    let documentPicker = new picker.DocumentViewPicker();
    documentPicker.select(DocumentSelectOptions, (err: BusinessError, DocumentSelectResult: Array<string>) => {
      if (err) {
        console.error('DocumentViewPicker.select failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('DocumentViewPicker.select successfully, DocumentSelectResult uri: ' + JSON.stringify(DocumentSelectResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('DocumentViewPicker failed with err: ' + JSON.stringify(err));
  }
}

select

select(callback: AsyncCallback<Array<string>>): void

通过选择模式拉起documentPicker界面，用户可以选择一个或多个文件。接口采用callback异步返回形式，返回选择文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
callbackAsyncCallback<Array<string>>是callback 返回documentPicker选择后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example09() {
  try {
    let documentPicker = new picker.DocumentViewPicker();
    documentPicker.select((err: BusinessError, DocumentSelectResult: Array<string>) => {
      if (err) {
        console.error('DocumentViewPicker.select failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('DocumentViewPicker.select successfully, DocumentSelectResult uri: ' + JSON.stringify(DocumentSelectResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('DocumentViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(option?: DocumentSaveOptions): Promise<Array<string>>

通过保存模式拉起documentPicker界面，用户可以保存一个或多个文件。接口采用Promise异步返回形式，传入可选参数DocumentSaveOptions对象，返回保存文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
选择DocumentSaveOptions否documentPicker保存选项，若无此参数，则拉起documentPicker界面后需用户自行输入保存的文件名

返回值：

类型说明
Promise<Array<string>>Promise对象。返回documentPicker保存后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example10() {
  try {
    let DocumentSaveOptions = new picker.DocumentSaveOptions();
    DocumentSaveOptions.newFileNames = ['DocumentViewPicker01.txt'];
    let documentPicker = new picker.DocumentViewPicker();
    documentPicker.save(DocumentSaveOptions).then((DocumentSaveResult: Array<string>) => {
      console.info('DocumentViewPicker.save successfully, DocumentSaveResult uri: ' + JSON.stringify(DocumentSaveResult));
    }).catch((err: BusinessError) => {
      console.error('DocumentViewPicker.save failed with err: ' + JSON.stringify(err));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('DocumentViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(option: DocumentSaveOptions, callback: AsyncCallback<Array<string>>): void

通过保存模式拉起documentPicker界面，用户可以保存一个或多个文件。接口采用callback异步返回形式，传入参数DocumentSaveOptions对象，返回保存文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
选择DocumentSaveOptions是documentPicker保存选项
回调AsyncCallback<Array<string>>是callback 返回documentPicker保存后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example11() {
  try {
    let DocumentSaveOptions = new picker.DocumentSaveOptions();
    DocumentSaveOptions.newFileNames = ['DocumentViewPicker02.txt'];
    let documentPicker = new picker.DocumentViewPicker();
    documentPicker.save(DocumentSaveOptions, (err: BusinessError, DocumentSaveResult: Array<string>) => {
      if (err) {
        console.error('DocumentViewPicker.save failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('DocumentViewPicker.save successfully, DocumentSaveResult uri: ' + JSON.stringify(DocumentSaveResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('DocumentViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(callback: AsyncCallback<Array<string>>): void

通过保存模式拉起documentPicker界面，用户可以保存一个或多个文件。接口采用callback异步返回形式，返回保存文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
callbackAsyncCallback<Array<string>>是callback 返回documentPicker保存后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example12() {
  try {
    let documentPicker = new picker.DocumentViewPicker();
    documentPicker.save((err: BusinessError, DocumentSaveResult: Array<string>) => {
      if (err) {
        console.error('DocumentViewPicker.save failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('DocumentViewPicker.save successfully, DocumentSaveResult uri: ' + JSON.stringify(DocumentSaveResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('DocumentViewPicker failed with err: ' + JSON.stringify(err));
  }
}

AudioViewPicker

音频选择器对象，用来支撑选择和保存音频类文件等用户场景。在使用前，需要先创建AudioViewPicker实例。

系统能力：SystemCapability.FileManagement.UserFileService

示例：

let audioPicker = new picker.AudioViewPicker();

select

select(option?: AudioSelectOptions): Promise<Array<string>>

通过选择模式拉起audioPicker界面（目前拉起的是documentPicker，audioPicker在规划中），用户可以选择一个或多个音频文件。接口采用Promise异步返回形式，传入可选参数AudioSelectOptions对象，返回选择音频文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
optionAudioSelectOptions否audioPicker音频选择选项，若无此参数，则默认拉起audioPicker主界面

返回值：

类型说明
Promise<Array<string>>Promise对象。返回audioPicker选择音频后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example13() {
  try {
    let AudioSelectOptions = new picker.AudioSelectOptions();
    let audioPicker = new picker.AudioViewPicker();
    audioPicker.select(AudioSelectOptions).then((AudioSelectResult: Array<string>) => {
      console.info('AudioViewPicker.select successfully, AudioSelectResult uri: ' + JSON.stringify(AudioSelectResult));
    }).catch((err: BusinessError) => {
      console.error('AudioViewPicker.select failed with err: ' + JSON.stringify(err));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('AudioViewPicker failed with err: ' + JSON.stringify(err));
  }
}

select

select(option: AudioSelectOptions, callback: AsyncCallback<Array<string>>): void

通过选择模式拉起audioPicker界面（目前拉起的是documentPicker，audioPicker在规划中），用户可以选择一个或多个音频文件。接口采用callback异步返回形式，传入参数AudioSelectOptions对象，返回选择音频文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
optionAudioSelectOptions是audioPicker音频选择选项
callbackAsyncCallback<Array<string>>是callback 返回audioPicker选择音频后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example14() {
  try {
    let AudioSelectOptions = new picker.AudioSelectOptions();
    let audioPicker = new picker.AudioViewPicker();
    audioPicker.select(AudioSelectOptions, (err: BusinessError, AudioSelectResult: Array<string>) => {
      if (err) {
        console.error('AudioViewPicker.select failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('AudioViewPicker.select successfully, AudioSelectResult uri: ' + JSON.stringify(AudioSelectResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('AudioViewPicker failed with err: ' + JSON.stringify(err));
  }
}

select

select(callback: AsyncCallback<Array<string>>): void

通过选择模式拉起audioPicker界面（目前拉起的是documentPicker，audioPicker在规划中），用户可以选择一个或多个音频文件。接口采用callback异步返回形式，返回选择音频文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
回调AsyncCallback<Array<string>>是callback 返回audioPicker选择音频后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example15() {
  try {
    let audioPicker = new picker.AudioViewPicker();
    audioPicker.select((err: BusinessError, AudioSelectResult: Array<string>) => {
      if (err) {
        console.error('AudioViewPicker.select failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('AudioViewPicker.select successfully, AudioSelectResult uri: ' + JSON.stringify(AudioSelectResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('AudioViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(option?: AudioSaveOptions): Promise<Array<string>>

通过保存模式拉起audioPicker界面（目前拉起的是documentPicker，audioPicker在规划中），用户可以保存一个或多个音频文件。接口采用Promise异步返回形式，传入可选参数AudioSaveOptions对象，返回保存音频文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
选择AudioSaveOptions否audioPicker保存音频文件选项，若无此参数，则拉起audioPicker界面后需用户自行输入保存的文件名

返回值：

类型说明
Promise<Array<string>>Promise对象。返回audioPicker保存音频文件后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example16() {
  try {
    let AudioSaveOptions = new picker.AudioSaveOptions();
    AudioSaveOptions.newFileNames = ['AudioViewPicker01.mp3'];
    let audioPicker = new picker.AudioViewPicker();
    audioPicker.save(AudioSaveOptions).then((AudioSaveResult: Array<string>) => {
      console.info('AudioViewPicker.save successfully, AudioSaveResult uri: ' + JSON.stringify(AudioSaveResult))
    }).catch((err: BusinessError) => {
      console.error('AudioViewPicker.save failed with err: ' + JSON.stringify(err));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('AudioViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(option: AudioSaveOptions, callback: AsyncCallback<Array<string>>): void

通过保存模式拉起audioPicker界面（目前拉起的是documentPicker，audioPicker在规划中），用户可以保存一个或多个音频文件。接口采用callback异步返回形式，传入参数AudioSaveOptions对象，返回保存音频文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
optionAudioSaveOptions是audioPicker保存音频文件选项
callbackAsyncCallback<Array<string>>是callback 返回audioPicker保存音频文件后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example17() {
  try {
    let AudioSaveOptions = new picker.AudioSaveOptions();
    AudioSaveOptions.newFileNames = ['AudioViewPicker02.mp3'];
    let audioPicker = new picker.AudioViewPicker();
    audioPicker.save(AudioSaveOptions, (err: BusinessError, AudioSaveResult: Array<string>) => {
      if (err) {
        console.error('AudioViewPicker.save failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('AudioViewPicker.save successfully, AudioSaveResult uri: ' + JSON.stringify(AudioSaveResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('AudioViewPicker failed with err: ' + JSON.stringify(err));
  }
}

save

save(callback: AsyncCallback<Array<string>>): void

通过保存模式拉起audioPicker界面（目前拉起的是documentPicker，audioPicker在规划中），用户可以保存一个或多个音频文件。接口采用callback异步返回形式，返回保存音频文件的uri数组。

注意：此接口返回的uri数组的具体使用方式参见用户文件uri介绍中的文档类uri的使用方式。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

参数名类型必填说明
callbackAsyncCallback<Array<string>>是callback 返回audioPicker保存音频文件后的结果集

示例：

import { BusinessError } from '@ohos.base';
async function example18() {
  try {
    let audioPicker = new picker.AudioViewPicker();
    audioPicker.save((err: BusinessError, AudioSaveResult: Array<string>) => {
      if (err) {
        console.error('AudioViewPicker.save failed with err: ' + JSON.stringify(err));
        return;
      }
      console.info('AudioViewPicker.save successfully, AudioSaveResult uri: ' + JSON.stringify(AudioSaveResult));
    });
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('AudioViewPicker failed with err: ' + JSON.stringify(err));
  }
}

PhotoViewMIMETypes

枚举，可选择的媒体文件类型。

系统能力： SystemCapability.FileManagement.UserFileService

名称值说明
IMAGE_TYPE'image/*'图片类型
VIDEO_TYPE'video/*'视频类型
IMAGE_VIDEO_TYPE'*/*'图片和视频类型

PhotoSelectOptions

图库选择选项。

系统能力： SystemCapability.FileManagement.UserFileService

名称类型必填说明
MIMETypePhotoViewMIMETypes否可选择的媒体文件类型，若无此参数，则默认为图片和视频类型
maxSelectNumbernumber否选择媒体文件数量的最大值(默认值为50，最大值为500)

PhotoSelectResult

返回图库选择后的结果集。

系统能力： SystemCapability.FileManagement.UserFileService

名称类型可读可写说明
photoUris数组<字符串>是是返回图库选择后的媒体文件的uri数组，此uri数组只能通过临时授权的方式调用photoAccessHelper.getAssets接口去使用，具体使用方式参见用户文件uri介绍中的媒体文件uri的使用方式。
isOriginalPhoto布尔是是返回图库选择后的媒体文件是否为原图。

PhotoSaveOptions

图片或视频的保存选项。

系统能力： SystemCapability.FileManagement.UserFileService

名称类型必填说明
newFileNames数组<字符串>否拉起photoPicker进行保存图片或视频资源的文件名，若无此参数，则默认需要用户自行输入

DocumentSelectOptions

文档选择选项。

系统能力： SystemCapability.FileManagement.UserFileService

名称类型必填说明
maxSelectNumber10+数否选择文件/目录最大个数，上限500，有效值范围1-500
defaultFilePathUri10+字符串否指定选择的文件或者目录路径
fileSuffixFilters10+数组<字符串>否选择文件的后缀类型，若选择项存在多个后缀名，则每一个后缀名之间用英文逗号进行分隔

DocumentSaveOptions

文档保存选项。

系统能力： SystemCapability.FileManagement.UserFileService

名称类型必填说明
newFileNames数组<字符串>否拉起documentPicker进行保存的文件名，若无此参数，则默认需要用户自行输入
defaultFilePathUri10+字符串否指定保存的文件或者目录路径
fileSuffixChoices10+数组<字符串>否保存文件的后缀类型

AudioSelectOptions

音频选择选项，目前不支持参数配置。

系统能力： SystemCapability.FileManagement.UserFileService

AudioSaveOptions

音频的保存选项。

系统能力： SystemCapability.FileManagement.UserFileService

名称类型必填说明
newFileNames数组<字符串>否拉起audioPicker进行保存音频资源的文件名，若无此参数，则默认需要用户自行输入

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

蜀道衫QAQ
关注
专栏目录
【HarmonyOS实战开发】鸿蒙系统图片视频选择器之Flutter插件实践
好运来的博客
08-30 1097
本文主要在Fanbook原有图片选择器插件的基础上，新增鸿蒙系统支持，实现了针对鸿蒙系统特定图片视频选器，里面包含了图片压缩、图片基础信息获取、视频压缩、获取视频基本信息、取视频封面等操作。当然，在实现这块需求的过程中，遇到了不少的问题和解决方案，我挑选了几条核心功能点来和大家分享，相信看完之后，对于鸿蒙系统的图片选择器实现有一定的帮助。阅读本文需要有一个定Flutter插件开发基础和鸿蒙ArkTS开发基础。
鸿蒙实战开发-如何实现时钟、闹钟、倒计时、设置屏幕亮度相功能
2401_82546228的博客
04-01 2247
本示例集中展示了时钟、闹钟、倒计时、设置屏幕亮度相关的场景，
鸿蒙OS开发实战：时间日期选择器-picker
最新发布
2401_84917132的博客
08-16 825
picker是滑动选择器组件，类型支持普通选择器、日期选择器、时间选择器、时间日期选择器和多列文本选择器。
【HarmonyOS NEXT】鸿蒙系统文件选择器（FilePicker）选择用户文件
wu1004019946的博客
06-14 1689
用户有时需要分享或保存图片、视频等用户文件，开发者可以通过系统预置的，实现该能力。通过Picker访问相关文件，将拉起对应的应用，引导用户完成界面操作，接口本身无需申请权限。：适用于图片或视频类型文件的选择与保存。优选使用来选择文件。当前PhotoViewPicker对接的选择资源来自于图库，保存位置为系统文件管理器的特定目录，因此使用save接口保存的图片或视频无法在图库中展示。如需在图库中展示，请使用。：适用于文件类型文件的选择与保存。
Harmony OS — Picker滑动选择器
qq_27494201的博客
06-26 617
文章目录1、Picker2、简单实现3、实战1：简单样式4、实战2：更多样式5、了解更多 1、Picker ##1、Picker 是什么？ Picker提供了滑动选择器，允许用户从预定义范围中进行选择。 2、简单实现 在XML中创建Picker <Picker ohos:id="$+id:test_picker" ohos:height="match_content" ohos:width="300vp" ohos:background_element="#E1F
鸿蒙开发之图片选择器
Lu_Ca的博客
12-26 1183
长按图片，给图片添加一个抖动的动画。这里借助了z轴旋转动画实现。系统的图片选择器真的非常友好，这个绝对要赞一下。
harmonyOS checkbox,Selector在HarmonyOS中的使用
weixin_39522103的博客
05-27 161
Selector其实就是一组状态列表(StateList)，可以将不同的状态关联不同的效果，主要用于设置控件背景和字体颜色等。控件一共有7种状态，常用的有：空状态empty，按下状态pressed，获取焦点focused，勾选状态checked，不可用状态disable。鸿蒙中selector效果可以通过xml的state-container标签或者在代码中使用StateElement来实现，下面...
鸿蒙开发-图片管理
hubangquan的博客
04-23 1037
鸿蒙开发，图片解码、编码、处理、选择、下载等操作总结
vue-emoji-picker-高度可定制的unicode表情符号选择器:fire::rocket:-Vue.js开发
05-27
用于Vue 2的高度可定制的表情符号选择器目录通过npm进行的演示安装，带有CDN导入通过ES6捆绑器（通过npm）使用每个compon用于Vue 2的高度可定制的表情符号选择器，目录，通过npm进行演示安装，带有CDN导入，通过一个...
前端picker.js 选择器 轮选择器
05-04
<title>Picker by ustbhuangyi , initial-scale=1,maximum-scale=1.0, minimum-scale=1.0, user-scalable=no"> <h1 class="project-name">Picker <h2 class="project-tagline">h5 picker inspired by ios ...
鸿蒙开发图形图像——@ohos.effectKit (图像效果)
2401_82772199的博客
02-22 805
图像效果提供处理图像的一些基础能力，包括对当前图像的亮度调节、模糊化、灰度调节、智能取色等。NOTE本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
HarmonyOS鸿蒙开发指南:基础组件 picker开发指导
sybh的博客
01-09 1095
通过设置Picker的type属性来选择滑动选择器类型，如定义Picker为日期选择器。Picker的hours属性定义时间的展现格式，可选类型有12小时制和24小时制。对Picker添加change和cancel事件，来对选择的内容进行确定和取消。hours属性为12：按照12小时制显示，用上午和下午进行区分；在本场景中，开发者可以自定义填写当前的健康情况来进行打卡。普通选择器设置取值范围时，需要使用数据绑定的方式。hours属性为24：按照24小时制显示。
HarmonyOS应用开发实战 - Api9 拍照、拍视频、选择图片、选择视频、选择文件工具类
莫言情怼的博客
03-19 1298
Api9 图库选择
【鸿蒙应用ArkTS开发系列】- 选择图片、文件和拍照功能实现
枫的专栏
11-28 6231
在使用App的时候，我们经常会在一些社交软件中聊天时发一些图片或者文件之类的多媒体文件，那在鸿蒙原生应用中，我们怎么开发这样的功能呢？本文会给大家对这个功能点进行讲解，我们采用的是拉起系统组件来进行图片、文件的选择，拉起系统相机进行拍照的这样一种实现方式。
HarmonyOS NEXT星河版之实战商城App瀑布流(含加载更多)
小洋人最happy的专栏
04-17 738
【代码】HarmonyOS NEXT星河版之实战商城App瀑布流(含加载更多)
【前端寻宝之路】学习和使用CSS的所有选择器
“路漫漫其修远兮，吾将上下求索。”
03-12 1756
学习和使用CSS的所有选择器
HarmonyOS Next开发学习手册——保存用户文件
maniuT的博客
07-25 1054
在从网络下载文件到本地、或将已有用户文件另存为新的文件路径等场景下，需要使用FilePicker提供的保存用户文件的能力。picker获取的uri只具有临时权限，获取持久化权限需要通过 FilePicker设置永久授权 方式获取。对音频、图片、视频、文档类文件的保存操作类似，均通过调用对应picker的save()接口并传入对应的saveOptions来实现。通过Picker访问相关文件，无需申请权限。
鸿蒙原生应用/元服务开发-利用picker选择器来多选相册图片
weixin_69135651的博客
12-01 1406
在之前的时候，测试一个应用进入相册选择图片demo，利用了startAbilityForResult()方法，启动相对应的Ability来完成效果，但是这种方法有限制，一次只能获取一张图片，在完成某些功能测试的时候就很不方便。通过选择模式拉起photoPicker界面，用户可以选择一个或多个图片/视频。图库选择器对象，用来支撑选择图片/视频和保存图片/视频等用户场景。在使用前，需要先创建PhotoViewPicker实例。@ohos.file.picker (选择器)，直接完成对相册里面图片的选择和多选。
2021-08-20 HarmonyOS实战 Picker的使用
热门推荐
时光隧道
08-20 5万+
<?xml version="1.0" encoding="utf-8"?> <DirectionalLayout xmlns:ohos="http://schemas.huawei.com/res/ohos" ohos:height="match_parent" ohos:width="match_parent" ohos:alignment="center" ohos:orientation="horizontal"> <Picke
Bootstrap时间选择器实战：datetimepicker与daterangepicker解析
本文将详细介绍Bootstrap时间选择器中的datetimepicker和daterangepicker的使用方法和实例，帮助开发者理解和应用这两个插件。 Bootstrap是一个流行的前端开发框架，提供了丰富的组件和插件来简化网页设计和开发。...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值