延迟任务调度

本模块提供延迟任务注册、取消、查询的能力。

开发者在开发应用时，通过调用延迟任务注册接口，注册对实时性要求不高的延迟任务，该任务默认由系统安排，在系统空闲时根据性能、功耗、热等情况进行调度执行。

说明： 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

导入模块

import workScheduler from '@ohos.workScheduler'

workScheduler.startWork

startWork(work: WorkInfo): boolean

通知WorkSchedulerService将工作添加到执行队列。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名	类型	必填	说明
work	[WorkInfo]	是	指示要添加到执行队列的工作。

返回值 ：

类型	说明
boolean	如果工作成功添加到执行队列，则返回true，否则返回false。

示例：

let workInfo = {
      workId: 1,
      batteryLevel:50,
      batteryStatus:workScheduler.BatteryStatus.BATTERY_STATUS_LOW,
      isRepeat: false,
      isPersisted: true,
      bundleName: "com.example.myapplication",
      abilityName: "MyExtension"
  }
  var res = workScheduler.startWork(workInfo);
  console.info("workschedulerLog res:" + res);

workScheduler.stopWork

stopWork(work: WorkInfo, needCancel?: boolean): boolean

通知WorkSchedulerService停止指定工作。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名	类型	必填	说明
work	[WorkInfo]	是	指示要停止的工作。
needCancel	boolean	是	是否需要取消的工作。

返回值 ：

类型	说明
boolean	如果成功，则返回true，否则返回false。

示例：

let workInfo = {
      workId: 1,
      batteryLevel:50,
      batteryStatus:workScheduler.BatteryStatus.BATTERY_STATUS_LOW,
      isRepeat: false,
      isPersisted: true,
      bundleName: "com.example.myapplication",
      abilityName: "MyExtension"
     }
  var res = workScheduler.stopWork(workInfo, false);
  console.info("workschedulerLog res:" + res);

workScheduler.getWorkStatus

getWorkStatus(workId: number, callback : AsyncCallback): void

获取工作的最新状态，使用Callback形式返回。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名	类型	必填	说明
workId	number	是	work的id。
callback	AsyncCallback<[WorkInfo]>	是	指定的callback回调方法。如果指定的工作Id有效，则返回从WorkSchedulerService获取的有效工作状态；否则返回null。

示例：

workScheduler.getWorkStatus(50, (err, res) = > {
    if (err) {
      console.info('workschedulerLog getWorkStatus failed, because:' + err.code);
    } else {
      for (let item in res) {
        console.info('workschedulerLog getWorkStatus success,' + item + ' is:' + res[item]);
      }
    }
  });

workScheduler.getWorkStatus

getWorkStatus(workId: number): Promise

获取工作的最新状态，使用Promise形式返回。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名	类型	必填	说明
workId	number	是	work的id。

返回值 ：

类型	说明
Promise<[WorkInfo]>	指定的Promise回调方法。如果指定的工作ID有效，则返回从WorkSchedulerService获取的有效工作状态；否则返回null。

示例：

workScheduler.getWorkStatus(50).then((res) = > {
    for (let item in res) {
      console.info('workschedulerLog getWorkStatus success,' + item + ' is:' + res[item]);
    }
  }).catch((err) = > {
    console.info('workschedulerLog getWorkStatus failed, because:' + err.code);
  })

workScheduler.obtainAllWorks

obtainAllWorks(callback : AsyncCallback): Array

获取与当前应用程序关联的所有工作，使用Callback形式返回。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名	类型	必填	说明
callback	AsyncCallback	是	指定的callback回调方法。返回与应用程序关联的所有工作。

返回值 ：

类型	说明
Array<[WorkInfo]>	返回与应用程序关联的所有工作。

示例：

workScheduler.obtainAllWorks((err, res) = >{
    if (err) {
      console.info('workschedulerLog obtainAllWorks failed, because:' + err.code);
    } else {
      console.info('workschedulerLog obtainAllWorks success, data is:' + JSON.stringify(res));
    }
  });

workScheduler.obtainAllWorks

obtainAllWorks(): Promise>

获取与当前应用程序关联的所有工作，使用Promise形式返回。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

返回值 ：

类型	说明
Promise>	指定的Promise回调方法。返回与应用程序关联的所有工作。

示例：

workScheduler.obtainAllWorks().then((res) = > {
    console.info('workschedulerLog obtainAllWorks success, data is:' + JSON.stringify(res));
  }).catch((err) = > {
    console.info('workschedulerLog obtainAllWorks failed, because:' + err.code);
  })

workScheduler.stopAndClearWorks

stopAndClearWorks(): boolean

停止和取消与当前应用程序关联的所有工作。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

示例：

let res = workScheduler.stopAndClearWorks();
  console.info("workschedulerLog res:" + res);

