• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# MissionListener
2
3定义系统任务状态监听,可以通过[registerMissionListener](js-apis-application-missionManager.md#missionmanagerregistermissionlistener)注册。
4
5> **说明:**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import missionManager from '@ohos.app.ability.missionManager';
13```
14
15**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
16
17| 名称        | 类型                 | 必填 | 说明                                                         |
18| ----------- | -------- | ---- | ------------------------------------------------------------ |
19| onMissionCreated    | function               | 否   | 表示当系统创建任务时回调执行。                                |
20| onMissionDestroyed   | function               | 否   | 表示当系统销毁任务时回调执行。 |
21| onMissionSnapshotChanged   | function               | 否   | 表示当系统更新任务缩略图时回调执行。 |
22| onMissionMovedToFront   | function               | 否   | 表示当系统将任务移动到前台时回调执行。 |
23| onMissionLabelUpdated<sup>9+</sup>   | function               | 否   | 表示当系统更新任务标签时回调执行。 |
24| onMissionIconUpdated<sup>9+</sup>   | function               | 否   | 表示当系统更新任务图标时回调执行。 |
25| onMissionClosed<sup>9+</sup>   | function               | 否   | 表示当系统关闭任务时回调执行。 |
26
27**示例:**
28```ts
29import missionManager from '@ohos.application.missionManager';
30
31let listener = {
32    onMissionCreated: function (mission) {
33        console.log('onMissionCreated mission: ' + JSON.stringify(mission));
34    },
35    onMissionDestroyed: function (mission) {
36        console.log('onMissionDestroyed mission: ' + JSON.stringify(mission));
37    },
38    onMissionSnapshotChanged: function (mission) {
39        console.log('onMissionSnapshotChanged mission: ' + JSON.stringify(mission));
40    },
41    onMissionMovedToFront: function (mission) {
42        console.log('onMissionMovedToFront mission: ' + JSON.stringify(mission));
43    },
44    onMissionLabelUpdated: function (mission) {
45        console.log('onMissionLabelUpdated mission: ' + JSON.stringify(mission));
46    },
47    onMissionIconUpdated: function (mission, icon) {
48        console.log('onMissionIconUpdated mission: ' + JSON.stringify(mission));
49        console.log('onMissionIconUpdated icon: ' + JSON.stringify(icon));
50    },
51    onMissionClosed: function (mission) {
52        console.log('onMissionClosed mission: ' + JSON.stringify(mission));
53    }
54};
55let listenerid = missionManager.registerMissionListener(listener);
56```