diff --git a/zh-cn/application-dev/reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md b/zh-cn/application-dev/reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md index ee7935da6a2bdcb7e22a9554148885ecefca0193..6862a4ee52c840e7748eca31db5da871bf64f615 100644 --- a/zh-cn/application-dev/reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md +++ b/zh-cn/application-dev/reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md @@ -1722,6 +1722,116 @@ async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { } ``` +### getIndexConstructProgress12+ + +getIndexConstructProgress(): Promise<string> + +获取索引构建进度。使用Promise异步回调。 + +**系统接口**:此接口为系统接口。 + +**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core + +**需要权限**:ohos.permission.READ_IMAGEVIDEO + + +**返回值:** + +| 类型 | 说明 | +| --------------------------- | -------------- | +| Promise<string> | Promise对象,返回一个json格式的字符串。表示已完成智慧分析的图片数量、总数和已经完成智慧分析的视频数量、总数。 | + +**错误码:** + +以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 + + +| 错误码ID | 错误信息 | +| -------- | ---------------------------------------- | +| 201 | Permission denied. | +| 202 | Called by non-system application. | +| 14000011 | Internal system error. | + +**示例:** + +phAccessHelper的创建请参考[@ohos.file.photoAccessHelper (相册管理模块)](js-apis-photoAccessHelper.md)的示例使用。 + +```ts +async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { + + class indexProgress { + finishedImageCount: number = 0; + totalImageCount: number = 0; + finishedVideoCount: number = 0; + totalVideoCount: number = 0; + } + + try { + console.info('getIndexConstructProgress test start'); + let result: string = await phAccessHelper.getIndexConstructProgress(); + console.info('getIndexProgress:' + result); + + let jsonObj: indexProgress = JSON.parse(result); + // ...使用获取到的索引构建进度数据。 + } catch (err) { + console.error(`getIndexConstructProgress failed, error: ${err.code}, ${err.message}`); + } +} +``` + +### getDataAnalysisProgress12+ + +getDataAnalysisProgress(analysisType: AnalysisType): Promise<string> + +获取资产的分析进度。使用Promise异步回调。 + +**系统接口**:此接口为系统接口。 + +**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core + +**需要权限**:ohos.permission.READ_IMAGEVIDEO + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ---- | -------------- | ---- | ----- | +| analysisType | [AnalysisType](#analysistype11) | 是 | 需要获取的智慧分析类型。 | + +**返回值:** + +| 类型 | 说明 | +| --------------------------- | -------------- | +| Promise<string> | Promise对象,返回一个json格式的字符串。表示资产分析的进度。 | + +**错误码:** + +以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 + +| 错误码ID | 错误信息 | +| -------- | ---------------------------------------- | +| 201 | Permission denied. | +| 202 | Called by non-system application. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. | +| 14000011 | Internal system error. | + +**示例:** + +phAccessHelper的创建请参考[@ohos.file.photoAccessHelper (相册管理模块)](js-apis-photoAccessHelper.md)的示例使用。 + +```ts +async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { + try { + console.info('getDataAnalysisProgress test start'); + + let result: string = await phAccessHelper.getDataAnalysisProgress(photoAccessHelper.AnalysisType.ANALYSIS_FACE); + console.info('getDataAnalysisProgress:' + result); + + } catch (err) { + console.error(`getDataAnalysisProgress failed, error: ${err.code}, ${err.message}`); + } +} +``` + ### getSharedPhotoAssets13+ getSharedPhotoAssets(options: FetchOptions): Array\ @@ -8352,6 +8462,7 @@ async function example(context: Context) { | ANALYSIS\_HEAD\_POSITION12+ | 11 | 人头、宠物头位置分析类别。**系统接口**:此接口为系统接口。 | | ANALYSIS\_BONE\_POSE12+ | 12 | 人体骨骼点信息分析类别。**系统接口**:此接口为系统接口。 | | ANALYSIS\_VIDEO\_LABEL12+ | 13 | 视频标签。**系统接口**:此接口为系统接口。 | +| ANALYSIS\_HIGHLIGHT12+ | 14 | 时刻标签。**系统接口**:此接口为系统接口。 | ## HighlightAlbumInfoType12+