openharmony 鸿蒙 js-apis-file-cloudsyncmanager

2026-08-25 浏览 (1)

@ohos.file.cloudSyncManager (端云同步管理能力)

该模块向云盘管理应用提供端云同步管理能力:包括全量下载的状态和停止原因,以及应用本地和云端文件数量信息。

说明:

本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import { cloudSyncManager } from '@kit.CoreFileKit';

DownloadStopReason20+

全量下载停止原因的枚举,默认值为NO_STOP。

系统能力:SystemCapability.FileManagement.DistributedFileService.CloudSyncManager

名称说明
NO_STOP0下载中未停止。
NETWORK_UNAVAILABLE1下载过程中,移动数据网络和WIFI均不可用。
LOCAL_STORAGE_FULL2下载过程中,当前设备空间不足。
TEMPERATURE_LIMIT3下载过程中,设备温度过高。
USER_STOPPED4下载过程中,客户端主动停止下载。
APP_UNLOAD5下载过程中,云文件所属应用被卸载。
OTHER_REASON6下载过程中,因其他原因停止下载,如:云服务器未响应等。

DownloadState20+

全量下载任务状态的枚举。

系统能力:SystemCapability.FileManagement.DistributedFileService.CloudSyncManager

名称说明
RUNNING0下载中。
COMPLETED1下载完成。
STOPPED2下载停止。

DownloadProgress20+

全量下载任务的进度信息。

系统能力:SystemCapability.FileManagement.DistributedFileService.CloudSyncManager

属性

名称类型只读可选说明
stateDownloadState下载任务的状态。
successfulCountnumber已下载的文件个数,取值范围[0, INT32_MAX],单位:个。进度异常时返回-1。
failedCountnumber下载失败的文件个数,取值范围[0, INT32_MAX],单位:个。进度异常时返回-1。
totalCountnumber待下载文件总个数,取值范围[0, INT32_MAX],单位:个。进度异常时返回-1。
downloadedSizenumber已下载数据大小,取值范围[0, INT64_MAX),单位:Byte。进度异常时返回INT64_MAX。
totalSizenumber需要下载文件的总大小,取值范围[0, INT64_MAX),单位:Byte。进度异常时返回INT64_MAX。
stopReasonDownloadStopReason下载停止的原因。

CloudFileInfo20+

应用本地和云端文件个数以及大小信息。

系统能力:SystemCapability.FileManagement.DistributedFileService.CloudSyncManager

属性

名称类型只读可选说明
cloudFileCountnumber本地未下载的云端文件总个数,取值范围[0, INT32_MAX],单位:个。
cloudFileTotalSizenumber本地未下载的云端文件总大小,取值范围[0, INT64_MAX],单位:Byte。
localFileCountnumber本地未上传云端的文件总个数,取值范围[0, INT32_MAX],单位:个。
localFileTotalSizenumber本地未上传云端的文件总大小,取值范围[0, INT64_MAX],单位:Byte。
bothFileCountnumber本地已上传云端的文件总个数,取值范围[0, INT32_MAX],单位:个。
bothFileTotalSizenumber本地已上传云端的文件总大小,取值范围[0, INT64_MAX],单位:Byte。

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 js-apis-file-environment-sys

openharmony 鸿蒙 js-apis-file-fs

openharmony 鸿蒙 capi-clouddisk-clouddisk-pathinfo

openharmony 鸿蒙 capi-clouddisk-clouddisk-changesresult

openharmony 鸿蒙 capi-clouddisk-clouddisk-syncfolder

openharmony 鸿蒙 js-apis-fileShare

openharmony 鸿蒙 capi-fileio

openharmony 鸿蒙 js-apis-file-storage-statistics-sys

openharmony 鸿蒙 js-apis-file-environment

openharmony 鸿蒙 js-apis-file-trash-sys

  • 所属分类: 后端技术
  • 本文标签: 鸿蒙 软件
  • 版权声明: 本文链接 https://seaxiang.com/blog/NzVA1QC0