js-apis-inner-application-missionSnapshot.md 1.9 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

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

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

17 18
## 使用说明

19
通过missionManager中的getMissionSnapShot来获取。
G
guyuanzhang 已提交
20

M
m00512953 已提交
21 22
**示例:**
```ts
C
caochunlei 已提交
23 24 25 26 27
  import ElementName from '@ohos.bundle';
  import image from '@ohos.multimedia.image';
  import missionManager from '@ohos.app.ability.missionManager';

  try {
M
mingxihua 已提交
28
    missionManager.getMissionInfos('', 10, (error, missions) => {
C
caochunlei 已提交
29
      if (error.code) {
M
mingxihua 已提交
30
          console.error('getMissionInfos failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}');
C
caochunlei 已提交
31 32
          return;
      }
M
mingxihua 已提交
33 34
      console.log('size = ${missions.length}');
      console.log('missions = ${JSON.stringify(missions)}');
M
mingxihua 已提交
35
      let id = missions[0].missionId;
C
caochunlei 已提交
36

M
mingxihua 已提交
37
      missionManager.getMissionSnapShot('', id, (err, snapshot) => {
C
caochunlei 已提交
38
        if (err.code) {
M
mingxihua 已提交
39
          console.error('getMissionInfos failed, err.code: ${JSON.stringify(err.code)}, err.message: ${JSON.stringify(err.message)}');
C
caochunlei 已提交
40 41 42 43
          return;
        }

        // 执行正常业务
M
mingxihua 已提交
44
        console.log('bundleName = ${snapshot.ability.bundleName}');
M
mingxihua 已提交
45 46
      });
    });
C
caochunlei 已提交
47
  } catch (paramError) {
M
mingxihua 已提交
48
    console.error('error: ${paramError.code}, ${paramError.message}');
C
caochunlei 已提交
49
  }
M
m00512953 已提交
50
```