7e27e73e创建于 2025年7月22日历史提交

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

场景介绍

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

导入模块

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

接口说明

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

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

开发步骤

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

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

@Entry
@Component
struct Index {
  build() {
    RelativeContainer() {
      Text()
        .onClick(() => {
          try {
            shortKey.setKeyDownDuration("screenshot", 500, (error) => {//设置截屏应用screenshot延迟时间为5秒(500毫秒)
              if (error) {
                console.error(`Set key down duration failed, error: ${JSON.stringify(error, ["code", "message"])}`);
                return;
              }
              console.info(`Set key down duration success`);
            });
          } catch (error) {
            console.error(`Set key down duration failed, error: ${JSON.stringify(error, ["code", "message"])}`);
          }
        })
    }
  }
}