js-apis-missionManager.md 18.6 KB
Newer Older
G
guyuanzhang 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
# missionManager


> **说明:**
> 本模块首批接口从API version 8开始支持。


missionManager模块提供系统任务管理能力,开发者可以对系统任务执行锁定、解锁、清理、切换到前台等操作。


## 导入模块


```
import missionManager from '@ohos.application.missionManager'
```


Y
yuyaozhi 已提交
19
## missionManager.registerMissionListener
G
guyuanzhang 已提交
20

21
registerMissionListener(listener: MissionListener): number;
G
guyuanzhang 已提交
22 23 24

注册系统任务状态监听。

Y
yuyaozhi 已提交
25 26 27 28 29
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
30 31 32
  | -------- | -------- | -------- | -------- |
  | listener | MissionListener | 是 | 系统任务监听方法。 |

Y
yuyaozhi 已提交
33 34 35
**返回值:**

  | 类型 | 说明 |
G
guyuanzhang 已提交
36 37 38
  | -------- | -------- |
  | number | 监听方法的index值,由系统创建,在注册系统任务状态监听时分配,和监听方法一一对应 。 |

Y
yuyaozhi 已提交
39
**示例:**
G
guyuanzhang 已提交
40

Y
yuyaozhi 已提交
41
  ```js
G
guyuanzhang 已提交
42 43 44 45 46 47 48 49 50 51 52 53
  var listener =  {
  	onMissionCreated: this.onMissionCreatedCallback,
  	onMissionDestroyed: this.onMissionDestroyedCallback,
  	onMissionSnapshotChanged: this.onMissionSnapshotChangedCallback,
  	onMissionMovedToFront: this.onMissionMovedToFrontCallback
  };
  console.log("registerMissionListener")
  var listenerid = missionManager.registerMissionListener(listener);

  ```


Y
yuyaozhi 已提交
54
## missionManager.unregisterMissionListener
G
guyuanzhang 已提交
55

56
unregisterMissionListener(listenerId: number, callback: AsyncCallback<void>): void;
G
guyuanzhang 已提交
57 58 59

取消任务状态监听。

Y
yuyaozhi 已提交
60 61 62 63 64
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
65 66 67 68
  | -------- | -------- | -------- | -------- |
  | listenerId | number | 是 | 系统任务状态监听方法的index值,和监听方法一一对应,由registerMissionListener方法返回。 |
  | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 |

Y
yuyaozhi 已提交
69
**示例:**
G
guyuanzhang 已提交
70

Y
yuyaozhi 已提交
71
  ```js
G
guyuanzhang 已提交
72 73 74 75 76 77 78 79 80 81 82 83 84 85 86
  var listener =  {
    onMissionCreated: this.onMissionCreatedCallback,
    onMissionDestroyed: this.onMissionDestroyedCallback,
    onMissionSnapshotChanged: this.onMissionSnapshotChangedCallback,
    onMissionMovedToFront: this.onMissionMovedToFrontCallback
  };
  console.log("registerMissionListener")
  var listenerid = missionManager.registerMissionListener(listener);

  missionManager.unregisterMissionListener(listenerid, (error) => {
    console.log("unregisterMissionListener");
  })
  ```


Y
yuyaozhi 已提交
87
## missionManager.unregisterMissionListener
G
guyuanzhang 已提交
88

89
unregisterMissionListener(listenerId: number): Promise<void>;
G
guyuanzhang 已提交
90 91 92

取消任务状态监听,以promise方式返回执行结果。

Y
yuyaozhi 已提交
93 94 95 96 97
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
98 99 100
  | -------- | -------- | -------- | -------- |
  | listenerId | number | 是 | 系统任务状态监听方法的index值,和监听方法一一对应,由registerMissionListener方法返回。 |

Y
yuyaozhi 已提交
101
**示例:**
G
guyuanzhang 已提交
102

