harmony 鸿蒙MissionSnapshot

2022-12-22
浏览 (632)

MissionSnapshot

The MissionSnapshot module defines the snapshot of a mission. The snapshot can be obtained through getMissionSnapShot.

NOTE

The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version. The APIs of this module are system APIs and cannot be called by third-party applications.

Modules to Import

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

Attributes

System capability: SystemCapability.Ability.AbilityRuntime.Mission

Name	Type	Readable	Writable	Description
ability	ElementName	Yes	Yes	Ability information of the mission.
snapshot	image.PixelMap	Yes	Yes	Snapshot of the mission.

How to Use

The mission snapshot information can be obtained by using getMissionSnapShot in missionManager.

Example

  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;
        }

        // Carry out normal service processing.
        console.log(`bundleName = ${snapshot.ability.bundleName}`);
      });
    });
  } catch (paramError) {
    console.error(`error: ${paramError.code}, ${paramError.message}`);
  }