当前位置： 首页 > news >正文

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

news 来源：原创 2024/9/29 9:20:30

 延迟任务调度

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

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

说明：  本模块首批接口从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]是指示要停止的工作。
needCancelboolean是是否需要取消的工作。

返回值：

类型说明
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<WorkInfo>): void

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

系统能力：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名类型必填说明
workIdnumber是work的id。
callbackAsyncCallback<[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<WorkInfo>

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

系统能力：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名类型必填说明
workIdnumber是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<void>): Array<WorkInfo>

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

系统能力：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名类型必填说明
callbackAsyncCallback<void>是指定的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<Array<WorkInfo>>

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

系统能力：SystemCapability.ResourceSchedule.WorkScheduler

返回值：

类型说明
Promise<Array<[WorkInfo]>>指定的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<void>): boolean

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

系统能力：SystemCapability.ResourceSchedule.WorkScheduler

参数：

参数名类型必填说明
workIdnumber是work的id。
callbackAsyncCallback<void>是指定的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<boolean>

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

系统能力：SystemCapability.ResourceSchedule.WorkScheduler

参数：

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

返回值：

类型说明
Promise<boolean>指定的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

参数名类型必填说明
workIdnumber是当前工作的ID
bundleNamestring是延迟任务包名
abilityNamestring是延迟任务回调通知的组件名（必填）
networkType[NetworkType]否网络类型
isChargingboolean否是否充电
chargerType[ChargingType]否充电类型
batteryLevelnumber否电量
batteryStatus[BatteryStatus]否电池状态
storageRequest[StorageRequest]否存储状态
isRepeatboolean否是否循环任务
repeatCycleTimenumber否循环间隔
repeatCountnumber否循环次数
isPersistedboolean否是否持久化保存工作
isDeepIdleboolean否是否要求设备进入空闲状态
idleWaitTimenumber否空闲等待时间

NetworkType

触发工作的网络类型。

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

名称默认值说明
NETWORK_TYPE_ANY0表示这个触发条件是任何类型的网络连接。
NETWORK_TYPE_MOBILE1表示这个触发条件是Mobile网络连接。
NETWORK_TYPE_WIFI2表示这个触发条件是Wifi类型的网络连接。
NETWORK_TYPE_BLUETOOTH3表示这个触发条件是Bluetooth网络连接。
NETWORK_TYPE_WIFI_P2P4表示这个触发条件是Wifi P2P网络连接。
NETWORK_TYPE_ETHERNET5表示这个触发条件是有线网络连接。

ChargingType

触发工作的充电类型。

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

名称默认值说明
CHARGING_PLUGGED_ANY0表示这个触发条件是任何类型的充电器连接。
CHARGING_PLUGGED_AC1表示这个触发条件是直流充电器连接。
CHARGING_PLUGGED_USB2表示这个触发条件是USB充连接。
CHARGING_PLUGGED_WIRELESS3表示这个触发条件是无线充电器连接。

BatteryStatus

触发工作的电池状态。

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

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

鸿蒙文档.png

StorageRequest

触发工作的存储状态。

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

名称默认值说明
STORAGE_LEVEL_LOW0表示这个触发条件是存储空间不足。
STORAGE_LEVEL_OKAY1表示这个触发条件是从存储空间不足恢复到正常。
STORAGE_LEVEL_LOW_OR_OKAY2表示这个触发条件是从存储空间不足恢复到正常或者存储空间不足。

到这里我们就基本上学完了这个知识点，当然如果说要真正参与到鸿蒙的开发当中，要学的还有很多。大家可以看看下面这个鸿蒙入门到实战的学习技术路线图：

 而随着鸿蒙的火热，现阶段已有许多Android、前端等开发者看中其未来趋势；想从网上查阅学习，但搜索到的鸿蒙资料都是七零八碎的，对此为了避免大家在学习过程中浪费过多时间，特地根据鸿蒙官方发布文档结合华为内部人员的分享，经过反复修改整理得出：

整套鸿蒙（HarmonyOS NEXT）学习手册（共计1236页）与鸿蒙（HarmonyOS NEXT）开发入门&实战教学视频（200集+）发放给大家。

内容包含了：（ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、鸿蒙南向开发、鸿蒙项目实战）等技术知识点。帮助大家在学习鸿蒙路上少走弯路！下面点击↓↓↓拿