Y
yuyaozhi 已提交
103
  ```js
G
guyuanzhang 已提交
104 105 106 107 108 109 110 111 112
  var listener =  {
      onMissionCreated: this.onMissionCreatedCallback,
      onMissionDestroyed: this.onMissionDestroyedCallback,
      onMissionSnapshotChanged: this.onMissionSnapshotChangedCallback,
      onMissionMovedToFront: this.onMissionMovedToFrontCallback
    };
    console.log("registerMissionListener")
    var listenerid = missionManager.registerMissionListener(listener);

113
    missionManager.unregisterMissionListener(listenerid).catch(function (err){
G
guyuanzhang 已提交
114 115 116 117 118
      console.log(err);
    });
  ```


Y
yuyaozhi 已提交
119
## missionManager.getMissionInfo
G
guyuanzhang 已提交
120

121
getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<MissionInfo>): void;
G
guyuanzhang 已提交
122 123 124

获取任务信息,以异步回调的方式返回任务信息。

Y
yuyaozhi 已提交
125 126 127 128 129
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
130 131 132 133 134
  | -------- | -------- | -------- | -------- |
  | deviceId | string | 是 | 设备ID,本机默认为空字符串。 |
  | missionId | number | 是 | 任务ID。 |
  | callback | AsyncCallback<MissionInfo> | 是 | 执行结果回调函数,返回任务信息。 |

Y
yuyaozhi 已提交
135
**示例:**
G
guyuanzhang 已提交
136

Y
yuyaozhi 已提交
137
  ```js
G
guyuanzhang 已提交
138 139 140 141 142 143 144 145 146 147
  import missionManager from '@ohos.application.missionManager'

  missionManager.getMissionInfo("", allMissions[0].missionId, (error, mission) => {
  	console.log("getMissionInfo is called, error.code = " + error.code)
  	console.log("mission.missionId = " + mission.missionId);
  	console.log("mission.runningState = " + mission.runningState);
  	console.log("mission.lockedState = " + mission.lockedState);
  	console.log("mission.timestamp = " + mission.timestamp);
  	console.log("mission.label = " + mission.label);
  	console.log("mission.iconPath = " + mission.iconPath);
148
  });
G
guyuanzhang 已提交
149 150 151
  ```


Y
yuyaozhi 已提交
152
## missionManager.getMissionInfo
G
guyuanzhang 已提交
153

154
getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>;
G
guyuanzhang 已提交
155 156 157

获取任务信息,以promise方式返回任务信息。

Y
yuyaozhi 已提交
158 159 160 161 162
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
163 164 165 166
  | -------- | -------- | -------- | -------- |
  | deviceId | string | 是 | 设备ID,本机默认为空字符串。 |
  | missionId | number | 是 | 任务ID。 |

Y
yuyaozhi 已提交
167 168 169
**返回值:**

  | 类型 | 说明 |
G
guyuanzhang 已提交
170 171 172
  | -------- | -------- |
  | [MissionInfo](js-apis-application-MissionInfo.md) | 任务信息。 |

Y
yuyaozhi 已提交
173
**示例:**
G
guyuanzhang 已提交
174

Y
yuyaozhi 已提交
175
  ```js
G
guyuanzhang 已提交
176 177
  import missionManager from '@ohos.application.missionManager'

178
  var mission = missionManager.getMissionInfo("", id).catch(function (err){
G
guyuanzhang 已提交
179 180 181 182 183
      console.log(err);
  });
  ```


Y
yuyaozhi 已提交
184
## missionManager.getMissionInfos
G
guyuanzhang 已提交
185

186
getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Array<MissionInfo>>): void;
G
guyuanzhang 已提交
187 188 189

获取所有任务信息,以回调函数的方式返回任务信息数组。

Y
yuyaozhi 已提交
190 191 192 193 194
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
195 196 197 198 199
  | -------- | -------- | -------- | -------- |
  | deviceId | string | 是 | 设备ID,本机默认为空字符串。 |
  | numMax | number | 是 | 任务信息数量上限。 |
  | callback | AsyncCallback<Array<[MissionInfo](js-apis-application-MissionInfo.md)>> | 是 | 执行结果回调函数,返回任务信息数组。 |

Y
yuyaozhi 已提交
200
**示例:**
G
guyuanzhang 已提交
201

