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 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51
  import ElementName from '@ohos.bundle';
  import image from '@ohos.multimedia.image';
  import missionManager from '@ohos.app.ability.missionManager';

  try {
    missionManager.getMissionInfos("", 10, (error, missions) => {
      if (error.code) {
          console.log("getMissionInfos failed, error.code:" + JSON.stringify(error.code) +
            "error.message:" + JSON.stringify(error.message));
          return;
      }
      console.log("size = " + missions.length);
      console.log("missions = " + JSON.stringify(missions));
      var id = missions[0].missionId;

      missionManager.getMissionSnapShot("", id, (err, snapshot) => {
        if (err.code) {
          console.log("getMissionInfos failed, err.code:" + JSON.stringify(err.code) +
            "err.message:" + JSON.stringify(err.message));
          return;
        }

        // 执行正常业务
        console.log("bundleName = " + snapshot.ability.bundleName);
      })
    })
  } catch (paramError) {
    console.log("error: " + paramError.code + ", " + paramError.message);
  }
M
m00512953 已提交
52
```