废话不多说，接下来好好看下这份资料。

《鸿蒙 (HarmonyOS NEXT)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

  1. ArkTS语言

  2. 安装DevEco Studio

  3. 运用你的第一个ArkTS应用

  4. ArkUI声明式UI开发

  5. .……

《鸿蒙开发进阶》

  1. Stage模型入门

  2. 网络管理

  3. 数据管理

  4. 电话服务

  5. 分布式应用开发

  6. 通知与窗口管理

  7. 多媒体技术

  8. 安全技能

  9. 任务管理

  10. WebGL

  11. 国际化开发

  12. 应用测试

  13. DFX面向未来设计

  14. 鸿蒙系统移植和裁剪定制

  15. ……

《鸿蒙开发实战》

  1. ArkTS实践

  2. UIAbility应用

  3. 网络案例

  4. ……

《鸿蒙 (HarmonyOS NEXT)开发入门&实战教学视频》  

↑↑↑点击即可

相关文章：

  • PTA 7-4 按层遍历二叉树
  • ES 8的向量检索性能调优实践
  • MPEG-TS 封装格式详解
  • 设备上CCD功能增加（从接线到程序）
  • 如何修复Mfplat.dll无法找到或者缺失的错误
  • Vue3-Pinia状态管理器
  • 【考研数据结构知识点详解及整理——C语言描述】第二章 线性表顺序存储结构上的基本操作——顺序表的插入操作
  • 【ZZULI数据结构实验四】：C语言排序算法大比拼
  • 计算机网络期末知识总结（第一章）
  • Kylin入门教程介绍
  • 雪花算法详解及源码分析
  • 爬虫面试手册
  • HTML基本元素包含HTML表单验证
  • 自友科技破解走班教育排课难题
  • 尚品汇项目
  • Android 初级面试者拾遗（前台界面篇）之 Activity 和 Fragment
  • AngularJS指令开发（1）——参数详解
  • Bootstrap JS插件Alert源码分析
  • HTML-表单
  • Java 多线程编程之：notify 和 wait 用法
  • Java多态
  • JSDuck 与 AngularJS 融合技巧
  • Redux 中间件分析
  • Shell编程
  • 复杂数据处理
  • 工程优化暨babel升级小记
  • 湖南卫视：中国白领因网络偷菜成当代最寂寞的人?
  • 京东美团研发面经
  • 看域名解析域名安全对SEO的影响
  • 入手阿里云新服务器的部署NODE
  • 设计模式 开闭原则
  • 由插件封装引出的一丢丢思考
  • 不要一棍子打翻所有黑盒模型，其实可以让它们发挥作用 ...
  • ​​​​​​​​​​​​​​汽车网络信息安全分析方法论
  • ​软考-高级-系统架构设计师教程（清华第2版）【第9章 软件可靠性基础知识（P320~344）-思维导图】​
  • # Redis 入门到精通（九）-- 主从复制（1）
  • # 利刃出鞘_Tomcat 核心原理解析（二）
  • ###C语言程序设计-----C语言学习（6）#
  • $GOPATH/go.mod exists but should not goland
  • （二）hibernate配置管理
  • （二）Pytorch快速搭建神经网络模型实现气温预测回归(代码+详细注解)
  • （二）什么是Vite——Vite 和 Webpack 区别（冷启动）
  • （附源码）springboot家庭财务分析系统 毕业设计641323
  • （附源码）ssm高校升本考试管理系统 毕业设计 201631
  • （附源码）ssm基于jsp的在线点餐系统 毕业设计 111016
  • （附源码）计算机毕业设计SSM基于健身房管理系统
  • （简单有案例）前端实现主题切换、动态换肤的两种简单方式
  • （面试必看！）锁策略
  • (十一)JAVA springboot ssm b2b2c多用户商城系统源码：服务网关Zuul高级篇
  • （四）七种元启发算法（DBO、LO、SWO、COA、LSO、KOA、GRO）求解无人机路径规划MATLAB
  • （未解决）macOS matplotlib 中文是方框
  • （一） springboot详细介绍
  • （转）LINQ之路
  • . ./ bash dash source 这五种执行shell脚本方式 区别
  • .net core 依赖注入的基本用发