workScheduler.isLastWorkTimeOut

isLastWorkTimeOut(workId: number, callback : AsyncCallback): boolean

检查指定工作的最后一次执行是否为超时操作，使用Callback形式返回。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名	类型	必填	说明
workId	number	是	work的id。
callback	AsyncCallback	是	指定的callback回调方法。如果指定工作的最后一次执行是超时操作，则返回true；否则返回false。

返回值 ：

类型	说明
boolean	指定的callback回调方法。如果指定工作的最后一次执行是超时操作，则返回true；否则返回false。

示例：

workScheduler.isLastWorkTimeOut(500, (err, res) = >{
    if (err) {
      console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.code);
    } else {
      console.info('workschedulerLog isLastWorkTimeOut success, data is:' + res);
    }
  });

workScheduler.isLastWorkTimeOut

isLastWorkTimeOut(workId: number): Promise

检查指定工作的最后一次执行是否为超时操作，使用Promise形式返回。

系统能力 ：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名	类型	必填	说明
workId	number	是	work的id。

返回值 ：

类型	说明
Promise	指定的Promise回调方法。如果指定工作的最后一次执行是超时操作，则返回true；否则返回false。

示例：

workScheduler.isLastWorkTimeOut(500)
    .then(res = > {
      console.info('workschedulerLog isLastWorkTimeOut success, data is:' + res);
    })
    .catch(err = >  {
      console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.code);
    });

WorkInfo

提供工作的具体信息。

系统能力 ：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.WorkScheduler

参数名	类型	必填	说明
workId	number	是	当前工作的ID
bundleName	string	是	延迟任务包名
abilityName	string	是	延迟任务回调通知的组件名（必填）
networkType	[NetworkType]	否	网络类型
isCharging	boolean	否	是否充电
chargerType	[ChargingType]	否	充电类型
batteryLevel	number	否	电量
batteryStatus	[BatteryStatus]	否	电池状态
storageRequest	[StorageRequest]	否	存储状态
isRepeat	boolean	否	是否循环任务
repeatCycleTime	number	否	循环间隔
repeatCount	number	否	循环次数
isPersisted	boolean	否	是否持久化保存工作
isDeepIdle	boolean	否	是否要求设备进入空闲状态
idleWaitTime	number	否	空闲等待时间

NetworkType

触发工作的网络类型。

系统能力 ：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.WorkScheduler

名称	默认值	说明
NETWORK_TYPE_ANY	0	表示这个触发条件是任何类型的网络连接。
NETWORK_TYPE_MOBILE	1	表示这个触发条件是Mobile网络连接。
NETWORK_TYPE_WIFI	2	表示这个触发条件是Wifi类型的网络连接。
NETWORK_TYPE_BLUETOOTH	3	表示这个触发条件是Bluetooth网络连接。
NETWORK_TYPE_WIFI_P2P	4	表示这个触发条件是Wifi P2P网络连接。
NETWORK_TYPE_ETHERNET	5	表示这个触发条件是有线网络连接。

ChargingType

触发工作的充电类型。

系统能力 ：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.WorkScheduler

名称	默认值	说明
CHARGING_PLUGGED_ANY	0	表示这个触发条件是任何类型的充电器连接。
CHARGING_PLUGGED_AC	1	表示这个触发条件是直流充电器连接。
CHARGING_PLUGGED_USB	2	表示这个触发条件是USB充连接。
CHARGING_PLUGGED_WIRELESS	3	表示这个触发条件是无线充电器连接。

BatteryStatus

触发工作的电池状态。

系统能力 ：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.WorkScheduler

名称	默认值	说明
BATTERY_STATUS_LOW	0	表示这个触发条件是低电告警。
BATTERY_STATUS_OKAY	1	表示这个触发条件是从低电恢复到正常电量。
BATTERY_STATUS_LOW_OR_OKAY	2	表示这个触发条件是从低电恢复到正常电量或者低电告警。`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`

鸿蒙文档.png

StorageRequest

触发工作的存储状态。

系统能力 ：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.WorkScheduler

名称	默认值	说明
STORAGE_LEVEL_LOW	0	表示这个触发条件是存储空间不足。
STORAGE_LEVEL_OKAY	1	表示这个触发条件是从存储空间不足恢复到正常。
STORAGE_LEVEL_LOW_OR_OKAY	2	表示这个触发条件是从存储空间不足恢复到正常或者存储空间不足。

审核编辑黄宇

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。举报投诉

接口

接口

+关注

关注
33

文章
7963

浏览量
149211
鸿蒙

鸿蒙

+关注

关注
55

文章
2090

浏览量
42261

鸿蒙原生应用/元服务开发-延迟任务说明（一）

