• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# MissionSnapshot
2
3一个任务的任务快照对象,可以通过[getMissionSnapShot](js-apis-app-ability-missionManager.md#missionmanagergetmissionsnapshot)获取。
4
5> **说明:**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 本模块接口均为系统接口,三方应用不支持调用
9
10## 导入模块
11
12```ts
13import missionManager from '@ohos.app.ability.missionManager';
14```
15
16## 属性
17
18**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
19
20| 名称 | 类型 | 可读 | 可写 | 说明 |
21| -------- | -------- | -------- | -------- | -------- |
22| ability | ElementName | 是 | 是 | 表示该任务的组件信息。 |
23| snapshot | [image.PixelMap](js-apis-image.md) | 是 | 是 | 表示任务快照。 |
24
25## 使用说明
26
27通过missionManager中的getMissionSnapShot来获取。
28
29**示例:**
30```ts
31  import ElementName from '@ohos.bundle.bundleManager';
32  import image from '@ohos.multimedia.image';
33  import missionManager from '@ohos.app.ability.missionManager';
34
35  try {
36    missionManager.getMissionInfos('', 10, (error, missions) => {
37      if (error) {
38          console.error(`getMissionInfos failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
39          return;
40      }
41      console.log(`size = ${missions.length}`);
42      console.log(`missions = ${JSON.stringify(missions)}`);
43      let id = missions[0].missionId;
44
45      missionManager.getMissionSnapShot('', id, (err, snapshot) => {
46        if (err) {
47          console.error(`getMissionInfos failed, err.code: ${JSON.stringify(err.code)}, err.message: ${JSON.stringify(err.message)}`);
48          return;
49        }
50
51        // 执行正常业务
52        console.log(`bundleName = ${snapshot.ability.bundleName}`);
53      });
54    });
55  } catch (paramError) {
56    console.error(`error: ${paramError.code}, ${paramError.message}`);
57  }
58```