From d5cf807d79730684851aaf01328c4c3733fd89d3 Mon Sep 17 00:00:00 2001 From: panqiangbiao Date: Mon, 7 Mar 2022 19:03:41 +0800 Subject: [PATCH] fix code issue Signed-off-by: panqiangbiao --- .../reference/apis/js-apis-medialibrary.md | 309 ++++++++---------- 1 file changed, 137 insertions(+), 172 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md b/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md index cfe4281493..fe9cfe9d63 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md +++ b/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md @@ -10,28 +10,25 @@ import mediaLibrary from '@ohos.multimedia.medialibrary'; ``` - ## getMediaLibrary function getMediaLibrary(context: Context): MediaLibrary 获取媒体库的实例，用于访问和修改用户的个人数据信息。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------- | ------- | ---- | -------------------- | -| context | Context | 是 | API 8接口此参数是必填参数，传入Ability实例的context，获取媒体库 | +| context | Context | 是 | API7以下接口可不传此参数，API 8以上接口此参数是必填参数，传入Ability实例的context，获取媒体库 | **返回值：** | 类型 | 说明 | | ------------ | :----- | -| MediaLibrary | 媒体库实例 | +| [MediaLibrary](#MediaLibrary) | 媒体库实例 | **示例：** @@ -56,10 +53,10 @@ getFileAssets(options: MediaFetchOptions, callback: AsyncCallback<FetchFileRe **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ----------------------------------------------------------- | ---- | --------------------------------- | -| options | [MediaFetchOptions](#MediaFetchOptions) | 是 | 媒体获取选项 | -| callback | AsyncCallback<[FetchFileResult](#FetchFileResult.getCount)> | 是 | 异步获取FetchFileResult之后的回调 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------------- | ---- | --------------------------------- | +| options | [MediaFetchOptions](#mediafetchoptions8) | 是 | 媒体获取选项 | +| callback | AsyncCallback<[FetchFileResult](#fetchfileresult8)> | 是 | 异步获取FetchFileResult之后的回调 | **示例：** @@ -93,15 +90,15 @@ getFileAssets(options: MediaFetchOptions): Promise<FetchFileResult> **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------- | --------------------------------------- | ---- | ------------ | -| options | [MediaFetchOptions](#MediaFetchOptions) | 是 | 媒体检索选项 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ---------------------------------------- | ---- | ------------ | +| options | [MediaFetchOptions](#mediafetchoptions8) | 是 | 媒体检索选项 | **返回值** -| 类型 | 说明 | -| -------------------------------------------- | -------------- | -| [FetchFileResult](#FetchFileResult.getCount) | 媒体数据结果集 | +| 类型 | 说明 | +| ----------------------------- | -------------- | +| [FetchFileResult](#fetchfileresult8) | 媒体数据结果集 | **示例：** @@ -125,8 +122,6 @@ on(type: 'deviceChange'|'albumChange'|'imageChange'|'audioChange'|'videoChange'| 打开媒体媒体库变更通知，使用callback方式返回异步结果。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **参数：** @@ -149,17 +144,13 @@ off(type: 'deviceChange'|'albumChange'|'imageChange'|'audioChange'|'videoChange' 关闭媒体媒体库变更通知，使用callback方式返回异步结果。 -变更通知类型包括：注册设备变更，相册变更，图片文件变更，音频文件变更，视频文件变更，文件变更，远端文件变更。 - -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------- | ---- | ------------------- | -| type | type | 是 | 媒体类型
'deviceChange'： 注册设备变更
'albumChange'： 相册变更
'imageChange'： 图片文件变更
'audioChange'：  音频文件变更
'videoChange'：  视频文件变更
'fileChange'：  文件变更
'remoteFileChange'： 注册设备上文件变更 | +| type | string | 是 | 媒体类型
'deviceChange'： 注册设备变更
'albumChange'： 相册变更
'imageChange'： 图片文件变更
'audioChange'：  音频文件变更
'videoChange'：  视频文件变更
'fileChange'：  文件变更
'remoteFileChange'： 注册设备上文件变更 | | callback | callback<void> | 否 | 回调返回空 | **示例：** @@ -182,12 +173,12 @@ createAsset(mediaType: MediaType, displayName: string, relativePath: string, cal **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------------ | -------------------------------------- | ---- | ------------------------------------------------------------ | -| mediaType | [MediaType](#MediaType) | 是 | 媒体类型 | -| displayName | string | 是 | 展示文件名 | -| relativePath | string | 是 | 相对公共目录路径，可以通过getPublicDirectory获取不同类型媒体文件的一层目录的relative path | -| callback | AsyncCallback<[FileAsset](#FileAsset)> | 是 | 异步获取媒体数据FileAsset之后的回调 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------ | --------------------------------------- | ---- | ------------------------------------------------------------ | +| mediaType | [MediaType](#MediaType) | 是 | 媒体类型 | +| displayName | string | 是 | 展示文件名 | +| relativePath | string | 是 | 相对公共目录路径，可以通过getPublicDirectory获取不同类型媒体文件的一层目录的relative path | +| callback | AsyncCallback<[FileAsset](#fileasset8)> | 是 | 异步获取媒体数据FileAsset之后的回调 | **示例：** @@ -224,9 +215,9 @@ createAsset(mediaType: MediaType, displayName: string, relativePath: string): Pr **返回值** -| 类型 | 说明 | -| ----------------------- | ----------------- | -| [FileAsset](#FileAsset) | 媒体数据FileAsset | +| 类型 | 说明 | +| ------------------------ | ----------------- | +| [FileAsset](#fileasset8) | 媒体数据FileAsset | **示例：** @@ -245,9 +236,7 @@ mediaLibrary.createAsset(mediaType, "image01.jpg", path).then (function (asset) getPublicDirectory(type: DirectoryType, callback: AsyncCallback<string>): void -获取公共目录路径 - -**需要权限**：无 +获取公共目录路径，使用callback方式返回结果。 **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core @@ -255,10 +244,9 @@ getPublicDirectory(type: DirectoryType, callback: AsyncCallback<string>): | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------------- | ---- | ------------ | -| type | [DirectoryType](#DirectoryType) | 是 | 公共目录类型 | +| type | [DirectoryType](#directorytype) | 是 | 公共目录类型 | | callback |AsyncCallback<string> | 是 | callback 返回公共目录路径 | - **示例：** ``` @@ -276,9 +264,7 @@ media.getPublicDirectory(DIR_CAMERA, (err, dicResult) => { getPublicDirectory(type: DirectoryType): Promise<string> -获取公共目录路径 - -**需要权限**：无 +获取公共目录路径，使用Promise方式返回结果。 **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core @@ -286,7 +272,7 @@ getPublicDirectory(type: DirectoryType): Promise<string> | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------------- | ---- | ------------ | -| type | [DirectoryType](#DirectoryType) | 是 | 公共目录类型 | +| type | [DirectoryType](#directorytype) | 是 | 公共目录类型 | **返回值：** @@ -308,7 +294,7 @@ async function example() { } ``` -### getAlbums6+ +### getAlbums8+ getAlbums(options: MediaFetchOptions, callback: AsyncCallback): void @@ -320,10 +306,10 @@ getAlbums(options: MediaFetchOptions, callback: AsyncCallback> | 是 | 异步获取Album列表之后的回调 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------------- | ---- | --------------------------- | +| options | [MediaFetchOptions](#mediafetchoptions8) | 是 | 媒体文件获取条件 | +| callback | AsyncCallback<Array<[Album](#album8)>> | 是 | 异步获取Album列表之后的回调 | **示例：** @@ -343,7 +329,7 @@ mediaLibrary.getAlbums(AlbumNoArgsfetchOp, (err, albumList) => { }) ``` -### getAlbums6+ +### getAlbums8+ getAlbums(options: MediaFetchOptions): Promise @@ -355,15 +341,15 @@ getAlbums(options: MediaFetchOptions): Promise **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------- | --------------------------------------- | ---- | ---------------- | -| options | [MediaFetchOptions](#MediaFetchOptions) | 是 | 媒体文件获取条件 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ---------------------------------------- | ---- | ---------------- | +| options | [MediaFetchOptions](#mediafetchoptions8) | 是 | 媒体文件获取条件 | **返回值：** -| 类型 | 说明 | -| ------------------------------- | ------------- | -| Promise> | 返回Album列表 | +| 类型 | 说明 | +| -------------------------------- | ------------- | +| Promise> | 返回Album列表 | **示例：** @@ -383,9 +369,8 @@ mediaLibrary.getAlbums(AlbumNoArgsfetchOp).then(function(albumList){ release(callback: AsyncCallback<void>): void -释放mediaLibrary实例，当用户确认后续不再使用mediaLibrary实例中的方法后调用release方法释放mediaLibrary实例。 - -**需要权限**：无 +释放MediaLibrary实例。 +当后续不需要使用MediaLibrary实例中的方法时调用。 **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core @@ -408,9 +393,8 @@ media.release((err, data) => { release(): Promise<void> -释放mediaLibrary实例，当用户确认后续不再使用mediaLibrary实例中的方法后调用release方法释放mediaLibrary实例。 - -**需要权限**：无 +释放MediaLibrary实例。 +当后续不需要使用MediaLibrary实例中的方法时调用。 **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core @@ -433,34 +417,34 @@ media.release() ### **属性** -| 名称 | 类型 | 可读 | 可写 | 说明 | -| ------------ | --------- | ---- | ---- | ------------------------------------------------------ | -| id | number | 是 | 否 | 文件资源编号 | -| uri | string | 是 | 否 | 文件资源uri（如：dataability:///media/image/2) | -| mimeType | string | 是 | 否 | 文件扩展属性 | -| mediaType | MediaType | 是 | 否 | 媒体类型 | -| displayName | string | 是 | 是 | 显示文件名 | -| title | string | 是 | 是 | 文件标题 | -| relativePath | string | 是 | 是 | 相对公共目录路径 | -| parent | number | 是 | 否 | 父目录id | -| size | number | 是 | 否 | 文件大小(单位：字节) | -| dateAdded | number | 是 | 否 | 添加日期（添加文件时间到1970年1月1日的秒数值） | -| dateModified | number | 是 | 否 | 修改日期（修改文件时间到1970年1月1日的秒数值） | -| dateTaken | number | 是 | 否 | 拍摄日期（文件拍照时间到1970年1月1日的秒数值） | -| artist | string | 是 | 否 | 作者 | -| audioAlbum | string | 是 | 否 | 专辑 | -| width | number | 是 | 否 | 图片宽度（单位：像素） | -| height | number | 是 | 否 | 图片高度（单位：像素） | -| orientation | number | 是 | 是 | 图片显示方向（顺时针旋转角度，如0，90，180 单位：度） | -| duration | number | 是 | 否 | 持续时间（单位：秒） | -| albumId | number | 是 | 否 | 文件所归属的相册编号 | -| albumUri | string | 是 | 否 | 文件所归属相册uri | -| albumName | string | 是 | 否 | 文件所归属相册名称 | +| 名称 | 类型 | 可读 | 可写 | 说明 | +| ------------ | ----------------------- | ---- | ---- | ------------------------------------------------------ | +| id | number | 是 | 否 | 文件资源编号 | +| uri | string | 是 | 否 | 文件资源uri（如：dataability:///media/image/2) | +| mimeType | string | 是 | 否 | 文件扩展属性 | +| mediaType | [MediaType](#mediaType) | 是 | 否 | 媒体类型 | +| displayName | string | 是 | 是 | 显示文件名 | +| title | string | 是 | 是 | 文件标题 | +| relativePath | string | 是 | 是 | 相对公共目录路径 | +| parent | number | 是 | 否 | 父目录id | +| size | number | 是 | 否 | 文件大小（单位：字节） | +| dateAdded | number | 是 | 否 | 添加日期（添加文件时间到1970年1月1日的秒数值） | +| dateModified | number | 是 | 否 | 修改日期（修改文件时间到1970年1月1日的秒数值） | +| dateTaken | number | 是 | 否 | 拍摄日期（文件拍照时间到1970年1月1日的秒数值） | +| artist | string | 是 | 否 | 作者 | +| audioAlbum | string | 是 | 否 | 专辑 | +| width | number | 是 | 否 | 图片宽度（单位：像素） | +| height | number | 是 | 否 | 图片高度（单位：像素） | +| orientation | number | 是 | 是 | 图片显示方向（顺时针旋转角度，如0，90，180 单位：度） | +| duration | number | 是 | 否 | 持续时间（单位：秒） | +| albumId | number | 是 | 否 | 文件所归属的相册编号 | +| albumUri | string | 是 | 否 | 文件所归属相册uri | +| albumName | string | 是 | 否 | 文件所归属相册名称 | ### isDirectory8+ -isDirectory(callback: AsyncCallback<boolean>): void; +isDirectory(callback: AsyncCallback<boolean>): void 判断fileAsset是否为目录，使用callback方式返回异步结果。 @@ -614,7 +598,7 @@ open(mode: string, callback: AsyncCallback<number>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------- | ---- | -------------------- | -| mode | string | 是 | 打开文件方式，如：'r', 'w', 'rw' | +| mode | string | 是 | 打开文件方式，如：'r'（只读）, 'w'（只写）, 'rw'（读写） | | callback | AsyncCallback<number> | 是 | 回调返回文件句柄 | **示例：** @@ -646,9 +630,9 @@ open(mode: string): Promise<number> **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------ | ---- | -------------------------------- | -| mode | string | 是 | 打开文件方式，如：'r', 'w', 'rw' | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------------------------------------- | +| mode | string | 是 | 打开文件方式，如：'r'（只读）, 'w'（只写）, 'rw'（读写） | **返回值：** @@ -810,7 +794,7 @@ getThumbnail(size: Size, callback: AsyncCallback<image.PixelMap>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------- | ---- | -------------------- | -| size | [Size](#Size) | 是 | 缩略图尺寸 | +| size | [Size](#size8) | 是 | 缩略图尺寸 | | callback | AsyncCallback<image.PixelMap> | 是 | 回调返回缩略图的PixelMap | **示例：** @@ -844,9 +828,9 @@ getThumbnail(size?: Size): Promise<image.PixelMap> **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------------- | ---- | ---------- | -| size | [Size](#Size) | 否 | 缩略图尺寸 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | -------------- | ---- | ---------- | +| size | [Size](#size8) | 否 | 缩略图尺寸 | **返回值：** @@ -887,7 +871,7 @@ favorite(isFavorite: boolean, callback: AsyncCallback<void>): void | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------- | ---- | -------------- | -| isFavorite | boolean | 是 | 是否设置为收藏文件, true：设置为收藏文件，false：取消收藏 | +| isFavorite | boolean | 是 | 是否设置为收藏文件， true：设置为收藏文件，false：取消收藏 | | callback | AsyncCallback<void> | 是 | 回调返回空 | **示例：** @@ -921,9 +905,9 @@ favorite(isFavorite: boolean): Promise<void> **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ---------- | ------- | ---- | --------------------------------------------------------- | -| isFavorite | boolean | 是 | 是否设置为收藏文件, true：设置为收藏文件，false：取消收藏 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------- | ---- | ---------------------------------------------------------- | +| isFavorite | boolean | 是 | 是否设置为收藏文件， true：设置为收藏文件，false：取消收藏 | **返回值：** @@ -1160,7 +1144,7 @@ async function example() { isTrash():Promise<boolean> -当文件被定位，设置文件为垃圾文件，使用promise方式返回异步结果。 +当文件被定位，判断文件是否为垃圾文件，使用promise方式返回异步结果。 **需要权限**：ohos.permission.READ_MEDIA @@ -1193,7 +1177,7 @@ async function example() { } ``` -## **FetchFileResult**8+ +## FetchFileResult8+ 文件检索结果集。 @@ -1203,8 +1187,6 @@ getCount(): number 获取文件检索结果中的文件总数。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **返回值**： @@ -1234,15 +1216,13 @@ isAfterLast(): boolean 检查结果集是否指向最后一行。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **返回值**： -| 类型 | 说明 | -| ------- | ------------------------------------------------------------ | -| boolean | 当读到最后一条记录后，再继续读就到结果集尾了，没有记录了，执行isAfterLast()方法就返回true，否则返回false | +| 类型 | 说明 | +| ------- | ----------------------------------------------------------- | +| boolean | 当读到最后一条记录后，后续没有记录返回true，否则返回false。 | **示例**： @@ -1279,8 +1259,6 @@ close(): void 释放 FetchFileResult 实例并使其失效。无法调用其他方法。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **示例**： @@ -1305,15 +1283,13 @@ getFirstObject(callback: AsyncCallback<FileAsset>): void 获取文件检索结果中的第一个文件资产。此方法使用回调返回FileAsset。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------------------------------------------- | ---- | ------------------------------------------- | -| callback | AsyncCallback<[FileAsset](#FileAsset)> | 是 | 异步获取结果集中第一个FileAsset完成后的回调 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------------- | ---- | ------------------------------------------- | +| callback | AsyncCallback<[FileAsset](#fileasset8)> | 是 | 异步获取结果集中第一个FileAsset完成后的回调 | **示例**： @@ -1343,16 +1319,13 @@ getFirstObject(): Promise<FileAsset> 获取文件检索结果中的第一个文件资产。此方法使用返回FileAsset。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **返回值**： | 类型 | 说明 | | ------------------ | -------------------------------------- | -| Promise<[FileAsset](#FileAsset)> | Promise方式返回FileAsset | - +| Promise<[FileAsset](#fileasset8)> | Promise方式返回FileAsset | **示例**： @@ -1386,9 +1359,9 @@ async function example() { **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| --------- | -------------------------------------------- | ---- | ----------------------------------------- | -| callbacke | AsyncCallback<[FileAsset](#FileAsset)> | 是 | 异步返回结果集中下一个FileAsset之后的回调 | +| 参数名 | 类型 | 必填 | 说明 | +| --------- | --------------------------------------------- | ---- | ----------------------------------------- | +| callbacke | AsyncCallback<[FileAsset](#fileasset8)> | 是 | 异步返回结果集中下一个FileAsset之后的回调 | **示例**： @@ -1426,7 +1399,7 @@ async function example() { | 类型 | 说明 | | -------------------------------- | ------------------- | -| Promise<[FileAsset](#FileAsset)> | 返回FileAsset对象 | +| Promise<[FileAsset](#fileasset8)> | 返回FileAsset对象 | **示例**： @@ -1452,15 +1425,13 @@ getLastObject(callback: AsyncCallback<FileAsset>): void 获取文件检索结果中的最后一个文件资产。此方法使用callback回调来返回FileAsset。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **参数**： -| 参数 | 类型 | 必填 | 说明 | -| -------- | -------------------------------------------- | ---- | --------------------------- | -| callback | AsyncCallback<[FileAsset](#FileAsset)> | 是 | 异步返回FileAsset之后的回调 | +| 参数 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------------- | ---- | --------------------------- | +| callback | AsyncCallback<[FileAsset](#fileasset8)> | 是 | 异步返回FileAsset之后的回调 | **示例**： @@ -1490,15 +1461,13 @@ getLastObject(): Promise<FileAsset> 获取文件检索结果中的最后一个文件资产。此方法使用Promise方式来返回FileAsset。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **返回值**： | 类型 | 说明 | | -------------------------------- | ------------------- | -| Promise<[FileAsset](#FileAsset)> | 返回FileAsset对象 | +| Promise<[FileAsset](#fileasset8)> | 返回FileAsset对象 | **示例**： @@ -1522,16 +1491,14 @@ getPositionObject(index: number, callback: AsyncCallback<FileAsset>): void 获取文件检索结果中具有指定索引的文件资产。此方法使用回调来返回FileAsset。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **参数**： -| 参数 | 类型 | 必填 | 说明 | -| -------- | -------------------------------------------- | ---- | --------------------------- | -| index | number | 是 | 要获取的文件的索引，从0开始 | -| callback | AsyncCallback<[FileAsset](#FileAsset)> | 是 | 异步返回FileAsset之后的回调 | +| 参数 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------------- | ---- | --------------------------- | +| index | number | 是 | 要获取的文件的索引，从0开始 | +| callback | AsyncCallback<[FileAsset](#fileasset8)> | 是 | 异步返回FileAsset之后的回调 | **示例**： @@ -1575,7 +1542,7 @@ getPositionObject(index: number): Promise<FileAsset> | 类型 | 说明 | | -------------------------------- | ------------------- | -| Promise<[FileAsset](#FileAsset)> | 返回FileAsset对象 | +| Promise<[FileAsset](#fileasset8)> | 返回FileAsset对象 | **示例**： @@ -1611,9 +1578,9 @@ getAllObject(callback: AsyncCallback<Array<FileAsset>>): void **参数**： -| 参数 | 类型 | 必填 | 说明 | -| -------- | --------------------------------------------- | ---- | ------------------------------- | -| callback | AsyncCallback> | 是 | 异步返回FileAsset列表之后的回调 | +| 参数 | 类型 | 必填 | 说明 | +| -------- | ---------------------------------------------- | ---- | ------------------------------- | +| callback | AsyncCallback> | 是 | 异步返回FileAsset列表之后的回调 | **示例**： @@ -1643,15 +1610,13 @@ getAllObject(): Promise<Array<FileAsset>> 获取文件检索结果中的所有文件资产。此方法使用Promise来返回FileAsset结果集。 -**需要权限**：无 - **系统能力**：SystemCapability.Multimedia.MediaLibrary.Core **返回值**： -| 类型 | 说明 | -| --------------------------------------- | --------------------- | -| Promise> | 返回FileAsset对象列表 | +| 类型 | 说明 | +| ---------------------------------------- | --------------------- | +| Promise> | 返回FileAsset对象列表 | **示例**： @@ -1769,10 +1734,10 @@ getFileAssets(options: MediaFetchOptions, callback: AsyncCallback<FetchFileRe **参数**： -| 参数 | 类型 | 必填 | 说明 | -| -------- | ----------------------------------------------------------- | ---- | --------------------------------- | -| options | [MediaFetchOptions](#MediaFetchOptions) | 是 | 媒体检索选项 | -| callback | AsyncCallback<[FetchFileResult](#FetchFileResult.getCount)> | 是 | 异步返回FetchFileResult之后的回调 | +| 参数 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------------- | ---- | --------------------------------- | +| options | [MediaFetchOptions](#mediafetchoptions8) | 是 | 媒体检索选项 | +| callback | AsyncCallback<[FetchFileResult](#fetchfileresult8)> | 是 | 异步返回FetchFileResult之后的回调 | **示例**： @@ -1803,15 +1768,15 @@ async function example() { **参数**： -| 参数 | 类型 | 必填 | 说明 | -| ------- | --------------------------------------- | ---- | ------------ | -| options | [MediaFetchOptions](#MediaFetchOptions) | 否 | 媒体检索选项 | +| 参数 | 类型 | 必填 | 说明 | +| ------- | ---------------------------------------- | ---- | ------------ | +| options | [MediaFetchOptions](#mediafetchoptions8) | 否 | 媒体检索选项 | **返回值**： -| 类型 | 说明 | -| ----------------------------------------------------- | ----------------------- | -| Promise<[FetchFileResult](#FetchFileResult.getCount)> | 返回FetchFileResult对象 | +| 类型 | 说明 | +| --------------------------------------------- | ----------------------- | +| Promise<[FetchFileResult](#fetchfileresult8)> | 返回FetchFileResult对象 | **示例**： @@ -1861,27 +1826,27 @@ FileKey 枚举，文件关键信息。 -| 名称 | 默认值 | 描述 | -| ------------- | ------------------- | ------------------------------------------------------ | -| ID | file_id | 文件编号 | -| RELATIVE_PATH | relative_path | 相对公共目录路径 | -| DISPLAY_NAME | display_name | 显示名字 | -| PARENT | parent | 父目录id | -| MIME_TYPE | mime_type | 文件扩展属性 | -| MEDIA_TYPE | media_type | 媒体类型 | -| SIZE | size | 文件大小 | -| DATE_ADDED | date_added | 添加日期（添加文件时间到1970年1月1日的秒数值） | -| DATE_MODIFIED | date_modified | 修改日期（修改文件时间到1970年1月1日的秒数值） | -| DATE_TAKEN | date_taken | 拍摄日期（文件拍照时间到1970年1月1日的秒数值） | -| TITLE | title | 文件标题 | -| ARTIST | artist | 作者 | -| AUDIOALBUM | audio_album | 专辑 | -| DURATION | duration | 持续时间（单位：秒） | -| WIDTH | width | 图片宽度（单位：像素） | -| HEIGHT | height | 图片高度（单位：像素） | -| ORIENTATION | orientation | 图片显示方向（顺时针旋转角度，如0，90，180 单位：度） | -| ALBUM_ID | bucket_id | 文件所归属的相册编号 | -| ALBUM_NAME | bucket_display_name | 文件所归属相册名称 | +| 名称 | 默认值 | 描述 | +| ------------- | ------------------- | ---------------------------------------------------------- | +| ID | file_id | 文件编号 | +| RELATIVE_PATH | relative_path | 相对公共目录路径 | +| DISPLAY_NAME | display_name | 显示名字 | +| PARENT | parent | 父目录id | +| MIME_TYPE | mime_type | 文件扩展属性 | +| MEDIA_TYPE | media_type | 媒体类型 | +| SIZE | size | 文件大小（单位：字节） | +| DATE_ADDED | date_added | 添加日期（添加文件时间到1970年1月1日的秒数值） | +| DATE_MODIFIED | date_modified | 修改日期（修改文件时间到1970年1月1日的秒数值） | +| DATE_TAKEN | date_taken | 拍摄日期（文件拍照时间到1970年1月1日的秒数值） | +| TITLE | title | 文件标题 | +| ARTIST | artist | 作者 | +| AUDIOALBUM | audio_album | 专辑 | +| DURATION | duration | 持续时间（单位：秒） | +| WIDTH | width | 图片宽度（单位：像素） | +| HEIGHT | height | 图片高度（单位：像素） | +| ORIENTATION | orientation | 图片显示方向，即顺时针旋转角度，如0，90，180。（单位：度） | +| ALBUM_ID | bucket_id | 文件所归属的相册编号 | +| ALBUM_NAME | bucket_display_name | 文件所归属相册名称 | DirectoryType ------------- -- GitLab