时刻最多申请10个延迟任务。执行频率限制：系统对延迟任务做分级管控，限制延迟任务

发表于 01-16 14:57

鸿蒙原生应用/元服务开发-延迟任务开发实现（二）

: workScheduler.WorkInfo): void 延迟调度任务开始的回调 onWorkStop(work: workScheduler

发表于 01-17 17:53

（转）HarmonyOS(鸿蒙OS)发布，聊聊操作系统的调度

却不得不在多个并发服务之间做公平资源调配。 Windows可以做到将资源倾斜给前台任务，Linux不行。Linux可以做到资源的公平份额调度

发表于 08-20 08:00

Spark资源和任务调度的详细步骤

Spark资源调度和任务调度流程

发表于 10-10 09:01

鸿蒙内核源码分析(调度机制篇)：Task是如何被调度执行的

本文分析任务调度机制源码详见:代码库建议先阅读阅读之前建议先读本系列其他文章，进入鸿蒙系统源码分析(总目录)，以便对本文任务调度机制的理解

发表于 11-23 10:53

鸿蒙分布式任务调度

鸿蒙分布式任务调度，实现跨设备FA拉起

发表于 06-12 17:28

鸿蒙分布式任务调度——数据传递

鸿蒙分布式任务调度之数据传递

发表于 06-12 17:29

【木棉花】：简单的分布式任务调度

Ability：Service模板：用于提供后台运行任务的能力。Data模板：用于对外部提供统一的数据访问抽象。根据 Ability 模板及意图的不同，分布式任务调度向开发者提供以下

发表于 09-03 14:34

调度器的原理及其任务调度代码实现

一、介绍调度器是常用的一种编程框架，也是操作系统的拆分多任务的核心，比如单片机的裸机程序框架，网络协议栈的框架如can网关、485网关等等，使用场合比较多，是做稳定产品比较常用的编程技术二、原理1

发表于 02-17 07:07

STM32开发板移植鸿蒙liteos_m内核，编译通过之后运行无法调度编写的任务

STM32开发板移植鸿蒙liteos_m内核，编译通过之后运行无法调度编写的任务，可以看到任务已经注册成功，就是不能

发表于 11-18 11:46

基于树型Petri网的网格资源调度模型

讨论树型网格环境下独立任务的调度问题，把网格资源计算能力和网络通信速度的异构资源调度问题转化为线性规划问题。提出网格

发表于 04-07 08:53 •24次下载

面向用户任务与云资源匹配度的调度算法研究

面向用户任务与云资源匹配度的调度算法研究_聂清彬

发表于 01-07 18:56 •0次下载

云计算环境中任务调度应用

云计算环境中的任务调度问题一直是云计算研究的重点，任务调度的目的寻找最优的任务调度策略，以高效地

发表于 11-02 17:30 •3次下载

基于改进型统一调度算法改善任务集的可调度性

的抢占，降低资源额外销耗，能够提高任务集合的可调度性；但其任务的可调度性分析方法过于粗糙，影响任务

发表于 11-20 11:27 •0次下载

鸿蒙OS 分布式任务调度

鸿蒙OS 分布式任务调度概述在 HarmonyO S中，分布式任务调度平台对搭载 HarmonyOS 的多设备构筑的“超级虚拟终端”提供统

发表于 01-29 16:50 •297次阅读

搜索历史

鸿蒙开发接口资源调度：【@ohos.workScheduler (延迟任务调度)】

延迟任务调度

导入模块

workScheduler.startWork

workScheduler.stopWork

workScheduler.getWorkStatus

workScheduler.getWorkStatus

workScheduler.obtainAllWorks

workScheduler.obtainAllWorks

workScheduler.stopAndClearWorks

workScheduler.isLastWorkTimeOut

workScheduler.isLastWorkTimeOut

WorkInfo

NetworkType

ChargingType

BatteryStatus

StorageRequest

评论

鸿蒙原生应用/元服务开发-延迟任务说明（一）

鸿蒙原生应用/元服务开发-延迟任务开发实现（二）

（转）HarmonyOS(鸿蒙OS)发布，聊聊操作系统的调度

Spark资源和任务调度的详细步骤

鸿蒙内核源码分析(调度机制篇)：Task是如何被调度执行的

鸿蒙分布式任务调度

鸿蒙分布式任务调度——数据传递

【木棉花】：简单的分布式任务调度

调度器的原理及其任务调度代码实现

STM32开发板移植鸿蒙liteos_m内核，编译通过之后运行无法调度编写的任务

基于树型Petri网的网格资源调度模型

面向用户任务与云资源匹配度的调度算法研究

云计算环境中任务调度应用

基于改进型统一调度算法改善任务集的可调度性

鸿蒙OS 分布式任务调度