diff --git a/en/application-dev/reference/apis/js-apis-workScheduler.md b/en/application-dev/reference/apis/js-apis-workScheduler.md index 964b63aa2ec47a0cceaaac8457f77f3a916051f7..e621c223d6846fffb3537d7d501fa408cbb0f7f9 100644 --- a/en/application-dev/reference/apis/js-apis-workScheduler.md +++ b/en/application-dev/reference/apis/js-apis-workScheduler.md @@ -39,7 +39,14 @@ Instructs the **WorkSchedulerService** to add the specified task to the executio isRepeat: false, isPersisted: true, bundleName: "com.example.myapplication", - abilityName: "MyExtension" + abilityName: "MyExtension", + parameters: { + mykey0: 2222, + mykey1: "ssssssssssssssssssssssssss", + mykey2: true, + mykey3: 1.5, + mykey4: 213749534591254587511 + } } var res = workScheduler.startWork(workInfo); console.info("workschedulerLog res:" + res); @@ -75,7 +82,14 @@ Instructs the **WorkSchedulerService** to stop the specified task. isRepeat: false, isPersisted: true, bundleName: "com.example.myapplication", - abilityName: "MyExtension" + abilityName: "MyExtension", + parameters: { + mykey0: 2222, + mykey1: "ssssssssssssssssssssssssss", + mykey2: true, + mykey3: 1.5, + mykey4: 213749534591254587511 + } } var res = workScheduler.stopWork(workInfo, false); console.info("workschedulerLog res:" + res); @@ -272,7 +286,7 @@ Checks whether the last execution of the specified task timed out. This API uses ``` ## WorkInfo -Provides detailed information about the task. +Provides detailed information about the task. The constraint of WorkInfo reference [Work Scheduler Overview](../../task-management/work-scheduler-overview.md) **System capability**: SystemCapability.ResourceSchedule.WorkScheduler diff --git a/en/application-dev/task-management/work-scheduler-dev-guide.md b/en/application-dev/task-management/work-scheduler-dev-guide.md index dfa30e4a5d03af24e4c2e75a5f0569bd1b30fa07..6f833ef354e4635ed174e768086b94146dd823d3 100644 --- a/en/application-dev/task-management/work-scheduler-dev-guide.md +++ b/en/application-dev/task-management/work-scheduler-dev-guide.md @@ -34,6 +34,8 @@ function isLastWorkTimeOut(workId: number): Promise<boolean>;| Checks whether th **Table 2** WorkInfo parameters +> **Explanation:** The constraint of WorkInfo reference [Work Scheduler Overview](./work-scheduler-overview.md) + API|Description|Type ---------------------------------------------------------|-----------------------------------------|--------------------------------------------------------- workId | Work ID. Mandatory.|number @@ -48,6 +50,7 @@ storageRequest|Storage status.| StorageRequest isRepeat|Whether the task is repeated.| boolean repeatCycleTime |Repeat interval.| number repeatCount |Number of repeat times.| number +parameters |Parameters carried| {[key: string]: any} **Table 3** Work Scheduler callbacks @@ -85,7 +88,14 @@ function onWorkStop(work: WorkInfo): void; | Triggered when the Work Scheduler t isRepeat: false, isPersisted: true, bundleName: "com.example.myapplication", - abilityName: "MyExtension" + abilityName: "MyExtension", + parameters: { + mykey0: 2222, + mykey1: "ssssssssssssssssssssssssss", + mykey2: true, + mykey3: 1.5, + mykey4: 213749534591254587511 + } } var res = workScheduler.startWork(workInfo); console.info("workschedulerLog res:" + res); @@ -103,7 +113,14 @@ function onWorkStop(work: WorkInfo): void; | Triggered when the Work Scheduler t isRepeat: false, isPersisted: true, bundleName: "com.example.myapplication", - abilityName: "MyExtension" + abilityName: "MyExtension", + parameters: { + mykey0: 2222, + mykey1: "ssssssssssssssssssssssssss", + mykey2: true, + mykey3: 1.5, + mykey4: 213749534591254587511 + } } var res = workScheduler.stopWork(workInfo, false); console.info("workschedulerLog res:" + res); diff --git a/en/application-dev/task-management/work-scheduler-overview.md b/en/application-dev/task-management/work-scheduler-overview.md index b6c2fec6ec66b369832930fd5dc520603209788f..28ab133af55e20084d390eb855342ddcdc52cfed 100644 --- a/en/application-dev/task-management/work-scheduler-overview.md +++ b/en/application-dev/task-management/work-scheduler-overview.md @@ -11,6 +11,17 @@ If your application needs to execute a non-real-time task, for example, data lea The use of the Work Scheduler must comply with the following restrictions and rules: - **Timeout**: The Work Scheduler callback can run only within the specified period of time. After the timeout, the callback automatically stops. +- **Execution frequency**:The system will perform hierarchical control on the work scheduler according to the bundle activity of the application, and limit the execution frequency of work scheduler. + +Application group | Execution frequency constraint +--------------------|------------------------- +active group | minimum interval 2 hours +daily used group | minimum interval 4 hours +fixed group | minimum interval 24 hours +rare used group | minimum interval 48 hours +restricted group | forbidden +unused group | forbidden + - **WorkInfo setting** (1) **workId**, **bundleName**, and **abilityName** are mandatory. **bundleName** must be set to the name of the current application. Otherwise, the verification will fail. @@ -18,3 +29,5 @@ The use of the Work Scheduler must comply with the following restrictions and ru (2) At least one condition must be set. (3) The repeat interval must be at least 20 minutes and must work with the Always repeat pattern or repeat times. + +(4) Parameters support type include number, string and bool. 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 d082b3ee5fbac9e62e5d3d15525b8828570f55ff..264085b6d5b8ffe760a03dd659e0387c003e5d5a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-workScheduler.md +++ b/zh-cn/application-dev/reference/apis/js-apis-workScheduler.md @@ -313,7 +313,7 @@ isLastWorkTimeOut(workId: number): Promise\<boolean> | isPersisted | boolean | å¦ | 是å¦æŒä¹…化ä¿å˜å·¥ä½œ | | isDeepIdle | boolean | å¦ | 是å¦è¦æ±‚è®¾å¤‡è¿›å…¥ç©ºé—²çŠ¶æ€ | | idleWaitTime | number | å¦ | 空闲ç‰å¾…时间 | -| parameters | {[key: string]: any} | å¦ | é¢å¤–æ•°æ® | +| parameters | {[key: string]: any} | å¦ | æºå¸¦å‚æ•°ä¿¡æ¯ | ## NetworkType 触å‘工作的网络类型。 diff --git a/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md b/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md index 737af092f22d026b366d8229c8612131186a9274..e051ac4c8159dd53e76c799ad2fdb9031c0b3bcf 100644 --- a/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md +++ b/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md @@ -50,7 +50,7 @@ storageRequest|å˜å‚¨çŠ¶æ€| StorageRequest isRepeat|是å¦å¾ªçŽ¯ä»»åŠ¡| boolean repeatCycleTime |循环间隔| number repeatCount |循环次数| number -parameters |é¢å¤–æ•°æ®| {[key: string]: any} +parameters |æºå¸¦å‚æ•°ä¿¡æ¯| {[key: string]: any} **表3** å»¶è¿Ÿä»»åŠ¡å›žè°ƒæŽ¥å£ diff --git a/zh-cn/application-dev/task-management/work-scheduler-overview.md b/zh-cn/application-dev/task-management/work-scheduler-overview.md index 16465205d0ac951a8323b1dfaf262e600b0bdf2e..e4b8d34943147f81881be561c4649b8afeb5886c 100644 --- a/zh-cn/application-dev/task-management/work-scheduler-overview.md +++ b/zh-cn/application-dev/task-management/work-scheduler-overview.md @@ -30,4 +30,4 @@ (3)é‡å¤ä»»åŠ¡æ—¶é—´é—´éš”至少20分钟,当设置é‡å¤ä»»åŠ¡æ—¶é—´é—´éš”时,必须设置始终é‡å¤å’Œé‡å¤æ¬¡æ•°ä¸çš„一个。 -(4)é¢å¤–æ•°æ®æ”¯æŒnumberã€stringã€bool三ç§ç±»åž‹ã€‚ \ No newline at end of file +(4)æºå¸¦å‚æ•°ä¿¡æ¯æ”¯æŒnumberã€stringã€bool三ç§ç±»åž‹ã€‚ \ No newline at end of file