egret-docs-master/Lakeshore/manual/module/touch/README.md

2.7 KiB
Raw Permalink Blame History

添加触屏组件后,可以实现对移动端触摸操作的响应。一个场景内只能添加一个触屏组件。对触摸操作的响应通过对所添加的触屏实例的条件判断实现。 *注:触屏组件除“名称”外,不支持其他基本属性。不支持碰撞。触屏组件添加后并不会在游戏运行场景中产生可见实例。

特有属性

触屏组件无特有属性。


触屏条件

触屏组件除特有条件外,不支持任何通用条件。

当触摸进行时

当屏幕处于触摸状态时。【持续性触发】 手指一直按着屏幕,将持续性触发此条件,即当手指一直按着屏幕时,此条件为真,否则为假。 此条件无属性设置窗口。

轻触屏幕时

当轻触屏幕时。【一次性触发】 此条件的触发是从手指开始点击屏幕到手指离开屏幕之后进行,这一过程需要具备以下几个条件才能触发:

  1. 在手指点击屏幕的一瞬间所记录的位置与手指离开屏幕的一瞬间所记录的位置相同或者相差一个极小的距离。
  2. 手指离开屏幕一瞬间与手指按下屏幕一瞬间时间差很短。一般为200ms左右
  3. 且此过程还未发生触摸移动事件。(即手指未在屏幕上移动)

此条件无属性设置窗口。

触摸开始时

当触摸开始时。【一次性触发】 当手指点击屏幕的那一刻,条件为真,触发一次。与“轻触屏幕时”不同的是,它不需要手指离开屏幕这一动作即可触发。 此条件无属性设置窗口。

触摸结束时

当触摸结束时。【一次性触发】 当触摸结束,手指离开屏幕的那一刻,条件为真,触发一次。 此条件无属性设置窗口。

触摸移动时

当触摸并移动时。【一次性触发】 手指触摸屏幕,并在屏幕上划动时,每划动一下便触发一次。所以虽然条件为一次性触发条件,但如果持续在屏幕划动,便持续触发。

屏幕外结束触摸时

当触摸划动到屏幕外时。【一次性触发】 当触摸划动到屏幕外,触摸结束的那一刻,条件为真,触发一次。


触屏动作

触屏组件不支持任何动作。


表达式

触屏组件提供特有的表达式。

  • touchX:表示手指在屏幕上触摸时的水平坐标
  • touchY:表示手指在屏幕上触摸时的垂直坐标
  • touchPointID:表示手指在屏幕上触摸时分配给触摸点的唯一标识号。

例如假设触屏组件的名称为touchMc,那么如果我们要想获取手指在屏幕上的水平坐标可以这样表示touchMc.touchX。