js-apis-inner-application-missionSnapshot.md 2.0 KB
Newer Older
G
guyuanzhang 已提交
1 2
# MissionSnapshot

Z
zhongjianfei 已提交
3
一个任务的任务快照对象,可以通过[getMissionSnapShot](js-apis-app-ability-missionManager.md#missionmanagergetmissionsnapshot)获取。
G
guyuanzhang 已提交
4

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

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

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

Y
yuyaozhi 已提交
16 17
## 属性

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

D
merge  
donglin 已提交
20
| 名称 | 类型 | 可读 | 可写 | 说明 |
M
m00512953 已提交
21
| -------- | -------- | -------- | -------- | -------- |
C
caochunlei 已提交
22
| ability | ElementName | 是 | 是 | 表示该任务的组件信息。 |
M
m00512953 已提交
23 24
| snapshot | [image.PixelMap](js-apis-image.md) | 是 | 是 | 表示任务快照。 |

25 26
## 使用说明

27
通过missionManager中的getMissionSnapShot来获取。
G
guyuanzhang 已提交
28

M
m00512953 已提交
29 30
**示例:**
```ts
X
xuzhihao 已提交
31
  import ElementName from '@ohos.bundle.bundleManager';
C
caochunlei 已提交
32 33 34 35
  import image from '@ohos.multimedia.image';
  import missionManager from '@ohos.app.ability.missionManager';

  try {
M
mingxihua 已提交
36
    missionManager.getMissionInfos('', 10, (error, missions) => {
X
xieqiongyang 已提交
37
      if (error) {
X
xieqiongyang 已提交
38
          console.error('getMissionInfos failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}');
C
caochunlei 已提交
39 40
          return;
      }
M
mingxihua 已提交
41 42
      console.log('size = ${missions.length}');
      console.log('missions = ${JSON.stringify(missions)}');
M
mingxihua 已提交
43
      let id = missions[0].missionId;
C
caochunlei 已提交
44

M
mingxihua 已提交
45
      missionManager.getMissionSnapShot('', id, (err, snapshot) => {
X
xieqiongyang 已提交
46
        if (err) {
X
xieqiongyang 已提交
47
          console.error('getMissionInfos failed, err.code: ${JSON.stringify(err.code)}, err.message: ${JSON.stringify(err.message)}');
C
caochunlei 已提交
48 49 50 51
          return;
        }

        // 执行正常业务
M
mingxihua 已提交
52
        console.log('bundleName = ${snapshot.ability.bundleName}');
M
mingxihua 已提交
53 54
      });
    });
C
caochunlei 已提交
55
  } catch (paramError) {
M
mingxihua 已提交
56
    console.error('error: ${paramError.code}, ${paramError.message}');
C
caochunlei 已提交
57
  }
M
m00512953 已提交
58
```