diff --git a/zh-cn/application-dev/reference/apis/js-apis-workScheduler.md b/zh-cn/application-dev/reference/apis/js-apis-workScheduler.md index 43db961bc515e46bf6f2182784208ae10ad30da7..c28db3bb22315ed26d0c2eab19b66878be48fef5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-workScheduler.md +++ b/zh-cn/application-dev/reference/apis/js-apis-workScheduler.md @@ -10,13 +10,14 @@ import workScheduler from '@ohos.workScheduler' ``` -## 系统能力 -SystemCapability.ResourceSchedule.WorkScheduler - ## workScheduler.startWork +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: workScheduler.startWork(work: WorkInfo): boolean +- **说明**: 通知WorkSchedulerService将工作添加到执行队列。 - **参数**: @@ -48,12 +49,15 @@ workScheduler.startWork(work: WorkInfo): boolean ``` ## workScheduler.stopWork +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: stopWork(work: WorkInfo, needCancel?: boolean): boolean +- **说明**: 通知WorkSchedulerService停止指定工作。 - - **参数**: | 参数名 | 类型 | 必填 | 说明 | @@ -84,11 +88,14 @@ stopWork(work: WorkInfo, needCancel?: boolean): boolean ``` ## workScheduler.getWorkStatus +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: getWorkStatus(workId: number, callback : AsyncCallback): void -获取工作的最新状态,使用callback形式返回。 - +- **说明**: +获取工作的最新状态,使用Callback形式返回。 - **参数**: @@ -113,9 +120,13 @@ getWorkStatus(workId: number, callback : AsyncCallback): void ``` ## workScheduler.getWorkStatus +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: getWorkStatus(workID: number): Promise +- **说明**: 获取工作的最新状态,使用Promise形式返回。 - **参数**: @@ -143,10 +154,14 @@ getWorkStatus(workID: number): Promise ``` ## workScheduler.obtainAllWorks +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: obtainAllWorks(callback : AsyncCallback): Array -获取与当前应用程序关联的所有工作,使用callback形式返回。 +- **说明**: +获取与当前应用程序关联的所有工作,使用Callback形式返回。 - **参数**: @@ -174,9 +189,13 @@ obtainAllWorks(callback : AsyncCallback): Array ``` ## workScheduler.obtainAllWorks +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: obtainAllWorks(): Promise> +- **说明**: 获取与当前应用程序关联的所有工作,使用Promise形式返回。 - **返回值**: @@ -196,9 +215,13 @@ obtainAllWorks(): Promise> ``` ## workScheduler.stopAndClearWorks +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: stopAndClearWorks(): boolean +- **说明**: 停止和取消与当前应用程序关联的所有工作。 - **示例**: @@ -209,10 +232,14 @@ stopAndClearWorks(): boolean ``` ## workScheduler.isLastWorkTimeOut +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: isLastWorkTimeOut(workId: number, callback : AsyncCallback): boolean -检查指定工作的最后一次执行是否为超时操作,使用callback形式返回。 +- **说明**: +检查指定工作的最后一次执行是否为超时操作,使用Callback形式返回。 - **参数**: @@ -240,9 +267,13 @@ isLastWorkTimeOut(workId: number, callback : AsyncCallback): boolean ``` ## workScheduler.isLastWorkTimeOut +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler -obtainAllWorks(): Promise> +- **接口**: +isLastWorkTimeOut(workId: number): Promise +- **说明**: 检查指定工作的最后一次执行是否为超时操作,使用Promise形式返回。 - **参数**: @@ -271,6 +302,9 @@ obtainAllWorks(): Promise> ``` ## workScheduler.WorkInfo +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler + 提供工作的具体信息。 | 参数名 | 类型 | 必填 | 说明 | @@ -289,6 +323,9 @@ obtainAllWorks(): Promise> |repeatCount |number|否|循环次数| ## workScheduler.NetworkType +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler + 触发工作的网络类型。 |名称 |默认值 |说明| @@ -301,6 +338,9 @@ obtainAllWorks(): Promise> |NETWORK_TYPE_ETHERNET |5 |表示这个触发条件是有线网络连接。| ## workScheduler.ChargingType +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler + 触发工作的充电类型。 |名称 |默认值 |说明| @@ -311,6 +351,9 @@ obtainAllWorks(): Promise> |CHARGING_PLUGGED_WIRELESS |3| 表示这个触发条件是无线充电器连接。| ## workScheduler.BatteryStatus +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler + 触发工作的电池状态。 |名称 |默认值 |说明| @@ -320,6 +363,9 @@ obtainAllWorks(): Promise> |BATTERY_STATUS_LOW_OR_OKAY |2 |表示这个触发条件是从低电恢复到正常电量或者低电告警。| ## workScheduler.StorageRequest +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler + 触发工作的存储状态。 |名称 |默认值 |说明| diff --git a/zh-cn/application-dev/reference/apis/js-apis-workSchedulerExtension.md b/zh-cn/application-dev/reference/apis/js-apis-workSchedulerExtension.md index 91a79406f718172d2e0d629118e2a2abf50e8fc0..335929c07c3daaf45ebd61f1ca80e6a52b15ca4d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-workSchedulerExtension.md +++ b/zh-cn/application-dev/reference/apis/js-apis-workSchedulerExtension.md @@ -10,13 +10,14 @@ import workSchedulerExtension from '@ohos.WorkSchedulerExtension' ``` -## 系统能力 -SystemCapability.ResourceSchedule.WorkScheduler - ## WorkSchedulerExtension.onWorkStart +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: onWorkStart(workInfo: WorkInfo); +- **说明**: 延迟任务调度开始回调。 - **示例**: @@ -30,9 +31,13 @@ onWorkStart(workInfo: WorkInfo); ``` ## WorkSchedulerExtension.onWorkStop +- **系统能力**: +SystemCapability.ResourceSchedule.WorkScheduler +- **接口**: onWorkStop(workInfo: WorkInfo); +- **说明**: 延迟任务调度结束回调。 - **示例**: diff --git a/zh-cn/application-dev/work-scheduler/work-scheduler-dev-guide.md b/zh-cn/application-dev/work-scheduler/work-scheduler-dev-guide.md index ae8c091e56c9db239944dd58b049e7ca4999bb8e..d61b52a6d54568481e7730f2f12618e9d573bbd6 100644 --- a/zh-cn/application-dev/work-scheduler/work-scheduler-dev-guide.md +++ b/zh-cn/application-dev/work-scheduler/work-scheduler-dev-guide.md @@ -6,17 +6,17 @@ ## 接口说明 -注册等相关接口: +注册相关接口包导入: ```js import workScheduler from '@ohos.workScheduler'; ``` -回调接口: +回调相关接口包导入: ```js import WorkSchedulerExtension from '@ohos.WorkSchedulerExtension'; ``` -## 延迟任务调度 +### 延迟任务调度 **表1** workScheduler主要接口 @@ -56,7 +56,7 @@ repeatCount |循环次数| number function onWorkStart(work: WorkInfo): void; | 延迟调度任务开始回调 function onWorkStop(work: WorkInfo): void; | 延迟调度任务结束回调 -## 开发步骤 +### 开发步骤 **开发对应的Extension** diff --git a/zh-cn/application-dev/work-scheduler/work-scheduler-overview.md b/zh-cn/application-dev/work-scheduler/work-scheduler-overview.md index eeae563e7d40d0d98502ef2ec5bf8cf835609f48..ce33b5cd3c61ba95c38827780b449931205f675b 100644 --- a/zh-cn/application-dev/work-scheduler/work-scheduler-overview.md +++ b/zh-cn/application-dev/work-scheduler/work-scheduler-overview.md @@ -1,10 +1,10 @@ # 延迟任务调度概述 -延迟任务调度部件给应用提供一个可以执行实时性不高的任务的机制。当满足设定条件时,会被放入可执行队列,系统根据设备情况,延迟触发可执行队列内的任务。 +延迟任务调度给应用提供一个机制,允许应用根据系统安排,在系统空闲时执行实时性不高的任务。当满足设定条件的时候,任务会被放入待调度队列,当系统空闲时调度该任务。 ## 使用说明 -应用要执行对实时性要求不高的任务的时候,比如设备空闲时候做一次数据学习等场景,可以使用延迟调度任务,该机制在满足应用设定条件的时候,会根据系统当前状态,如内存、功耗、热等统一决策调度时间。 +应用要执行对实时性要求不高的任务的时候,比如设备空闲时候做一次数据学习等场景,可以使用延迟调度任务,该机制在满足应用设定条件的时候,会根据系统当前状态,如内存、功耗、温度等统一决策调度时机。 ## 延迟任务调度约束