Mapbox Android学习笔记（10）手势检测

本文主要是介绍Mapbox Android学习笔记（10）手势检测，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Gestures

Android的 Mapbox Maps SDK 中使用了用于Android库的Mapbox手势，用于基于用户输入的手势检测。这个库封装了 GestureDetectorCompat 和 ScaleGestureDetector ，并介绍了旋转、移动、推送和点击手势检测器的实现。

这个库是在Android的Mapbox Maps SDK和库的测试应用程序中实现的。

安装

1. 打开整个工程的 build.gradle 文件，确保 minSdkVersion 大于等于 14。
2. 在dependencies下，为最新的mapbox- gestux -android版本添加一个新的构建规则：implementation 'com.mapbox.mapboxsdk:mapbox-android-gestures:0.4.2'
3. 同步工程Sync Project with Gradle Files

注意:ProGuard指令包含在Android依赖项中，以保存所需的类。
库的版本发布到Maven Central。如果您想测试主分支构建，请使用Sonatype上可用的快照。

// In the root build.gradle file
repositories {mavenCentral()maven { url "http://oss.sonatype.org/content/repositories/snapshots/" }
}

// In the app build.gradle file
dependencies {implementation 'com.mapbox.mapboxsdk:mapbox-android-gestures:0.5.0-SNAPSHOT'
}

独立使用

您必须实例化 AndroidGestureManager 来启动任何手势处理。

设置您感兴趣的任何手势侦听器，并将所有 MotionEvent 对象从活动/片段传递给 AndroidGestureManager#onTouchEvent() 。

互斥的手势

由于 AndroidGestureManager 类充当所有手势检测器的单一入口点，因此可以实现互斥手势。

这意味着您可以传递一个手势类型（GestureType）集列表。当检测到一个手势时，它将检查是否有任何已启动的渐进手势（ProgressiveGesture）包含在同一个集合中。如果没有，则不会通知我们检测到的手势的侦听器。

您可以在 AndroidGestureManager 的构造函数中传递互斥的手势集，或者使用 AndroidGestureManager# setmutuallyexclusive gesture() 传递。

Set<Integer> mutuallyExclusive1 = new HashSet<>();
mutuallyExclusive1.add(AndroidGesturesManager.GESTURE_TYPE_SHOVE);
mutuallyExclusive1.add(AndroidGesturesManager.GESTURE_TYPE_SCROLL);Set<Integer> mutuallyExclusive2 = new HashSet<>();
mutuallyExclusive2.add(AndroidGesturesManager.GESTURE_TYPE_SHOVE);
mutuallyExclusive2.add(AndroidGesturesManager.GESTURE_TYPE_SCALE);AndroidGesturesManager androidGesturesManager = new AndroidGesturesManager(context,mutuallyExclusive1,mutuallyExclusive2
);

第一个设置确保当检测到一个push手势时，不会再通知您关于滚动手势的信息。可以执行push手势，因为滚动不是一个渐进的手势。在第二组中，当检测到一个push或scale时，直到第一个手势完成，才会通知您另一个手势。

阈值

您可以为支持的手势设置阈值，这意味着手势检测器在达到阈值之前不会触发(比如最小旋转角度)。这允许您以自己喜欢的方式个性化手势体验。

使用dimen值而不是原始像素设置阈值，以适应不同屏幕大小和像素密度的Android设备。例如：

androidGesturesManager.getStandardScaleGestureDetector().setSpanSinceStartThresholdResource(R.dimen.scaleSpanSinceStartThreshold);

对于不以像素表示的阈值：

androidGesturesManager.getRotateGestureDetector().setAngleThreshold(ROTATE_ANGLE_THRESHOLD);

Velocity 速率

每个具有各自 #onEnd() 回调函数的渐进手势将在指针离开屏幕时提供手势的 X 速度和 Y 速度。

启用/禁用中断

可以使用 #setEnabled() 方法在任何时候启用/禁用每个手势检测器。

