harmony 鸿蒙系统预置全局快捷键开发指导

2025-06-12
浏览 (3)

系统预置全局快捷键开发指导

场景介绍

系统预置全局快捷键提供设置快捷键拉起Ability延迟时间的能力。使用场景例如：按下快捷键五秒后截屏。

导入模块

import { shortKey } from '@kit.InputKit';

接口说明

事件注入常用接口如下表所示，接口详细介绍请参考ohos.multimodalInput.shortKey文档。

接口名称	描述
setKeyDownDuration(businessKey: string, delay: number, callback: AsyncCallback<void>): void	设置快捷键拉起Ability的延迟时间。

开发步骤

开发步骤以按下快捷键五秒后截屏为例。

import { shortKey } from '@kit.InputKit';
try {
  shortKey.setKeyDownDuration("screenshot", 500, (error) => {//设置截屏应用screenshot延迟时间为5秒（500毫秒）
    if (error) {
      console.log(`Set key down duration failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Set key down duration success`);
  });
} catch (error) {
  console.log(`Set key down duration failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}