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