1# @ohos.application.missionManager (missionManager) 2 3missionManager模块提供系统任务管理能力，包括对系统任务执行锁定、解锁、清理、切换到前台等操作。 4 5> **说明：** 6> 7> 本模块首批接口从API version 8开始支持，从API version 9废弃，替换模块为[@ohos.app.ability.missionManager](js-apis-app-ability-missionManager.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```ts 12import missionManager from '@ohos.application.missionManager'; 13``` 14 15## 权限列表 16 17ohos.permission.MANAGE_MISSIONS 18 19## missionManager.registerMissionListener 20 21registerMissionListener(listener: MissionListener): number; 22 23注册系统任务状态监听器。 24 25**需要权限**：ohos.permission.MANAGE_MISSIONS 26 27**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 28 29**系统API**: 此接口为系统接口，三方应用不支持调用。 30 31**参数：** 32 33 | 参数名 | 类型 | 必填 | 说明 | 34 | -------- | -------- | -------- | -------- | 35 | listener | [MissionListener](js-apis-inner-application-missionListener.md) | 是 | 系统任务监听器。 | 36 37**返回值：** 38 39 | 类型 | 说明 | 40 | -------- | -------- | 41 | number | 监听器的index值，由系统创建，在注册系统任务状态监听器时分配，和监听器一一对应 。 | 42 43**示例：** 44 45```ts 46import missionManager from '@ohos.application.missionManager'; 47 48console.log('registerMissionListener'); 49let listenerid = missionManager.registerMissionListener({ 50 onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, 51 onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, 52 onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, 53 onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, 54 onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, 55 onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, 56 onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} 57}); 58``` 59 60 61## missionManager.unregisterMissionListener 62 63unregisterMissionListener(listenerId: number, callback: AsyncCallback<void>): void; 64 65解注册任务状态监听器。 66 67**需要权限**：ohos.permission.MANAGE_MISSIONS 68 69**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 70 71**系统API**: 此接口为系统接口，三方应用不支持调用。 72 73**参数：** 74 75 | 参数名 | 类型 | 必填 | 说明 | 76 | -------- | -------- | -------- | -------- | 77 | listenerId | number | 是 | 系统任务状态监听器的index值，和监听器一一对应，由registerMissionListener方法返回。 | 78 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 79 80**示例：** 81 82```ts 83 import missionManager from '@ohos.application.missionManager'; 84 85 console.log('registerMissionListener'); 86 let listenerid = missionManager.registerMissionListener({ 87 onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, 88 onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, 89 onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, 90 onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, 91 onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, 92 onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, 93 onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} 94 }); 95 96 missionManager.unregisterMissionListener(listenerid, (error) => { 97 console.error('unregisterMissionListener fail, error: ${error}'); 98 }); 99``` 100 101 102## missionManager.unregisterMissionListener 103 104unregisterMissionListener(listenerId: number): Promise<void>; 105 106反注册任务状态监听器，以promise方式返回执行结果。 107 108**需要权限**：ohos.permission.MANAGE_MISSIONS 109 110**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 111 112**系统API**: 此接口为系统接口，三方应用不支持调用。 113 114**参数：** 115 116 | 参数名 | 类型 | 必填 | 说明 | 117 | -------- | -------- | -------- | -------- | 118 | listenerId | number | 是 | 系统任务状态监听器的index值，和监听器一一对应，由registerMissionListener方法返回。 | 119 120**返回值：** 121 122 | 类型 | 说明 | 123 | -------- | -------- | 124 | Promise<void> | promise方式返回执行结果。 | 125 126**示例：** 127 128```ts 129 import missionManager from '@ohos.application.missionManager'; 130 import { BusinessError } from '@ohos.base'; 131 132 console.log('registerMissionListener'); 133 let listenerid = missionManager.registerMissionListener({ 134 onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, 135 onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, 136 onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, 137 onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, 138 onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, 139 onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, 140 onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} 141 }); 142 143 missionManager.unregisterMissionListener(listenerid).catch((error: BusinessError) => { 144 console.error('unregisterMissionListener fail, error: ${error}'); 145 }); 146``` 147 148 149## missionManager.getMissionInfo 150 151getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<MissionInfo>): void; 152 153获取单个任务信息，以异步回调的方式返回任务信息。 154 155**需要权限**：ohos.permission.MANAGE_MISSIONS 156 157**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 158 159**系统API**: 此接口为系统接口，三方应用不支持调用。 160 161**参数：** 162 163 | 参数名 | 类型 | 必填 | 说明 | 164 | -------- | -------- | -------- | -------- | 165 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 166 | missionId | number | 是 | 任务ID。 | 167 | callback | AsyncCallback<[MissionInfo](js-apis-inner-application-missionInfo.md)> | 是 | 执行结果回调函数，返回任务信息。 | 168 169**示例：** 170 171 ```ts 172 import missionManager from '@ohos.application.missionManager'; 173 import { BusinessError } from '@ohos.base'; 174 175 let allMissions=missionManager.getMissionInfos('',10).catch((err: BusinessError) => { 176 console.log('${err}');}); 177 missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => { 178 if (error.code) { 179 console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}'); 180 return; 181 } 182 183 console.log('mission.missionId = ${mission.missionId}'); 184 console.log('mission.runningState = ${mission.runningState}'); 185 console.log('mission.lockedState = ${mission.lockedState}'); 186 console.log('mission.timestamp = ${mission.timestamp}'); 187 console.log('mission.label = ${mission.label}'); 188 console.log('mission.iconPath = ${mission.iconPath}'); 189 }); 190 ``` 191 192 193## missionManager.getMissionInfo 194 195getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>; 196 197获取单个任务信息，以promise方式返回任务信息。 198 199**需要权限**：ohos.permission.MANAGE_MISSIONS 200 201**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 202 203**系统API**: 此接口为系统接口，三方应用不支持调用。 204 205**参数：** 206 207 | 参数名 | 类型 | 必填 | 说明 | 208 | -------- | -------- | -------- | -------- | 209 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 210 | missionId | number | 是 | 任务ID。 | 211 212**返回值：** 213 214 | 类型 | 说明 | 215 | -------- | -------- | 216 | Promise<[MissionInfo](js-apis-inner-application-missionInfo.md)> | 任务信息。 | 217 218**示例：** 219 220 ```ts 221 import missionManager from '@ohos.application.missionManager'; 222 import { BusinessError } from '@ohos.base'; 223 224 let mission = missionManager.getMissionInfo('', 10).catch((error: BusinessError) => { 225 console.error('getMissionInfo fail, error: ${error}'); 226 }); 227 ``` 228 229 230## missionManager.getMissionInfos 231 232getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Array<MissionInfo>>): void; 233 234获取所有任务信息，以回调函数的方式返回任务信息数组。 235 236**需要权限**：ohos.permission.MANAGE_MISSIONS 237 238**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 239 240**系统API**: 此接口为系统接口，三方应用不支持调用。 241 242**参数：** 243 244 | 参数名 | 类型 | 必填 | 说明 | 245 | -------- | -------- | -------- | -------- | 246 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 247 | numMax | number | 是 | 任务信息数量上限。 | 248 | callback | AsyncCallback<Array<[MissionInfo](js-apis-inner-application-missionInfo.md)>> | 是 | 执行结果回调函数，返回任务信息数组。 | 249 250**示例：** 251 252 ```ts 253 import missionManager from '@ohos.application.missionManager'; 254 255 missionManager.getMissionInfos('', 10, (error, missions) => { 256 if (error.code) { 257 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 258 return; 259 } 260 console.log(`size = ${missions.length}`); 261 console.log(`missions = ${JSON.stringify(missions)}`); 262 }); 263 ``` 264 265 266## missionManager.getMissionInfos 267 268getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionInfo>>; 269 270获取所有任务信息，以promise的方式返回任务信息数组。 271 272**需要权限**：ohos.permission.MANAGE_MISSIONS 273 274**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 275 276**系统API**: 此接口为系统接口，三方应用不支持调用。 277 278**参数：** 279 280 | 参数名 | 类型 | 必填 | 说明 | 281 | -------- | -------- | -------- | -------- | 282 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 283 | numMax | number | 是 | 任务信息数量上限。 | 284 285**返回值：** 286 287 | 类型 | 说明 | 288 | -------- | -------- | 289 | Promise<Array<[MissionInfo](js-apis-inner-application-missionInfo.md)>> | 任务信息数组。 | 290 291**示例：** 292 293 ```ts 294 import missionManager from '@ohos.application.missionManager'; 295 import { BusinessError } from '@ohos.base'; 296 297 let allMissions = missionManager.getMissionInfos('', 10).catch((error: BusinessError) => { 298 console.error('getMissionInfos fail, error: ${error}'); 299 }); 300 ``` 301 302 303## missionManager.getMissionSnapShot 304 305getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback<MissionSnapshot>): void; 306 307获取任务快照，以回调函数的方式返回快照内容。 308 309**需要权限**：ohos.permission.MANAGE_MISSIONS 310 311**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 312 313**系统API**: 此接口为系统接口，三方应用不支持调用。 314 315**参数：** 316 317 | 参数名 | 类型 | 必填 | 说明 | 318 | -------- | -------- | -------- | -------- | 319 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 320 | missionId | number | 是 | 任务ID。 | 321 | callback | AsyncCallback<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | 是 | 执行结果回调函数，返回任务快照信息。 | 322 323**示例：** 324 325 ```ts 326 import missionManager from '@ohos.application.missionManager'; 327 328 missionManager.getMissionInfos('', 10, (error, missions) => { 329 if (error.code) { 330 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 331 return; 332 } 333 console.log(`size = ${missions.length}`); 334 console.log(`missions = ${JSON.stringify(missions)}`); 335 let id = missions[0].missionId; 336 337 missionManager.getMissionSnapShot('', id, (error, snapshot) => { 338 if (error.code) { 339 console.error(`getMissionSnapShot failed, error.code: ${error.code}, error.message: ${error.message}`); 340 return; 341 } 342 console.log(`bundleName = ${snapshot.ability.bundleName}`); 343 }); 344 }); 345 ``` 346 347 348## missionManager.getMissionSnapShot 349 350getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnapshot>; 351 352获取任务快照，以promise的方式返回快照内容。 353 354**需要权限**：ohos.permission.MANAGE_MISSIONS 355 356**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 357 358**系统API**: 此接口为系统接口，三方应用不支持调用。 359 360**参数：** 361 362 | 参数名 | 类型 | 必填 | 说明 | 363 | -------- | -------- | -------- | -------- | 364 | deviceId | string | 是 | 设备ID，本机默认为空字符串。 | 365 | missionId | number | 是 | 任务ID。 | 366 367**返回值：** 368 369 | 类型 | 说明 | 370 | -------- | -------- | 371 | Promise<[MissionSnapshot](js-apis-inner-application-missionSnapshot.md)> | 任务快照信息。 | 372 373**示例：** 374 375 ```ts 376 import missionManager from '@ohos.application.missionManager'; 377 import { BusinessError } from '@ohos.base'; 378 379 let id: number = -1; 380 missionManager.getMissionInfos('',10).then((res) => { 381 let allMissions = res; 382 console.log(`size = ${allMissions.length}`); 383 console.log(`missions = ${JSON.stringify(allMissions)}`); 384 id = allMissions[0].missionId; 385 }).catch((error: BusinessError) => { 386 console.error(`getMissionInfos fail, error: ${error}`); 387 }); 388 389 let snapshot = missionManager.getMissionSnapShot('', id).catch((error: BusinessError) => { 390 console.error(`getMissionSnapShot fail, error: ${error}`); 391 }); 392 ``` 393 394## missionManager.lockMission 395 396lockMission(missionId: number, callback: AsyncCallback<void>): void; 397 398锁定指定任务id的任务，以回调函数的方式返回。 399 400**需要权限**：ohos.permission.MANAGE_MISSIONS 401 402**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 403 404**系统API**: 此接口为系统接口，三方应用不支持调用。 405 406**参数：** 407 408 | 参数名 | 类型 | 必填 | 说明 | 409 | -------- | -------- | -------- | -------- | 410 | missionId | number | 是 | 任务ID。 | 411 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 412 413**示例：** 414 415 ```ts 416 import missionManager from '@ohos.application.missionManager'; 417 418 missionManager.getMissionInfos('', 10, (error, missions) => { 419 if (error.code) { 420 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 421 return; 422 } 423 console.log(`size = ${missions.length}`); 424 console.log(`missions = ${JSON.stringify(missions)}`); 425 let id = missions[0].missionId; 426 427 missionManager.lockMission(id).then(() => { 428 console.log('lockMission is called '); 429 }); 430 }); 431 ``` 432 433 434## missionManager.lockMission 435 436lockMission(missionId: number): Promise<void>; 437 438锁定指定任务id的任务，以promise方式返回。 439 440**需要权限**：ohos.permission.MANAGE_MISSIONS 441 442**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 443 444**系统API**: 此接口为系统接口，三方应用不支持调用。 445 446**参数：** 447 448 | 参数名 | 类型 | 必填 | 说明 | 449 | -------- | -------- | -------- | -------- | 450 | missionId | number | 是 | 任务ID。 | 451 452**返回值：** 453 454 | 类型 | 说明 | 455 | -------- | -------- | 456 | Promise<void> | promise方式返回执行结果。 | 457 458**示例：** 459 460 ```ts 461 import missionManager from '@ohos.application.missionManager'; 462 import { BusinessError } from '@ohos.base'; 463 464 let id: number = -1; 465 missionManager.getMissionInfos('',10).then((res) => { 466 let allMissions = res; 467 console.log(`size = ${allMissions.length}`); 468 console.log(`missions = ${JSON.stringify(allMissions)}`); 469 id = allMissions[0].missionId; 470 }).catch((error: BusinessError) => { 471 console.error(`getMissionInfos fail, error: ${error}`); 472 }); 473 474 missionManager.lockMission(id).catch((error: BusinessError) => { 475 console.error(`lockMission fail, error: ${error}`); 476 }); 477 ``` 478 479 480## missionManager.unlockMission 481 482unlockMission(missionId: number, callback: AsyncCallback<void>): void; 483 484解锁指定任务id的任务，以回调函数的方式返回。 485 486**需要权限**：ohos.permission.MANAGE_MISSIONS 487 488**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 489 490**系统API**: 此接口为系统接口，三方应用不支持调用。 491 492**参数：** 493 494| 参数名 | 类型 | 必填 | 说明 | 495| -------- | -------- | -------- | -------- | 496| missionId | number | 是 | 任务ID。 | 497| callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 498 499**示例：** 500 501 ```ts 502 import missionManager from '@ohos.application.missionManager'; 503 504 missionManager.getMissionInfos('', 10, (error, missions) => { 505 if (error.code) { 506 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 507 return; 508 } 509 console.log(`size = ${missions.length}`); 510 console.log(`missions = ${JSON.stringify(missions)}`); 511 let id = missions[0].missionId; 512 513 missionManager.unlockMission(id).then(() => { 514 console.log('unlockMission is called '); 515 }); 516 }); 517 ``` 518 519 520## missionManager.unlockMission 521 522unlockMission(missionId: number): Promise<void>; 523 524解锁指定任务id的任务，以promise的方式返回。 525 526**需要权限**：ohos.permission.MANAGE_MISSIONS 527 528**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 529 530**系统API**: 此接口为系统接口，三方应用不支持调用。 531 532**参数：** 533 534 | 参数名 | 类型 | 必填 | 说明 | 535 | -------- | -------- | -------- | -------- | 536 | missionId | number | 是 | 任务ID。 | 537 538**返回值：** 539 540 | 类型 | 说明 | 541 | -------- | -------- | 542 | Promise<void> | promise方式返回执行结果。 | 543 544**示例：** 545 546 ```ts 547 import missionManager from '@ohos.application.missionManager'; 548 import { BusinessError } from '@ohos.base'; 549 550 let id: number = -1; 551 missionManager.getMissionInfos('',10).then((res) => { 552 let allMissions = res; 553 console.log(`size = ${allMissions.length}`); 554 console.log(`missions = ${JSON.stringify(allMissions)}`); 555 id = allMissions[0].missionId; 556 }).catch((error: BusinessError) => { 557 console.error(`getMissionInfos fail, error: ${error}`); 558 }); 559 560 missionManager.lockMission(id).catch((error: BusinessError) => { 561 console.error(`lockMission fail, error: ${error}`); 562 }); 563 missionManager.unlockMission(id).catch((error: BusinessError) => { 564 console.error(`unlockMission fail, error: ${error}`); 565 }); 566 ``` 567 568 569## missionManager.clearMission 570 571clearMission(missionId: number, callback: AsyncCallback<void>): void; 572 573清理指定任务id的任务，无论该任务是否被锁定，以回调函数的方式返回。 574 575**需要权限**：ohos.permission.MANAGE_MISSIONS 576 577**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 578 579**系统API**: 此接口为系统接口，三方应用不支持调用。 580 581**参数：** 582 583 | 参数名 | 类型 | 必填 | 说明 | 584 | -------- | -------- | -------- | -------- | 585 | missionId | number | 是 | 任务ID。 | 586 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 587 588**示例：** 589 590 ```ts 591 import missionManager from '@ohos.application.missionManager'; 592 593 missionManager.getMissionInfos('', 10, (error, missions) => { 594 if (error.code) { 595 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 596 return; 597 } 598 console.log(`size = ${missions.length}`); 599 console.log(`missions = ${JSON.stringify(missions)}`); 600 let id = missions[0].missionId; 601 602 missionManager.clearMission(id).then(() => { 603 console.log('clearMission is called '); 604 }); 605 }); 606 ``` 607 608 609## missionManager.clearMission 610 611clearMission(missionId: number): Promise<void>; 612 613清理指定任务id的任务，无论该任务是否被锁定，以promise的方式返回。 614 615**需要权限**：ohos.permission.MANAGE_MISSIONS 616 617**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 618 619**系统API**: 此接口为系统接口，三方应用不支持调用。 620 621**参数：** 622 623 | 参数名 | 类型 | 必填 | 说明 | 624 | -------- | -------- | -------- | -------- | 625 | missionId | number | 是 | 任务ID。 | 626 627**返回值：** 628 629 | 类型 | 说明 | 630 | -------- | -------- | 631 | Promise<void> | promise方式返回执行结果。 | 632 633**示例：** 634 635 ```ts 636 import missionManager from '@ohos.application.missionManager'; 637 import { BusinessError } from '@ohos.base'; 638 639 let id: number = -1; 640 missionManager.getMissionInfos('',10).then((res) => { 641 let allMissions = res; 642 console.log(`size = ${allMissions.length}`); 643 console.log(`missions = ${JSON.stringify(allMissions)}`); 644 id = allMissions[0].missionId; 645 }).catch((error: BusinessError) => { 646 console.error(`getMissionInfos fail, error: ${error}`); 647 }); 648 649 missionManager.clearMission(id).catch((error: BusinessError) => { 650 console.error(`clearMission fail, error: ${error}`); 651 }); 652 ``` 653 654 655## missionManager.clearAllMissions 656 657clearAllMissions(callback: AsyncCallback<void>): void; 658 659清理所有未锁定的任务，以回调函数的方式返回。 660 661**需要权限**：ohos.permission.MANAGE_MISSIONS 662 663**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 664 665**系统API**: 此接口为系统接口，三方应用不支持调用。 666 667**示例：** 668 669 ```ts 670 import missionManager from '@ohos.application.missionManager' 671 672 missionManager.clearAllMissions().then(() => { 673 console.log('clearAllMissions is called '); 674 }); 675 ``` 676 677 678## missionManager.clearAllMissions 679 680clearAllMissions(): Promise<void>; 681 682清理所有未锁定的任务，以promise的方式返回。 683 684**需要权限**：ohos.permission.MANAGE_MISSIONS 685 686**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 687 688**系统API**: 此接口为系统接口，三方应用不支持调用。 689 690**返回值：** 691 692 | 类型 | 说明 | 693 | -------- | -------- | 694 | Promise<void> | promise方式返回执行结果。 | 695 696**示例：** 697 698 ```ts 699 import missionManager from '@ohos.application.missionManager'; 700 import { BusinessError } from '@ohos.base'; 701 702 missionManager.clearAllMissions().catch((error: BusinessError) => { 703 console.error('clearAllMissions fail, error: ${error}'); 704 }); 705 ``` 706 707 708## missionManager.moveMissionToFront 709 710moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void; 711 712把指定任务id的任务切到前台，以回调函数的方式返回。 713 714**需要权限**：ohos.permission.MANAGE_MISSIONS 715 716**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 717 718**系统API**: 此接口为系统接口，三方应用不支持调用。 719 720**参数：** 721 722 | 参数名 | 类型 | 必填 | 说明 | 723 | -------- | -------- | -------- | -------- | 724 | missionId | number | 是 | 任务ID。 | 725 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 726 727**示例：** 728 729 ```ts 730 import missionManager from '@ohos.application.missionManager'; 731 732 missionManager.getMissionInfos('', 10, (error, missions) => { 733 if (error.code) { 734 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 735 return; 736 } 737 console.log(`size = ${missions.length}`); 738 console.log(`missions = ${JSON.stringify(missions)}`); 739 let id = missions[0].missionId; 740 741 missionManager.moveMissionToFront(id).then(() => { 742 console.log('moveMissionToFront is called '); 743 }); 744 }); 745 ``` 746 747 748## missionManager.moveMissionToFront 749 750moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback<void>): void; 751 752把指定任务id的任务切到前台，同时指定任务切换到前台时的启动参数，例如窗口模式、设备ID等，以回调函数的方式返回。 753 754**需要权限**：ohos.permission.MANAGE_MISSIONS 755 756**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 757 758**系统API**: 此接口为系统接口，三方应用不支持调用。 759 760**参数：** 761 762 | 参数名 | 类型 | 必填 | 说明 | 763 | -------- | -------- | -------- | -------- | 764 | missionId | number | 是 | 任务ID。 | 765 | options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动参数选项，用于指定任务切到前台时的窗口模式，设备ID等。 | 766 | callback | AsyncCallback<void> | 是 | 执行结果回调函数。 | 767 768**示例：** 769 770 ```ts 771 import missionManager from '@ohos.application.missionManager'; 772 773 missionManager.getMissionInfos('', 10, (error, missions) => { 774 if (error.code) { 775 console.error(`getMissionInfos failed, error.code: ${error.code}, error.message: ${error.message}`); 776 return; 777 } 778 console.log(`size = ${missions.length}`); 779 console.log(`missions = ${JSON.stringify(missions)}`); 780 let id = missions[0].missionId; 781 782 missionManager.moveMissionToFront(id,{windowMode : 101}).then(() => { 783 console.log('moveMissionToFront is called '); 784 }); 785 }); 786 ``` 787 788 789## missionManager.moveMissionToFront 790 791moveMissionToFront(missionId: number, options?: StartOptions): Promise<void>; 792 793把指定任务id的任务切到前台，同时指定任务切换到前台时的启动参数，例如窗口模式、设备ID等，以promise的方式返回。 794 795**需要权限**：ohos.permission.MANAGE_MISSIONS 796 797**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission 798 799**系统API**: 此接口为系统接口，三方应用不支持调用。 800 801**参数：** 802 803 | 参数名 | 类型 | 必填 | 说明 | 804 | -------- | -------- | -------- | -------- | 805 | missionId | number | 是 | 任务ID。 | 806 | options | [StartOptions](js-apis-app-ability-startOptions.md) | 否 | 启动参数选项，用于指定任务切到前台时的窗口模式，设备ID等。 | 807 808**返回值：** 809 810 | 类型 | 说明 | 811 | -------- | -------- | 812 | Promise<void> | promise方式返回执行结果。 | 813 814**示例：** 815 816 ```ts 817 import missionManager from '@ohos.application.missionManager'; 818 import { BusinessError } from '@ohos.base'; 819 820 let id: number = -1; 821 missionManager.getMissionInfos('',10).then((res) => { 822 let allMissions = res; 823 console.log(`size = ${allMissions.length}`); 824 console.log(`missions = ${JSON.stringify(allMissions)}`); 825 id = allMissions[0].missionId; 826 }).catch((error: BusinessError) => { 827 console.error(`getMissionInfos fail, error: ${error}`); 828 }); 829 830 missionManager.moveMissionToFront(id).catch((error: BusinessError) => { 831 console.error(`moveMissionToFront fail, error: ${error}`); 832 }); 833 ```