com.auxiliary.appium.event

Class TouchEvent

java.lang.Object

com.auxiliary.selenium.event.AbstractEvent

com.auxiliary.appium.event.TouchEvent

public class TouchEvent
extends AbstractEvent

文件名：TouchEvent.java

用途：提供app自动化测试中触摸相关的事件操作。

编码时间：2021年4月16日 下午4:28:56

修改时间：2021年4月16日 下午4:28:56

Since:

JDK 1.8

Version:

Ver1.0

Author:

彭宇琦

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TouchEvent.DirectionType 文件名：TouchEvent.java

Field Summary

Fields

Modifier and Type	Field and Description
protected io.appium.java_client.AppiumDriver<?>	appDriver 存储转换后的app驱动类对象
protected int	bottomYNum 存储底部y轴坐标
protected org.openqa.selenium.Point	centrePoint 存储中心点坐标
protected io.appium.java_client.TouchAction<?>	defaultTouch 默认的手指滑动事件
protected int	hight 存储设备的高度
protected int	leftXNum 存储左边x轴坐标
protected long	operateTime 存储完成滑动事件的时间，默认1秒
protected int	rigthXNum 存储右边x轴坐标
protected int	SPACE_BETWEEN 指定坐标的间距
protected int	topYNum 存储顶部y轴坐标
protected int	width 存储设备宽度

Fields inherited from class com.auxiliary.selenium.event.AbstractEvent

brower, exceptionSet, isLocationElement, LOCATION_ELEMENT_JS, wait, waitTime, webElement

Constructor Summary

Constructors

Constructor and Description
TouchEvent(AbstractCellphoneBrower brower) 构造对象

Method Summary

Modifier and Type	Method and Description
void	closeNotification() 用于通过滑动的形式关闭手机的通知栏
void	directionGlide(TouchEvent.DirectionType directionType, int pixel) 用于从屏幕的中心点向一个指定的方向直线滑动指定的像素
void	downGlide() 模拟手指从页面的顶部滑动到自定义的坐标上
void	downGlide(int y) 模拟手指从页面的顶部滑动到自定义的y轴坐标上
void	downGlide(io.appium.java_client.touch.offset.PointOption<?> pointOption) 模拟手指从页面的顶部滑动到自定义的坐标上
void	enlargement() 用于通过屏幕中心点向左下和右上两个方向滑动，以模拟放大操作
void	glide(io.appium.java_client.touch.offset.PointOption<?>... points) 用于根据指定的多个坐标，模拟单手指进行滑动操作
void	glideToElement(Element startElement, Element endElement) 用于从一个元素的坐标点滑动到另一个元素坐标点上
void	openNotification() 用于通过滑动的形式打开手机的通知栏
void	reduce() 用于通过屏幕左下和右上两个方向中心点滑动，以模拟缩小操作
void	setOperateTime(long operateTime) 用于设置完成滑动操作的时间，单位为毫秒
void	threeDownGlide() 用于模拟三指下拉操作
void	upGlide() 模拟手指从页面的底部滑动到自定义的坐标上
void	upGlide(int y) 模拟手指从页面的底部滑动到自定义的y轴坐标上
void	upGlide(io.appium.java_client.touch.offset.PointOption<?> pointOption) 模拟手指从页面的底部滑动到自定义的坐标上

Methods inherited from class com.auxiliary.selenium.event.AbstractEvent

actionOperate, arrayToString, getBrower, getExceptionInfomation, isExistElement, locationElement, setLocationElement, setWaitTime

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SPACE_BETWEEN

protected final int SPACE_BETWEEN

指定坐标的间距

See Also:

Constant Field Values

appDriver

protected io.appium.java_client.AppiumDriver<?> appDriver

存储转换后的app驱动类对象

hight

protected int hight

存储设备的高度

width

protected int width

存储设备宽度

bottomYNum

protected int bottomYNum

存储底部y轴坐标

topYNum

protected int topYNum

存储顶部y轴坐标

leftXNum

protected int leftXNum

存储左边x轴坐标

rigthXNum

protected int rigthXNum

存储右边x轴坐标

centrePoint

protected org.openqa.selenium.Point centrePoint

存储中心点坐标

defaultTouch

protected io.appium.java_client.TouchAction<?> defaultTouch

默认的手指滑动事件

operateTime

protected long operateTime

存储完成滑动事件的时间，默认1秒

Constructor Detail

