設(shè)置任務(wù)快照的圖標(biāo)和名稱

設(shè)置任務(wù)快照的圖標(biāo)和名稱是為了提高用戶界面的可視化性和用戶體驗(yàn)，以便更好地管理和跟蹤應(yīng)用程序中的任務(wù)和功能。通過為每個(gè)任務(wù)快照設(shè)置不同的圖標(biāo)和名稱，可以更輕松地區(qū)分和識(shí)別每個(gè)任務(wù)的功能。

默認(rèn)情況下任務(wù)快照的圖標(biāo)和名稱采用的是[module.json5配置文件]的[abilities標(biāo)簽]中的icon和label字段，如下圖所示。

圖1 UIAbility對(duì)應(yīng)的任務(wù)快照

也可以使用[UIAbilityContext.setMissionIcon()]和[UIAbilityContext.setMissionLabel()]方法，根據(jù)需要自定義任務(wù)快照的圖標(biāo)和名稱。例如，對(duì)于UIAbility的多實(shí)例啟動(dòng)模式，可以根據(jù)不同的功能配置相應(yīng)的任務(wù)快照的圖標(biāo)和名稱。

本文將從以下兩個(gè)方面介紹。

• [設(shè)置任務(wù)快照的圖標(biāo)（僅對(duì)系統(tǒng)應(yīng)用開放）]
• [設(shè)置任務(wù)快照的名稱]
• 開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

設(shè)置任務(wù)快照的圖標(biāo)（僅對(duì)系統(tǒng)應(yīng)用開放）

通過調(diào)用[UIAbilityContext.setMissionIcon()]方法修改任務(wù)快照的圖標(biāo)。

示例中的context的獲取方式請(qǐng)參見[獲取UIAbility的上下文信息]。示例中的pixelMap的獲取方式請(qǐng)參見[圖片解碼]。

import type common from '@ohos.app.ability.common';
import type { BusinessError } from '@ohos.base';
import hilog from '@ohos.hilog';

const TAG: string = 'EntryAbility';
const DOMAIN_NUMBER: number = 0xFF00;

...
let context: common.UIAbilityContext = this.context; // UIAbilityContext

... // 獲取pixelMap

// 設(shè)置任務(wù)快照的圖標(biāo)
context.setMissionIcon(pixelMap, (err: BusinessError) = > {
  if (err.code) {
    hilog.error(DOMAIN_NUMBER, TAG, `Failed to set mission icon. Code is ${err.code}, message is ${err.message}`);
  } else {
    hilog.info(DOMAIN_NUMBER, TAG, `Success to set mission icon.`);
  }
})

效果示意如下圖所示。

圖2 設(shè)置任務(wù)快照的圖標(biāo)

設(shè)置任務(wù)快照的名稱

通過調(diào)用[UIAbilityContext.setMissionLabel()]方法修改任務(wù)快照的名稱。

import type common from '@ohos.app.ability.common';
import type { BusinessError } from '@ohos.base';
import hilog from '@ohos.hilog';

const TAG: string = 'EntryAbility';
const DOMAIN_NUMBER: number = 0xFF00;

...
let context: common.UIAbilityContext = this.context; // UIAbilityContext
// 設(shè)置任務(wù)快照的名稱
context.setMissionLabel('test').then(() = > {
  hilog.info(DOMAIN_NUMBER, TAG, 'Succeeded in seting mission label.');
}).catch((err: BusinessError) = > {
  hilog.error(DOMAIN_NUMBER, TAG, `Failed to set mission label. Code is ${err.code}, message is ${err.message}`);
});

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

效果示意如下圖所示。

圖3 設(shè)置任務(wù)快照的名稱

審核編輯 黃宇