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```