CoronaSDK之交互系统和事件检测

事件（Event）是Corona应用程序的基础。他们用来触发不同事件对应的响应，例如触摸屏幕、检测一个特定的系统事件、定时器的完成、两个物理体的碰撞，等等。通常我们使用display object的对象方法addEventListener来添加处理函数，以关联需要监听的事件。

1 Runtime事件（似乎也可以叫做全局事件）

Runtime事件被分配给全局的Runtime监听器。这些事件并不直接和任何具体的对象相关；当然他们广播给所有感兴趣的监听器。Runtime event包括下列这些：

• enterFrame：发生在每秒帧数间隔之间的事件（corona渲染一般每秒30或60帧）
• system：某种由系统状况引发的事件，例如设备挂起应用或退出应用
• orientation：当改变设备的方向，横向到竖向或者反之，而发生的事件

下面的代码展示了一个应用如何响应system事件：

local function onSystemEvent( event )

    local eventType = event.type

    if ( eventType == "applicationStart" ) then
        --occurs when the application is launched and all code in "main.lua" is executed
    elseif ( eventType == "applicationExit" ) then
        --occurs when the user or OS task manager quits the application
    elseif ( eventType == "applicationSuspend" ) then
        --perform all necessary actions for when the device suspends the application, i.e. during a phone call
    elseif ( eventType == "applicationResume" ) then
        --perform all necessary actions for when the app resumes from a suspended state
    elseif ( eventType == "applicationOpen" ) then
        --occurs when the application is asked to open a URL resource (Android and iOS only)
    end
end

Runtime:addEventListener( "system", onSystemEvent )

2 本地事件（local event）

本地事件被发送给一个单独的Listener，而不是广播给全局的运行时环境。一般本地事件包括下列事件：

hit：当用户触摸设备屏幕时发生的事件

collision：物理对象碰撞时发生的事件

timer：在运行timer完成时发生的事件

audio：当一个音频播放完成时分发的事件

 

3 function listener 和 table listener

Listener可以是一个function，也可以是一个table。

当你一个function Listener被调用，它会接受一个table参数，作为event。

local myListener = function( event )
    print( "Listener called with event of type: "..event.name )
end

Runtime:addEventListener( "touch", myListener )
Runtime:addEventListener( "enterFrame", myListener )

有时一个function Listener并不方便，因为当Listener被调用时一些变量并不在作用域里。在这种情况里，table Listener应该被使用。table Listener必须有一个有对应事件名的实例方法：

--assume myClass and myClass:new() already exist

function myClass:enterFrame( event )
    print( "enterFrame called at time: "..event.time )
end

function myClass:touch( event )
    print( "touch occurred at: "..event.x..","..event.y )
end

local myObject = myClass:new() 

Runtime:addEventListener( "touch", myObject )
Runtime:addEventListener( "enterFrame", myObject )

注意：

这里是对象方法，用的是“:”，而不是“.”。所以实际上函数内部是可以访问self引用的。这里的self就是myObject的引用。

4 理解hit事件

当用户触摸屏幕时，一个hit事件会生成并分发给显示层次中的显示对象（display object）。只有那些在屏幕上位置和触摸点位置发生交集的对象会收到事件。hit事件会以一个特定的顺序穿过这些对象。默认情况下，第一个收到事件的对象是发生交集的对象中最上层的显示对象，往下一个发生交集的显示对象会第二个收到事件，如此类推。

hit事件会一直传递下去，除非它被处理掉。这意味着如果你有多个层叠在一起的对象，并且一个hit事件监听器被应用到所有这些对象，hit事件将会穿过着所有的对象。然而，你可以停止传递给下一个低层对象，这就需要你告诉corona这个event已经被处理了。简单的方法就是在事件处理函数直接返回一个true--这将会停止传递周期，并且阻止任何底下对象响应这个hit事件。

local function myTouchListener( event )

    if ( event.phase == "began" ) then
        --code executed when the button is touched
        print( "object touched = "..tostring(event.target) )  --'event.target' is the touched object
    end
    return true  --prevents touch propagation to underlying objects
