按键事件是指组件与键盘、遥控器等按键设备交互时触发的事件,适用于所有可获焦组件,例如Button。对于默认不可获焦的组件,如Text,Image等,可以将focusable属性设置为true后使用按键事件。按键事件触发的流程和具体时机参考按键事件数据流。
参考KeyCode枚举表可知,音量键增减的键码值分别为KEYCODE_VOLUME_UP以及KEYCODE_VOLUME_DOWN。获取需要监听的键码值后,使用onKeyEvent或onKeyPreIme触发回调事件。
监听音量键变化的完整代码参考如下:
@Entry @Component struct KeyEventExample { build() { Column() { // 监听音量键的增加或减小 Button('KeyEvent') .defaultFocus(true) .onKeyPreIme((event?: KeyEvent) => { if (event) { console.info('触发onKeyPreIme'); if (event.keyCode === 16) { console.info('UP'); } else if (event.keyCode === 17) { console.info('DOWN'); } return false; // 返回true事件被消费不会执行下面的onKeyEvent,false则会触发onKeyEvent } return false; }) .onKeyEvent((event) => { if (event) { console.info('触发onKeyEvent'); if (event.keyCode === 16) { console.info('UP'); } else if (event.keyCode === 17) { console.info('DOWN'); } } }); }.height(300).width('100%').padding(35); } }