Y
yuyaozhi 已提交
202
  ```js
G
guyuanzhang 已提交
203 204 205 206 207 208 209 210 211 212
  import missionManager from '@ohos.application.missionManager'

  missionManager.getMissionInfos("", 10, (error, missions) => {
      console.log("getMissionInfos is called, error.code = " + error.code);
      console.log("size = " + missions.length);
      console.log("missions = " + JSON.stringify(missions));
  })
  ```


Y
yuyaozhi 已提交
213
## missionManager.getMissionInfos
G
guyuanzhang 已提交
214

215
getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionInfo>>;
G
guyuanzhang 已提交
216 217 218

获取所有任务信息,以promise的方式返回任务信息数组。

Y
yuyaozhi 已提交
219 220 221 222 223
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
224 225 226 227
  | -------- | -------- | -------- | -------- |
  | deviceId | string | 是 | 设备ID,本机默认为空字符串。 |
  | numMax | number | 是 | 任务信息数量上限。 |

Y
yuyaozhi 已提交
228 229 230
**返回值:**

  | 类型 | 说明 |
G
guyuanzhang 已提交
231 232 233
  | -------- | -------- |
  | Array<MissionInfo> | 任务信息数组。 |

Y
yuyaozhi 已提交
234
**示例:**
G
guyuanzhang 已提交
235

Y
yuyaozhi 已提交
236
  ```js
G
guyuanzhang 已提交
237 238
  import missionManager from '@ohos.application.missionManager'

239
  var allMissions = missionManager.getMissionInfos("", 10).catch(function (err){
G
guyuanzhang 已提交
240 241 242 243 244
      console.log(err);
  });
  ```


Y
yuyaozhi 已提交
245
## missionManager.getMissionSnapShot
G
guyuanzhang 已提交
246

247
getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback<MissionSnapshot>): void;
G
guyuanzhang 已提交
248 249 250

获取任务快照,以回调函数的方式返回快照内容。

Y
yuyaozhi 已提交
251 252 253 254 255
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
256 257 258 259 260
  | -------- | -------- | -------- | -------- |
  | deviceId | string | 是 | 设备ID,本机默认为空字符串。 |
  | missionId | number | 是 | 任务ID。 |
  | callback | AsyncCallback<[MissionSnapshot](js-apis-application-MissionSnapshot.md)> | 是 | 执行结果回调函数,返回任务快照信息。 |

Y
yuyaozhi 已提交
261
**示例:**
G
guyuanzhang 已提交
262

Y
yuyaozhi 已提交
263
  ```js
G
guyuanzhang 已提交
264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279
  import missionManager from '@ohos.application.missionManager'

  missionManager.getMissionInfos("", 10, (error, missions) => {
    console.log("getMissionInfos is called, error.code = " + error.code);
    console.log("size = " + missions.length);
    console.log("missions = " + JSON.stringify(missions));
    var id = missions[0].missionId;

    missionManager.getMissionSnapShot("", id, (error, snapshot) => {
  	console.log("getMissionSnapShot is called, error.code = " + error.code);
  	console.log("bundleName = " + snapshot.ability.bundleName);
  })
  })
  ```


Y
yuyaozhi 已提交
280
## missionManager.getMissionSnapShot
G
guyuanzhang 已提交
281

282
getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnapshot>;
G
guyuanzhang 已提交
283 284 285

获取任务快照,以promise的方式返回快照内容。

Y
yuyaozhi 已提交
286 287 288 289 290
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
291 292 293 294
  | -------- | -------- | -------- | -------- |
  | deviceId | string | 是 | 设备ID,本机默认为空字符串。 |
  | missionId | number | 是 | 任务ID。 |

Y
yuyaozhi 已提交
295 296 297
**返回值:**

  | 类型 | 说明 |
G
guyuanzhang 已提交
298 299 300
  | -------- | -------- |
  | MissionSnapshot | 任务快照信息。 |

Y
yuyaozhi 已提交
301
**示例:**
G
guyuanzhang 已提交
302

