js-apis-inner-application-missionInfo.md 2.5 KB
Newer Older
M
m00512953 已提交
1 2
# MissionInfo

C
caochunlei 已提交
3
表示任务的详细信息,可以通过[getMissionInfo](js-apis-app-ability-missionManager.md#missionmanagergetmissioninfo)获取。
M
m00512953 已提交
4

5 6 7 8
> **说明:**
> 
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 

9 10 11 12 13 14
## 导入模块

```ts
import missionManager from '@ohos.app.ability.missionManager';
```

M
m00512953 已提交
15 16 17 18
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission

**系统API**: 此接口为系统接口,三方应用不支持调用。

Z
zhongjianfei 已提交
19
| 名称 | 类型 | 可读 | 可写 | 说明 |
M
m00512953 已提交
20
| -------- | -------- | -------- | -------- | -------- |
Z
zhongjianfei 已提交
21 22 23 24 25 26 27 28
| missionId | number | 是 | 是 | 表示任务ID。|
| runningState | number | 是 | 是 | 表示运行状态。 |
| lockedState | boolean | 是 | 是 | 表示锁定状态。 |
| timestamp | string | 是 | 是 | 表示任务的最近创建或更新时间。 |
| want | [Want](js-apis-application-want.md) | 是 | 是 | 表示任务的Want信息。 |
| label | string | 是 | 是 | 表示任务的标签。 |
| iconPath | string | 是 | 是 | 表示任务的图标路径。 |
| continuable | boolean | 是 | 是 | 表示任务是否可以迁移。 |
X
xinking129 已提交
29
| unclearable<sup>10+</sup> | boolean | 是 | 是 | 表示任务是否可以被用户手动删除。 |
M
m00512953 已提交
30 31 32

**示例:**
```ts
M
mingxihua 已提交
33
import missionManager from '@ohos.app.ability.missionManager';
M
m00512953 已提交
34

C
caochunlei 已提交
35
try {
M
mingxihua 已提交
36
  missionManager.getMissionInfo('', 1, (error, data) => {
X
xieqiongyang 已提交
37
    if (error) {
C
caochunlei 已提交
38
        // 处理业务逻辑错误
Z
zhoujun62 已提交
39
        console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}');
C
caochunlei 已提交
40 41 42
        return;
    }

M
mingxihua 已提交
43 44 45 46 47 48 49 50
    console.log('getMissionInfo missionId is: ${JSON.stringify(data.missionId)}');
    console.log('getMissionInfo runningState is: ${JSON.stringify(data.runningState)}');
    console.log('getMissionInfo lockedState is: ${JSON.stringify(data.lockedState)}');
    console.log('getMissionInfo timestamp is: ${JSON.stringify(data.timestamp)}');
    console.log('getMissionInfo want is: ${JSON.stringify(data.want)}');
    console.log('getMissionInfo label is: ${JSON.stringify(data.label)}');
    console.log('getMissionInfo iconPath is: ${JSON.stringify(data.iconPath)}');
    console.log('getMissionInfo continuable is: ${JSON.stringify(data.continuable)}');
51
    console.log('getMissionInfo unclearable is: ${JSON.stringify(data.unclearable)}');
C
caochunlei 已提交
52 53
    });
} catch (paramError) {
M
mingxihua 已提交
54
    console.error('error: ${paramError.code}, ${paramError.message}');
C
caochunlei 已提交
55
}
M
m00512953 已提交
56
```