• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# MissionCallback (系统接口)
2<!--Kit: Ability Kit-->
3<!--Subsystem: Ability-->
4<!--Owner: @hobbycao-->
5<!--Designer: @gsxiaowen-->
6<!--Tester: @hanjiawei-->
7<!--Adviser: @huipeizi-->
8
9作为可以[registerMissionListener](js-apis-distributedMissionManager-sys.md#distributedmissionmanagerregistermissionlistener)的入参，表示开始同步后，建立的回调函数。
10
11> **说明：**
12>
13> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
14> 本模块接口为系统接口。
15
16## 导入模块
17
18```ts
19import { distributedMissionManager } from '@kit.AbilityKit';
20```
21
22## MissionCallback.notifyMissionsChanged
23
24notifyMissionsChanged(deviceId: string): void
25
26注册任务监听的callback，通知任务变化。
27
28**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
29
30**系统接口**：此接口为系统接口。
31
32**参数：**
33
34| 参数名 | 类型 | 必填 | 说明 |
35| -------- | -------- | -------- | -------- |
36| deviceId |  string | 是 | 通知任务变化，返回设备ID。|
37
38**示例：**
39
40```ts
41import { distributedMissionManager } from '@kit.AbilityKit';
42
43distributedMissionManager.registerMissionListener(
44  {
45    deviceId: '123456'
46  },
47  {
48    notifyMissionsChanged: (deviceId: string) => {
49      console.log(`notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}`);
50    },
51    notifySnapshot: (deviceId: string, mission: number) => {
52      console.log(`notifySnapshot deviceId: ${JSON.stringify(deviceId)}`);
53      console.log(`notifySnapshot mission: ${JSON.stringify(mission)}`);
54    },
55    notifyNetDisconnect: (deviceId: string, state: number) => {
56      console.log(`notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}`);
57      console.log(`notifyNetDisconnect state: ${JSON.stringify(state)}`);
58    }
59  }
60);
61```
62
63## MissionCallback.notifySnapshot
64
65notifySnapshot(deviceId: string, mission: number): void
66
67注册任务监听的callback，通知快照变化。
68
69**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
70
71**系统接口**：此接口为系统接口。
72
73**参数：**
74
75| 参数名 | 类型 | 必填 | 说明 |
76| -------- | -------- | -------- | -------- |
77| deviceId |  string | 是 | 通知快照变化，返回设备ID。 |
78| mission |  number | 是 | 通知快照变化，任务ID。 |
79
80**示例：**
81```ts
82import { distributedMissionManager } from '@kit.AbilityKit';
83
84distributedMissionManager.registerMissionListener(
85  {
86    deviceId: '123456'
87  },
88  {
89    notifyMissionsChanged: (deviceId: string) => {
90      console.log(`notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}`);
91    },
92    notifySnapshot: (deviceId: string, mission: number) => {
93      console.log(`notifySnapshot deviceId: ${JSON.stringify(deviceId)}`);
94      console.log(`notifySnapshot mission: ${JSON.stringify(mission)}`);
95    },
96    notifyNetDisconnect: (deviceId: string, state: number) => {
97      console.log(`notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}`);
98      console.log(`notifyNetDisconnect state: ${JSON.stringify(state)}`);
99    }
100  }
101);
102```
103
104## MissionCallback.notifyNetDisconnect
105
106notifyNetDisconnect(deviceId: string, state: number): void
107
108注册任务监听的callback，通知断开连接。
109
110**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
111
112**系统接口**：此接口为系统接口。
113
114**参数：**
115
116| 参数名 | 类型 | 必填 | 说明 |
117| -------- | -------- | -------- | -------- |
118| deviceId |  string | 是 | 通知断开连接，返回设备ID。 |
119| state |  number | 是 | 通知断开连接，返回网络状态。0：连接断开（固定值）。 |
120
121**示例：**
122
123```ts
124import { distributedMissionManager } from '@kit.AbilityKit';
125
126distributedMissionManager.registerMissionListener(
127  {
128    deviceId: '123456'
129  },
130  {
131    notifyMissionsChanged: (deviceId: string) => {
132      console.log(`notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}`);
133    },
134    notifySnapshot: (deviceId: string, mission: number) => {
135      console.log(`notifySnapshot deviceId: ${JSON.stringify(deviceId)}`);
136      console.log(`notifySnapshot mission: ${JSON.stringify(mission)}`);
137    },
138    notifyNetDisconnect: (deviceId: string, state: number) => {
139      console.log(`notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}`);
140      console.log(`notifyNetDisconnect state: ${JSON.stringify(state)}`);
141    }
142  }
143);
144```
145