Y
yuyaozhi 已提交
303
  ```js
G
guyuanzhang 已提交
304 305
  import missionManager from '@ohos.application.missionManager'

306
  var allMissions = missionManager.getMissionInfos("", 10).catch(function (err){
G
guyuanzhang 已提交
307 308 309 310 311
    console.log(err);
  });
  console.log("size = " + allMissions.length);
  console.log("missions = " + JSON.stringify(allMissions));
  var id = allMissions[0].missionId;
312
  var snapshot = missionManager.getMissionSnapShot("", id).catch(function (err){
G
guyuanzhang 已提交
313 314 315 316 317
    console.log(err);
  });
  ```


Y
yuyaozhi 已提交
318
## missionManager.lockMission
G
guyuanzhang 已提交
319

320
lockMission(missionId: number, callback: AsyncCallback<void>): void;
G
guyuanzhang 已提交
321 322 323

锁定指定任务id的任务,以回调函数的方式返回。

Y
yuyaozhi 已提交
324 325 326 327 328
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
329 330 331 332
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |
  | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 |

Y
yuyaozhi 已提交
333
**示例:**
G
guyuanzhang 已提交
334

Y
yuyaozhi 已提交
335
  ```js
G
guyuanzhang 已提交
336 337 338 339 340 341 342 343 344 345 346 347 348 349 350
  import missionManager from '@ohos.application.missionManager'

  missionManager.getMissionInfos("", 10, (error, missions) => {
    console.log("getMissionInfos is called, error.code = " + error.code);
    console.log("size = " + missions.length);
    console.log("missions = " + JSON.stringify(missions));
    var id = missions[0].missionId;

    missionManager.lockMission(id).then(() => {
  	console.log("lockMission is called ");
  });
  });
  ```


Y
yuyaozhi 已提交
351
## missionManager.lockMission
G
guyuanzhang 已提交
352

353
lockMission(missionId: number): Promise<void>;
G
guyuanzhang 已提交
354 355 356

锁定指定任务id的任务,以promise方式返回。

Y
yuyaozhi 已提交
357 358 359 360 361
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
362 363 364
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |

Y
yuyaozhi 已提交
365
**示例:**
G
guyuanzhang 已提交
366

Y
yuyaozhi 已提交
367
  ```js
G
guyuanzhang 已提交
368 369
  import missionManager from '@ohos.application.missionManager'

370
  var allMissions = missionManager.getMissionInfos("", 10).catch(function (err){
G
guyuanzhang 已提交
371 372 373 374 375 376
    console.log(err);
  });
  console.log("size = " + allMissions.length);
  console.log("missions = " + JSON.stringify(allMissions));
  var id = allMissions[0].missionId;

377
  missionManager.lockMission(id).catch(function (err){
G
guyuanzhang 已提交
378 379 380 381 382
      console.log(err);
  });
  ```


Y
yuyaozhi 已提交
383
## missionManager.unlockMission
G
guyuanzhang 已提交
384

385
unlockMission(missionId: number, callback: AsyncCallback<void>): void;
G
guyuanzhang 已提交
386 387 388

解锁指定任务id的任务,以回调函数的方式返回。

Y
yuyaozhi 已提交
389 390 391 392 393
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
394 395 396
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |

Y
yuyaozhi 已提交
397
**示例:**
G
guyuanzhang 已提交
398

Y
yuyaozhi 已提交
399
  ```js
G
guyuanzhang 已提交
400 401 402 403 404 405 406 407 408 409 410 411 412 413 414
  import missionManager from '@ohos.application.missionManager'

  missionManager.getMissionInfos("", 10, (error, missions) => {
    console.log("getMissionInfos is called, error.code = " + error.code);
    console.log("size = " + missions.length);
    console.log("missions = " + JSON.stringify(missions));
    var id = missions[0].missionId;

    missionManager.unlockMission(id).then(() => {
  	console.log("unlockMission is called ");
  });
  });
  ```


Y
yuyaozhi 已提交
415
## missionManager.unlockMission
G
guyuanzhang 已提交
416

417
unlockMission(missionId: number): Promise<void>;
G
guyuanzhang 已提交
418 419 420

解锁指定任务id的任务,以promise的方式返回。

Y
yuyaozhi 已提交
421 422 423 424 425
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
426 427 428
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |

Y
yuyaozhi 已提交
429
**示例:**
G
guyuanzhang 已提交
430

