MissionInfo (系统接口)

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

说明:

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

导入模块

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

属性

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

系统能力:SystemCapability.Ability.AbilityRuntime.Mission

名称 类型 可读 可写 说明
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}`);
}