基础库 3.54.0 开始支持本方法，这是一个同步方法。

监听键盘按键按下事件，仅适用于 PC 平台

语法

tt.onKeyDown(handler)

参数说明

类型	默认值	必填	说明	最低支持版本
function		是	传入的事件回调函数	3.54.0

handler 是一个回调函数，接收 object 类型的参数，属性如下：

属性名	类型	说明	最低支持版本
key	string	点击键盘的按钮 key 值，参考 Web 规范 KeyEvent key 属性	3.54.0
code	string	点击键盘的按钮 code 值，参考 Web 规范 KeyEvent code 属性	3.54.0
timeStamp	number	事件触发的高精度时间戳	3.54.0

无

errorCode	errMsg	errorType	说明	最低支持版本
999999	invalid param	D	参数错误	3.54.0
999988	The feature is not available in current operating system	D	不支持该系统，只支持在 PC 端调用	3.54.0

请使用字节宿主APP扫码

tt.onKeyDown((e) => {
    tt.showToast({
        title: `KeyDown key: ${e.key}`,
    });
})