此外，每一个渐进的手势都可以被打断，这将迫使它再次满足开始条件恢复。一个流行的用例是，当检测到另一个手势时，增加手势的阈值：

@Override
public boolean onScaleBegin(StandardScaleGestureDetector detector) {// 缩放时禁止移动androidGesturesManager.getMoveGestureDetector().setEnabled(false); // 这也会中断一个手势// 当检测到缩放时，增加旋转角度阈值，然后中断以强制重新检查RotateGestureDetector rotateGestureDetector = androidGesturesManager.getRotateGestureDetector();rotateGestureDetector.setAngleThreshold(ROTATION_THRESHOLD_WHEN_SCALING);rotateGestureDetector.interrupt();return true;
}@Override
public boolean onScale(StandardScaleGestureDetector detector) {float scaleFactor = detector.getScaleFactor();return true;
}@Override
public void onScaleEnd(StandardScaleGestureDetector detector) {//  恢复阈值RotateGestureDetector rotateGestureDetector = androidGesturesManager.getRotateGestureDetector();rotateGestureDetector.setAngleThreshold(Constants.DEFAULT_ROTATE_ANGLE_THRESHOLD);
}

探测器

有了这个库，您将能够使用支持库等提供的检测器识别手势。

StandardGestureDetector
封装通过支持库公开的 GestureDetectorCompat，它可以识别诸如点击、双击或滚动等手势。

StandardScaleGestureDetector
包装 ScaleGestureDetector 公开通过支持库，识别缩放/缩放手势。

MultiFingerTapGestureDetector
手势检测器，它告诉监听器何时发生多指轻击以及涉及多少手指。

RotateGestureDetector
一种检测器，它用两个指针(手指)找出以前的线和现在的线之间的角度差。

ShoveGestureDetector
检测两个指针在一定水平角度内的垂直移动。

MoveGestureDetector
其行为类似于 StandardGestureDetector 中包含的 #onScroll() ，但是，它是一个渐进的手势，支持更好的过滤选项和阈值。

SidewaysShoveGesturesDetector
类似于 ShoveGestureDetector 。不过，它能识别水平方向(而不是垂直方向)执行的两个手指推的手势。

配合 Maps SDK 使用

这个库是作为Android的Mapbox Maps SDK的一部分提供的，您不需要声明任何其他依赖项。

要获取包含对所有手势检测器的引用的 AndroidGesturesManager 对象，请使用：

AndroidGesturesManager gesturesManager = mapboxMap.getGesturesManager();

为了响应用户的输入，您可以注册几个不同的侦听器，当用户与Mapbox map交互时，这些侦听器将被通知。

OnMapClickListener

mapboxMap.addOnMapClickListener(new MapboxMap.OnMapClickListener() {@Overridepublic void onMapClick(@NonNull LatLng point) {// user clicked on the map}
});

OnMoveListener

mapboxMap.addOnMoveListener(new MapboxMap.OnMoveListener() {@Overridepublic void onMoveBegin(MoveGestureDetector detector) {// user started moving the map}@Overridepublic void onMove(MoveGestureDetector detector) {// user is moving the map}@Overridepublic void onMoveEnd(MoveGestureDetector detector) {// user stopped moving the map}
});

您可以看到在上面的回调中传递了一个 MoveGestureDetector 对象。该类是Android库Mapbox手势的底层检测器。

还有一些其他流行的侦听器接口可以实现，如下：

• OnMapLongClickListener：当地图被触摸时，一根手指按在地图上就会触发。
• OnRotateListener：当地图旋转时触发。
• OnScaleListener：当地图缩放时触发。
• OnShoveListener：当地图倾斜时触发。

自定义 AndroidGesturesManager

Maps SDK提供了一个 MapboxMap#setGesturesManager() 方法。如果您创建一个自定义 AndroidGesturesManager 对象，您可以将它用作该方法的参数，以及您想要创建的自定义地图体验的参数。

这篇关于Mapbox Android学习笔记（10）手势检测的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

---