TouchEvent

更新时间：2019-11-28

此类封装TouchEvent相关数据与操作，包含手势触摸屏幕的相关属性。

Public methods
TouchEvent	touch_id 获取gesture的类型属性
TouchEvent	x 获取touch的屏幕横坐标属性
TouchEvent	y 获取touch的屏幕纵坐标属性
TouchEvent	delta_x 获取touch的屏幕变化横坐标属性
TouchEvent	delta_y 获取touch的屏幕变化纵坐标属性
TouchEvent	time 获取touch的当前时间属性
TouchEvent	phase 获取touch的相位属性
TouchEvent	pressure touch在屏幕上的压力

TouchEvent Demo

TouchEvent TouchEventDemo ()

demo示例

sample:
function on_touch_update(touch)
	ARLOG("update with touch : id = "..touch.touch_id..", x = "..touch.x..", y = "..touch.y..", delta_x = "..touch.delta_x..", delta_y = "..touch.delta_y..", time = "..touch.time)
end

touch_id

API起始版本：190

unsigned int touch_id

获取touch的id属性，唯一标明当前的touch对象

sample:
function on_touch_update(touch)
	local id = touch.touch_id
end

x

API起始版本：190

float x

获取touch的屏幕横坐标属性，屏幕左上角为起点，单位：像素

sample:
function on_touch_update(touch)
    local x = touch.x
end

y

API起始版本：190

float y

获取touch的屏幕纵坐标属性，屏幕左上角为起点，单位：像素

sample:
function on_touch_update(touch)
	local y = touch.y
end

delta_x

API起始版本：190

float delta_x

获取touch的屏幕变化横坐标属性，屏幕左上角为起点，单位：像素

sample:
function on_touch_update(touch)
	local delta_x = touch.delta_x
end

delta_y

API起始版本：190

float delta_y

获取touch的屏幕变化纵坐标属性，屏幕左上角为起点，单位：像素

sample:
function on_touch_update(touch)
	local delta_y = touch.delta_y
end

time

API起始版本：190

long time

获取touch的当前时间属性，单位：ms

sample:
function on_touch_update(touch)
	local time = touch.time
end

phase

API起始版本：190

string phase

获取touch的相位属性，("touch_begin"-触摸开始、"touch_move"-触摸移动、"touch_end"-触摸结束、"touch_cancel"-触摸取消)

关于"touch_cancel"-触摸取消触发时机，apple描述：系统取消触摸追踪，例如当用户朝脸移动设备；android描述：目前触摸被抛弃，不会再收到任何输入，应该将此视为一次touch_end事件，但不应执行任何常规操作。

sample:
function on_touch_update(touch)
	local phase = touch.phase
end

pressure

API起始版本：190

float pressure

touch在屏幕上的压力，为归一化后的数值，返回值为1表示正常压力，0表示无压力。

IOS需要支持3D touch的设备可以获取该属性，Andorid需要根据机型确定。

sample:
function on_touch_update(touch)
	local pressure = touch.pressure
end

TouchController

物理