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 3ac0334967421d56989b039e0873ac65302246d8..a5970759c311e71c8f3e8e5e85d1099d083961b6 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 @@ -4622,6 +4622,7 @@ async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { | lpath18+ | string | 是 | 是 | 相册虚拟路径。
**系统接口**:此接口为系统接口。| | dateAdded18+ | number | 是 | 是 | 相册添加时间。
**系统接口**:此接口为系统接口。| | dateModified18+ | number | 是 | 是 | 相册修改时间。
**系统接口**:此接口为系统接口。| +| coverUriSource20+ | number | 是 | 是 | 相册封面来源。
**系统接口**:此接口为系统接口。| ### recoverAssets(deprecated) @@ -6332,6 +6333,53 @@ async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { } ``` +### resetCoverUri20+ + +resetCoverUri(): void + +恢复默认封面。 + +**系统接口**:此接口为系统接口。 + +**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core + +**错误码:** + +以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 + +| 错误码ID | 错误信息 | +| -------- | ---------------------------------------- | +| 202 | Called by non-system application. | +| 23800301 | Internal system error.It is recommended to retry and check the logs. Possible causes: 1. Database corrupted. 2. The file system is abnormal. 3. The IPC request timed out. | + +**示例:** + +phAccessHelper的创建请参考[@ohos.file.photoAccessHelper (相册管理模块)](js-apis-photoAccessHelper.md)的示例使用。 + +```ts +import { dataSharePredicates } from '@kit.ArkData'; + +async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { + console.info('resetCoverUriDemo'); + let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); + let fetchOptions: photoAccessHelper.FetchOptions = { + fetchColumns: [], + predicates: predicates + }; + try { + let albumFetchResult: photoAccessHelper.FetchResult = await phAccessHelper.getAlbums(photoAccessHelper.AlbumType.USER, photoAccessHelper.AlbumSubtype.USER_GENERIC); + let album: photoAccessHelper.Album = await albumFetchResult.getFirstObject(); + + let albumChangeRequest: photoAccessHelper.MediaAlbumChangeRequest = new photoAccessHelper.MediaAlbumChangeRequest(album); + albumChangeRequest.resetCoverUri(); + await phAccessHelper.applyChanges(albumChangeRequest); + console.info('resetCoverUri successfully'); + } catch (err) { + console.error(`resetCoverUriDemo failed with error: ${err.code}, ${err.message}`); + } +} +``` + ### moveAssets11+ moveAssets(assets: Array<PhotoAsset>, targetAlbum: Album): void @@ -9113,6 +9161,7 @@ async example() { | ALBUM_LPATH18+ | 'lpath' | 相册的虚拟路径。
**系统接口**:此接口为系统接口。 | | BUNDLE_NAME18+ | 'bundle_name' | 相册的包名。
**系统接口**:此接口为系统接口。 | | DATE_MODIFIED18+ | 'date_modified' | 相册修改的时间戳(单位:毫秒)。
**系统接口**:此接口为系统接口。 | +| COVER_URI_SOURCE20+ | 'cover_uri_source' | 相册封面的来源。
**系统接口**:此接口为系统接口。 | ## HiddenPhotosDisplayMode11+ @@ -9656,4 +9705,17 @@ async example() { | --- | --- | --- | --- | --- | | fileId | number | 是 | 否 | 图片id,必须为大于0的整数。 | | shareCount | number | 是 | 否 | 图片和视频被分享的次数,必须为大于0的整数。 | -| lcdJumpCount | number | 是 | 否 | 大图跳转分享等次数,必须为大于0的整数。 | \ No newline at end of file +| lcdJumpCount | number | 是 | 否 | 大图跳转分享等次数,必须为大于0的整数。 | + +## CoverUriSource20+ + +枚举,表示相册封面的来源。 + +**系统接口**:此接口为系统接口。 + +**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core + +| 名称 | 值 | 说明 | +| ------------------------- | ---- | -------------------------------- | +| DEFAULT_COVER | 0 | 默认封面。 | +| MANUAL_COVER | 1 | 手动设置的封面。 | \ No newline at end of file