MissionInfo

表示任务的详细信息,可以通过getMissionInfo获取。

说明:

本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

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

属性

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

系统API: 此接口为系统接口,三方应用不支持调用。

名称 类型 可读 可写 说明
missionId number 表示任务ID。
runningState number 表示运行状态。
lockedState boolean 表示锁定状态。
timestamp string 表示任务的最近创建或更新时间。
want Want 表示任务的Want信息。
label string 表示任务的标签。
iconPath string 表示任务的图标路径。
continuable boolean 表示任务是否可以迁移。
abilityState10+ number 表示此任务的能力状态。
unclearable10+ boolean 表示任务是否可以被用户手动删除。

示例:

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

try {
  missionManager.getMissionInfo('', 1, (error, data) => {
    if (error) {
        // 处理业务逻辑错误
        console.error(`getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}`);
        return;
    }

    console.log(`getMissionInfo missionId is: ${JSON.stringify(data.missionId)}`);
    console.log(`getMissionInfo runningState is: ${JSON.stringify(data.runningState)}`);
    console.log(`getMissionInfo lockedState is: ${JSON.stringify(data.lockedState)}`);
    console.log(`getMissionInfo timestamp is: ${JSON.stringify(data.timestamp)}`);
    console.log(`getMissionInfo want is: ${JSON.stringify(data.want)}`);
    console.log(`getMissionInfo label is: ${JSON.stringify(data.label)}`);
    console.log(`getMissionInfo iconPath is: ${JSON.stringify(data.iconPath)}`);
    console.log(`getMissionInfo continuable is: ${JSON.stringify(data.continuable)}`);
    console.log(`getMissionInfo unclearable is: ${JSON.stringify(data.unclearable)}`);
    });
} catch (paramError) {
    console.error(`error: ${paramError.code}, ${paramError.message}`);
}