end

local myButton = display.newRect( 100, 100, 200, 50 )
myButton:addEventListener( "touch", myTouchListener )

注意：如果hit事件遍历了整个显示层次中所有的显示对象，仍然没有被处理，它将会像全局事件一样广播给Runtime Listener。换言之，runtime listener还有机会对未命中任何对象的触摸事件做出反应。

4.1 设置焦点

你可以直接发送任何hit事件给一个指定的display object，来为这个对象设置焦点。比如一个典型的button，如果用户触摸这个按钮--还没有抬起手-又滑出了按钮，这个按钮一般不应该激发一个行为。同理，如果手指滑出按钮并接触到另一个交互对象，你可能不想激活那个对象，因为触摸是从按钮开始的，而不是交互对象。

解决这个问题的简单方法就如下，进入按钮时设置焦点，结束和取消时再取消焦点。这样滑出到其他对象时，其他对象都收不到事件：

local function myTouchListener( event )

    if ( event.phase == "began" ) then
        display.getCurrentStage():setFocus( event.target )  --'event.target' is the touched object

    elseif ( event.phase == "ended" or event.phase == "cancelled" ) then
        display.getCurrentStage():setFocus( nil )  --setting focus to 'nil' removes the focus

    end
    return true
end

local myButton = display.newRect( 100, 100, 200, 50 )
myButton:addEventListener( "touch", myTouchListener )

4.2 hit event具体分为

• Tap
• Touch
• Multitouch

5 event 参数

上面举出的每个例子，事件都会被分发给事件监听函数。一个event参数始终会被传递给监听函数。

local function myTouchListener( event )

    print( "Touch X location"..event.x )
    print( "Touch Y location"..event.y )
end

local myButton = display.newRect( 100, 100, 200, 50 )
myButton:addEventListener( "touch", myTouchListener )

注意：传递给myTouchListener函数的event参数中包含手指接触屏幕位置的x和y坐标。event参数关联的属性和event类型是一一关联的。什么事件 对应哪些属性。

6 注册EventListener

我们一般用对象方法addEventListener()来注册事件。只要传入事件名称字符串，以及对应处理这个事件的处理函数即可。

--standard touch listener on an object
myButton:addEventListener( "touch", myTouchListener )

--Runtime 'system' event listener
Runtime:addEventListener( "system", onSystemEvent )

重要提示：

如上所示，两种类型的事件监听器都可以通过addEventListener对象方法来创建：监听器附着到显示对象，或者监听器附着到全局Rumtime。

当你创建一个显示对象或添加一个本地的touch事件监听器 给它，你需要通过引用函数来指定一个代码块给事件。这些代码处于他们自己内存的代码段当中，并且当显示对象被删除后依然存在。不过当显示对象被删除后，就没办法检测到新的事件，因为本地事件监听器（注意：是监听器，不是代码）已经被有效的删除，并不需要你显式地删除监听器。

另一方面，Runtime事件监听器需要在你用完之后手动删除。此外，他们将继续运行，因为全局Runtime事件是全局的。不仅仅会导致内存泄漏，而且如果函数继续存在于Runtime中，并引用了不再存在的对象，程序也会崩溃。

7 删除Event Listener

大多数监听器（Listener），除了“enterFrame”之类的Runtime监听器，在显示对象被删除（obj:removeSelf或display.remove(obj)）时将会被自动删除。但是，你也可以不删除对象，而只手动删除事件监听器。

删除（摘除）一个事件监听器，需要依靠内建的removeEventListener对象方法。

这个函数调用方式和addEventListener差不多。比如，你想让一个按钮停止监听touch事件，就可以摘除其监听器，如下：

myButton:removeEventListener( "touch", myTouchListener )

删除关联的事件监听器，需要提供事件名和函数名，因为有可能一个对象连接了同一类对象的多个监听器。例如，你可以有两个或更多监听函数关联到myButton的touch事件。然而当调用removeEventListener()时，你需要指定你想要停止监听的事件的类型，以及之前关联到这个事件上的函数。