object.permanentId

类型 字符串
对象 InputDevice
修订 版本 2024.3703
关键词 设备,输入,permanentId

概述

提供输入设备的唯一字符串 ID,该 ID 在重新启动后保持一致。也就是说,输入设备的 ID 在系统重新启动后不会更改。这意味着可以将此 ID 保存到文件,并使用非常特定的输入设备设置键绑定。

此 ID 在所有物理输入设备中都是唯一的。这包括相同型号和制造商的设备。但是,请注意,如果同一物理输入设备具有多种输入类型,Corona 有时会为其提供多个 InputDevice 对象。例如,游戏控制器有一个触摸板,Corona 会将其报告为两个 InputDevice 对象,一个操纵杆和一个鼠标,它们都具有相同的永久 ID。

如果设备没有分配永久字符串 ID,则返回 nil(空)。

示例

-- Called when a key event has been received.
local function onKeyEvent( event )
    if event.device then
        print( "Device's Permanent String ID: " .. tostring( event.device.permanentId ) )
    end
end

-- Set up the above function to receive key events.
Runtime:addEventListener( "key", onKeyEvent )