TouchEvent

public TouchEvent(AbstractCellphoneBrower brower)

构造对象

Parameters:

brower - 手机浏览器AbstractCellphoneBrower类对象

Method Detail

setOperateTime

public void setOperateTime(long operateTime)

用于设置完成滑动操作的时间，单位为毫秒

Parameters:

operateTime - 完成滑动操作的时间

upGlide

public void upGlide(io.appium.java_client.touch.offset.PointOption<?> pointOption)

模拟手指从页面的底部滑动到自定义的坐标上

由于手机可能包含虚拟按键，若以最低的坐标作为起始坐标，可能导致页面滑动无效，故此处的底部坐标特指整个屏幕自下而上1/10处位置作为起始坐标。

注意：

1. 当滑动停止坐标小于底部坐标时，则滑动无效
2. 当未指定结束坐标时，则y轴坐标按0计算
3. 底部起始坐标的x轴坐标为传入坐标的x轴坐标，当该值为0时，可能导致页面无法滑动

Parameters:

pointOption - 滑动停止坐标

upGlide

public void upGlide(int y)

模拟手指从页面的底部滑动到自定义的y轴坐标上

由于手机可能包含虚拟按键，若以最低的坐标作为起始坐标，可能导致页面滑动无效，故此处的底部坐标特指整个屏幕自下而上1/10处位置。x轴坐标取屏幕自右向左1/10处位置

注意：当滑动停止坐标小于底部坐标时，则滑动无效

Parameters:

y - 滑动停止坐标

upGlide

public void upGlide()

模拟手指从页面的底部滑动到自定义的坐标上

该方法为由屏幕底部1/10处位置作为起始y轴坐标，屏幕右侧1/10处位置作为x轴坐标，向上滑动至屏幕顶部1/10处位置坐标处位置

downGlide

public void downGlide(io.appium.java_client.touch.offset.PointOption<?> pointOption)

模拟手指从页面的顶部滑动到自定义的坐标上

该方法所取的顶部坐标点与底部坐标点的获取方法类似，取顶部1/10处作为起始点，向下滑动至目标点。可参考upGlide(PointOption)方法进行传参

Parameters:

pointOption - 滑动停止坐标

downGlide

public void downGlide(int y)

模拟手指从页面的顶部滑动到自定义的y轴坐标上

该方法所取的顶部坐标点与底部坐标点的获取方法类似，取顶部1/10处作为起始点，向下滑动至目标点。可参考upGlide(int)方法进行传参

Parameters:

y - 滑动停止坐标

downGlide

public void downGlide()

模拟手指从页面的顶部滑动到自定义的坐标上

该方法为由屏幕顶部1/10处位置作为起始y轴坐标，屏幕右侧1/10处位置作为x轴坐标，向下滑动至屏幕底部1/10处位置坐标处位置

glide

public void glide(io.appium.java_client.touch.offset.PointOption<?>... points)

用于根据指定的多个坐标，模拟单手指进行滑动操作

注意：若指定的坐标点小于2个时，则不进行操作

Parameters:

points - 滑动坐标组

directionGlide

public void directionGlide(TouchEvent.DirectionType directionType,
                           int pixel)

用于从屏幕的中心点向一个指定的方向直线滑动指定的像素

注意：当指定的方向为TouchEvent.DirectionType.CENTER时，则不做滑动操作

Parameters:

directionType - 滑动方向枚举

pixel - 滑动的像素值

glideToElement

public void glideToElement(Element startElement,
                           Element endElement)

用于从一个元素的坐标点滑动到另一个元素坐标点上

注意：

1. 该方法仅对原生元素有效，WebView元素获取到的坐标点可能与实际坐标有所偏差。
2. 若未指定开始元素，则以右顶部坐标为起始坐标；若未指定终止滑动元素，则以右底部坐标为终止坐标

Parameters:

startElement - 起始元素

endElement - 终止滑动元素

enlargement

public void enlargement()

用于通过屏幕中心点向左下和右上两个方向滑动，以模拟放大操作

reduce

public void reduce()

用于通过屏幕左下和右上两个方向中心点滑动，以模拟缩小操作

threeDownGlide

public void threeDownGlide()

用于模拟三指下拉操作

openNotification

public void openNotification()

用于通过滑动的形式打开手机的通知栏

closeNotification

public void closeNotification()

用于通过滑动的形式关闭手机的通知栏