event.descriptor

概览

提供一个由 Corona 分配的可读字符串，用于唯一标识设备上的一个按键。此描述符字符串旨在供应用程序使用，以设置与特定设备（例如连接到系统的第一个游戏杆）的按键和轴绑定。

此描述符字符串键是根据设备的 描述符 和按下或释放的按键的 名称 生成的。例如，一个游戏杆的前两个按钮可能被命名为 `Joystick 1: buttonA` 和 `Joystick 1: buttonB`。

陷阱

如果按键事件是由软件生成的（例如屏幕上显示的 Android 底部导航栏），则描述符名称将不包含设备名称。这在返回键事件中很常见 — 在这种情况下，此描述符仅提供按键的 名称。例如，如果您按下 Android 设备触摸屏上的返回键，则描述符名称将为 `back`。

示例

-- Called when a key event has been received
local function onKeyEvent( event )
    -- Print the key's unique descriptor
    print( event.descriptor )

    -- Return false to indicate that this app is NOT overriding the received key;
    -- This lets the operating system execute its default handling of this key
    return false
end

-- Add the key event listener
Runtime:addEventListener( "key", onKeyEvent )