Y
yuyaozhi 已提交
431
  ```js
G
guyuanzhang 已提交
432 433
  import missionManager from '@ohos.application.missionManager'

434
  var allMissions = missionManager.getMissionInfos("", 10).catch(function (err){
G
guyuanzhang 已提交
435 436 437 438 439 440
    console.log(err);
  });
  console.log("size = " + allMissions.length);
  console.log("missions = " + JSON.stringify(allMissions));
  var id = allMissions[0].missionId;

441
  missionManager.lockMission(id).catch(function (err){
G
guyuanzhang 已提交
442 443
      console.log(err);
  });
444
  missionManager.unlockMission(id).catch(function (err){
G
guyuanzhang 已提交
445 446 447 448 449
      console.log(err);
  });
  ```


Y
yuyaozhi 已提交
450
## missionManager.clearMission
G
guyuanzhang 已提交
451

452
clearMission(missionId: number, callback: AsyncCallback<void>): void;
G
guyuanzhang 已提交
453 454 455

清理指定任务id的任务,无论该任务是否被锁定,以回调函数的方式返回。

Y
yuyaozhi 已提交
456 457 458 459 460
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
461 462 463 464
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |
  | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 |

Y
yuyaozhi 已提交
465
**示例:**
G
guyuanzhang 已提交
466

Y
yuyaozhi 已提交
467
  ```js
G
guyuanzhang 已提交
468 469 470 471 472 473 474 475 476 477 478 479 480 481 482
  import missionManager from '@ohos.application.missionManager'

  missionManager.getMissionInfos("", 10, (error, missions) => {
    console.log("getMissionInfos is called, error.code = " + error.code);
    console.log("size = " + missions.length);
    console.log("missions = " + JSON.stringify(missions));
    var id = missions[0].missionId;

    missionManager.clearMission(id).then(() => {
  	console.log("clearMission is called ");
  });
  });
  ```


Y
yuyaozhi 已提交
483
## missionManager.clearMission
G
guyuanzhang 已提交
484

485
clearMission(missionId: number): Promise<void>;
G
guyuanzhang 已提交
486 487 488

清理指定任务id的任务,无论该任务是否被锁定,以promise的方式返回。

Y
yuyaozhi 已提交
489 490 491 492 493
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
494 495 496
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |

Y
yuyaozhi 已提交
497
**示例:**
G
guyuanzhang 已提交
498

Y
yuyaozhi 已提交
499
  ```js
G
guyuanzhang 已提交
500 501
  import missionManager from '@ohos.application.missionManager'

502
  var allMissions = missionManager.getMissionInfos("", 10).catch(function (err){
G
guyuanzhang 已提交
503 504 505 506 507 508
    console.log(err);
  });
  console.log("size = " + allMissions.length);
  console.log("missions = " + JSON.stringify(allMissions));
  var id = allMissions[0].missionId;

509
  missionManager.clearMission(id).catch(function (err){
G
guyuanzhang 已提交
510 511 512 513 514
    console.log(err);
  });
  ```


Y
yuyaozhi 已提交
515
## missionManager.clearAllMissions
G
guyuanzhang 已提交
516

517
clearAllMissions(callback: AsyncCallback<void>): void;
G
guyuanzhang 已提交
518 519 520

清理所有未锁定的任务,以回调函数的方式返回。

Y
yuyaozhi 已提交
521
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission
G
guyuanzhang 已提交
522

Y
yuyaozhi 已提交
523 524 525
**示例:**

  ```js
G
guyuanzhang 已提交
526 527 528 529 530 531 532 533
  import missionManager from '@ohos.application.missionManager'

  missionManager.clearAllMissions().then(() => {
    console.log("clearAllMissions is called ");
  });
  ```


Y
yuyaozhi 已提交
534
## missionManager.clearAllMissions
G
guyuanzhang 已提交
535

536
clearAllMissions(): Promise<void>;
G
guyuanzhang 已提交
537 538 539

清理所有未锁定的任务,以promise的方式返回。

Y
yuyaozhi 已提交
540
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission
G
guyuanzhang 已提交
541

