延遲任務(wù)調(diào)度

本模塊提供延遲任務(wù)注冊、取消、查詢的能力。

開發(fā)者在開發(fā)應(yīng)用時，通過調(diào)用延遲任務(wù)注冊接口，注冊對實時性要求不高的延遲任務(wù)，該任務(wù)默認(rèn)由系統(tǒng)安排，在系統(tǒng)空閑時根據(jù)性能、功耗、熱等情況進行調(diào)度執(zhí)行。

說明： 本模塊首批接口從API version 9開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨標(biāo)記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import workScheduler from '@ohos.workScheduler'

workScheduler.startWork

startWork(work: WorkInfo): boolean

通知WorkSchedulerService將工作添加到執(zhí)行隊列。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

參數(shù) ：

返回值 ：

示例 ：

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停止指定工作。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

參數(shù) ：

返回值 ：

示例 ：

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

獲取工作的最新狀態(tài)，使用Callback形式返回。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

參數(shù) ：

示例 ：

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

獲取工作的最新狀態(tài)，使用Promise形式返回。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

參數(shù) ：

返回值 ：

示例 ：

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

獲取與當(dāng)前應(yīng)用程序關(guān)聯(lián)的所有工作，使用Callback形式返回。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

參數(shù) ：

返回值 ：

示例 ：

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>

獲取與當(dāng)前應(yīng)用程序關(guān)聯(lián)的所有工作，使用Promise形式返回。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

返回值 ：

示例 ：

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

停止和取消與當(dāng)前應(yīng)用程序關(guān)聯(lián)的所有工作。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

示例 ：

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

workScheduler.isLastWorkTimeOut

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

檢查指定工作的最后一次執(zhí)行是否為超時操作，使用Callback形式返回。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

參數(shù) ：

返回值 ：

示例 ：

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

檢查指定工作的最后一次執(zhí)行是否為超時操作，使用Promise形式返回。

系統(tǒng)能力 ：SystemCapability.ResourceSchedule.WorkScheduler

參數(shù) ：

返回值 ：

示例 ：

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

WorkInfo

提供工作的具體信息。

系統(tǒng)能力 ：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.ResourceSchedule.WorkScheduler

NetworkType

觸發(fā)工作的網(wǎng)絡(luò)類型。

系統(tǒng)能力 ：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.ResourceSchedule.WorkScheduler

ChargingType

觸發(fā)工作的充電類型。

系統(tǒng)能力 ：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.ResourceSchedule.WorkScheduler

BatteryStatus

觸發(fā)工作的電池狀態(tài)。

系統(tǒng)能力 ：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.ResourceSchedule.WorkScheduler

StorageRequest

觸發(fā)工作的存儲狀態(tài)。

系統(tǒng)能力 ：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.ResourceSchedule.WorkScheduler

審核編輯 黃宇