【HarmonyOS Next】鸿蒙监听手机按键

【HarmonyOS Next】鸿蒙监听手机按键

一、前言

应用开发中我们会遇到监听用户实体按键,或者扩展按键的需求。亦或者是在某些场景下,禁止用户按下某些按键的业务需求。

这两种需求,鸿蒙都提供了对应的监听事件进行处理。

onKeyEvent 默认的按钮监听事件

onKeyPreIme 这是优先级最高的监听回调,别上面多了一个return开关,用于告诉系统监听事件是否再向下传递。

窗口是第一级接收按钮事件的实体。后续会传递给后三级。

二、解决方案参考

我们以音量实体按键举例,

通过绑定onKeyEvent按键监听来获取按键事件的回调。需要注意的是,绑定了按键事件需要控件获得焦点时,用户去操作按键才会有监听回调。

dart 复制代码
		// 给控件添加默认聚焦
      .defaultFocus(true)
          // 给Button设置onKeyEvent事件
        .onKeyEvent((event?: KeyEvent) => {
        })

使用onKeyPreIme屏蔽音量使用下键。

dart 复制代码
import { KeyCode } from '@kit.InputKit';

@Entry
@Component
struct PreImeEventExample {
  build() {
    Column() {
      Search({
        placeholder: "Search..."
      })
        .width("80%")
        .height("40vp")
        .border({ radius:"20vp" })
        .onKeyPreIme((event:KeyEvent) => {
          // 屏蔽音量使用下键
          if (event.keyCode == KeyCode.KEYCODE_VOLUME_DOWN) {
            return true;
          }
          return false;
        })
    }
  }
}

三、DEMO源码示例:

dart 复制代码
import { KeyCode } from '@kit.InputKit'

@Entry
@Component
struct KeyClickTestPage {
  @State text: string = ''
  @State eventType: string = ''

  build() {
    Column() {
      Button('KeyEvent')
        .defaultFocus(true)
          // 给Button设置onKeyEvent事件
        .onKeyEvent((event?: KeyEvent) => {
          if(event){
            if (event.type === KeyType.Down) {
              this.eventType = 'Down' // 按钮 按下
            }
            if (event.type === KeyType.Up) {
              this.eventType = 'Up'// 按钮 抬起
            }
            // KEYCODE_VOLUME_UP	16	音量增加键
            // KEYCODE_VOLUME_DOWN	17	音量减小键
            // KEYCODE_POWER	18	电源键
            this.text = 'onKeyEvent KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText + '\nintentionCode:' + event.intentionCode
          }
        })
        .onKeyPreIme((event:KeyEvent) => {
          // 屏蔽音量使用下键
          if (event.keyCode == KeyCode.KEYCODE_VOLUME_DOWN) {
            return true;
          }
          this.text = 'onKeyPreIme KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText + '\nintentionCode:' + event.intentionCode

          return false;
        })
      Text(this.text).padding(15)
    }.height(300).width('100%').padding(35)
  }
}

扩展资料

点击跳转参考按键Code列表:

相关推荐
晚风(●•σ )1 小时前
【华为 ICT & HCIA & eNSP 习题汇总】——题目集24
计算机网络·华为·ensp
云雾J视界1 小时前
数字化转型的核心引擎:解读华为“业务重构”三层设计模型
华为·业务重构·数字化设计·y模型·三层数字化·流程化组织·t型结构
江湖有缘1 小时前
基于华为openEuler部署webmin服务器管理工具
运维·服务器·华为
无风听海4 小时前
HarmonyOS之 @Provide 装饰器实现跨组件双向状态同步
华为·harmonyos
安卓开发者4 小时前
鸿蒙NEXT传统蓝牙开发指南:从基础到实战的完整解决方案
harmonyos
代码79725 小时前
使用会话存储时,处理存储信息加密问题
深度学习·算法·自动化·散列表·harmonyos
Coovally AI模型快速验证5 小时前
华为发布开源超节点架构,以开放战略叩响AI算力生态变局
人工智能·深度学习·神经网络·计算机视觉·华为·架构·开源
江湖有缘5 小时前
基于华为openEuler部署Blog轻量级博客系统
华为
爱笑的眼睛117 小时前
深入解析 List 容器组件:构建高效、可交互的列表解决方案
华为·harmonyos
威哥爱编程7 小时前
HarmonyOS NEXT 5.0 的星闪(NearLink)开发应用案例
harmonyos