Y
yuyaozhi 已提交
542 543 544
**示例:**

  ```js
G
guyuanzhang 已提交
545
  import missionManager from '@ohos.application.missionManager'
546
  missionManager.clearAllMissions().catch(function (err){
G
guyuanzhang 已提交
547 548 549 550 551
    console.log(err);
  });
  ```


Y
yuyaozhi 已提交
552
## missionManager.moveMissionToFront
G
guyuanzhang 已提交
553

554
moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void;
G
guyuanzhang 已提交
555 556 557

把指定任务id的任务切到前台,以回调函数的方式返回。

Y
yuyaozhi 已提交
558 559 560 561 562
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
563 564 565 566
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |
  | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 |

Y
yuyaozhi 已提交
567
**示例:**
G
guyuanzhang 已提交
568

Y
yuyaozhi 已提交
569
  ```js
G
guyuanzhang 已提交
570 571 572 573 574 575 576 577 578 579 580 581 582 583 584
  import missionManager from '@ohos.application.missionManager'

  missionManager.getMissionInfos("", 10, (error, missions) => {
    console.log("getMissionInfos is called, error.code = " + error.code);
    console.log("size = " + missions.length);
    console.log("missions = " + JSON.stringify(missions));
    var id = missions[0].missionId;

    missionManager.moveMissionToFront(id).then(() => {
  	console.log("moveMissionToFront is called ");
  });
  });
  ```


Y
yuyaozhi 已提交
585
## missionManager.moveMissionToFront
G
guyuanzhang 已提交
586

587
moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback<void>): void;
G
guyuanzhang 已提交
588 589 590

把指定任务id的任务切到前台,同时指定任务切换到前台时的启动参数,例如窗口模式、设备ID等,以回调函数的方式返回。

Y
yuyaozhi 已提交
591 592 593 594 595
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
596 597 598 599 600
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |
  | options | StartOptions | 是 | 启动参数选项,用于指定任务切到前台时的窗口模式,设备ID等。 |
  | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 |

Y
yuyaozhi 已提交
601
**示例:**
G
guyuanzhang 已提交
602

Y
yuyaozhi 已提交
603
  ```js
G
guyuanzhang 已提交
604 605 606 607 608 609 610 611 612 613 614 615 616 617 618
  import missionManager from '@ohos.application.missionManager'

  missionManager.getMissionInfos("", 10, (error, missions) => {
    console.log("getMissionInfos is called, error.code = " + error.code);
    console.log("size = " + missions.length);
    console.log("missions = " + JSON.stringify(missions));
    var id = missions[0].missionId;

    missionManager.moveMissionToFront(id,{windowMode : 101}).then(() => {
  	console.log("moveMissionToFront is called ");
    });
  });
  ```


Y
yuyaozhi 已提交
619
## missionManager.moveMissionToFront
G
guyuanzhang 已提交
620

621
moveMissionToFront(missionId: number, options?: StartOptions): Promise<void>;
G
guyuanzhang 已提交
622 623 624

把指定任务id的任务切到前台,以promise的方式返回。

Y
yuyaozhi 已提交
625 626 627 628 629
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission

**参数:**

  | 参数名 | 类型 | 必填 | 说明 |
G
guyuanzhang 已提交
630 631 632 633
  | -------- | -------- | -------- | -------- |
  | missionId | number | 是 | 任务ID。 |
  | options | StartOptions | 否 | 启动参数选项,用于指定任务切到前台时的窗口模式,设备ID等。 |

Y
yuyaozhi 已提交
634
**示例:**
G
guyuanzhang 已提交
635

Y
yuyaozhi 已提交
636
  ```js
G
guyuanzhang 已提交
637 638
  import missionManager from '@ohos.application.missionManager'

639
  var allMissions = missionManager.getMissionInfos("", 10).catch(function (err){
G
guyuanzhang 已提交
640 641 642 643 644 645
    console.log(err);
  });
  console.log("size = " + allMissions.length);
  console.log("missions = " + JSON.stringify(allMissions));
  var id = allMissions[0].missionId;

646
  missionManager.moveMissionToFront(id).catch(function (err){
G
guyuanzhang 已提交
647 648 649
    console.log(err);
  });
  ```