harmony 鸿蒙@ohos.multimodalInput.shortKey(快捷键)

  • 2023-06-24
  • 浏览 (624)

@ohos.multimodalInput.shortKey(快捷键)

通过本模块接口,可以设置快捷键拉起Ability的延迟时间,如设置长按快捷键3s后再截屏等。

说明:

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

  • 本模块接口为系统接口。

导入模块

import shortKey from '@ohos.multimodalInput.shortKey';

shortKey.setKeyDownDuration

setKeyDownDuration(businessKey: string, delay: number, callback: AsyncCallback<void>): void

设置快捷键拉起Ability的延迟时间,使用Callback异步回调。

系统能力:SystemCapability.MultimodalInput.Input.ShortKey

参数

参数名 类型 必填 说明
businessKey string 业务在多模侧注册的唯一标识,与ability_launch_config.json中的businessId对应。
delay number 按下快捷键多长时间后拉起Ability,单位是毫秒(ms),仅支持快捷键按下触发。
callback AsyncCallback<void> 回调函数,设置成功时,err为undefined,否则为错误对象。

示例

import shortKey from '@ohos.multimodalInput.shortKey';
try {
  shortKey.setKeyDownDuration("screenshot", 500, (error) => {
    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`])}`);
}

shortKey.setKeyDownDuration

setKeyDownDuration(businessKey: string, delay: number): Promise<void>

设置快捷键拉起Ability的延迟时间,使用Promise异步回调。

系统能力:SystemCapability.MultimodalInput.Input.ShortKey

参数

参数名 类型 必填 说明
businessKey string 业务在多模侧注册的唯一标识,与ability_launch_config.json中的businessId对应。
delay number 按下快捷键多长时间后拉起Ability,单位是毫秒(ms),仅支持快捷键按下触发。

返回值

参数 说明
Promise<void> 无返回结果的Promise对象。

示例

import shortKey from '@ohos.multimodalInput.shortKey';
try {
  shortKey.setKeyDownDuration("screenshot", 500).then(() => {
    console.log(`Set key down duration success`);
  });
} catch (error) {
  console.log(`Set key down duration failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述(仅对系统应用开放)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