harmony 鸿蒙MissionSnapshot

2022-12-13
浏览 (581)

MissionSnapshot

一个任务的任务快照对象，可以通过getMissionSnapShot获取。

说明：

本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。本模块接口均为系统接口，三方应用不支持调用

导入模块

import missionManager from '@ohos.app.ability.missionManager';

属性

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission

名称	类型	可读	可写	说明
ability	ElementName	是	是	表示该任务的组件信息。
snapshot	image.PixelMap	是	是	表示任务快照。

使用说明

通过missionManager中的getMissionSnapShot来获取。

示例：

  import ElementName from '@ohos.bundle.bundleManager';
  import image from '@ohos.multimedia.image';
  import missionManager from '@ohos.app.ability.missionManager';

  try {
    missionManager.getMissionInfos('', 10, (error, missions) => {
      if (error) {
          console.error(`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)}`);
      let id = missions[0].missionId;

      missionManager.getMissionSnapShot('', id, (err, snapshot) => {
        if (err) {
          console.error(`getMissionInfos failed, err.code: ${JSON.stringify(err.code)}, err.message: ${JSON.stringify(err.message)}`);
          return;
        }

        // 执行正常业务
        console.log(`bundleName = ${snapshot.ability.bundleName}`);
      });
    });
  } catch (paramError) {
    console.error(`error: ${paramError.code}, ${paramError.message}`);
  }