学习Android的第二十六天

目录

Android Gesture 手势

Android 中手势交互的执行顺序

GestureListener

SimpleOnGestureListener

范例

参考文档

Android Gesture 手势添加与识别

使用GestureLibraries

范例

参考文档


Android Gesture 手势

手势操作在现代移动应用中扮演了非常重要的角色,它不仅提高了用户体验,还增加了应用的互动性和直观性。在Android开发中,实现手势识别是一项基本而重要的技能。Android系统为开发者提供了强大的手势识别功能,让开发者可以轻松地在自己的应用中实现各种手势操作。

Android 中手势交互的执行顺序

1、触摸屏幕事件发生:当用户用手指触摸屏幕时,系统生成一个MotionEvent事件。

2、MotionEvent传递给OnTouchListener:如果你为某个View设置了OnTouchListener,那么这个View上的触摸事件首先会被OnTouchListener的onTouch()方法捕获。

view.setOnTouchListener(new View.OnTouchListener() {
    @Override
    public boolean onTouch(View v, MotionEvent event) {
        // 处理触摸事件
        return false;
    }
});

3、MotionEvent转发给GestureDetector:在OnTouchListener的onTouch()方法内,可以将MotionEvent对象传递给GestureDetector处理。

@Override
public boolean onTouch(View v, MotionEvent event) {
    return gestureDetector.onTouchEvent(event);
}

4、GestureDetector处理并回调OnGestureListener:GestureDetector内部根据MotionEvent事件的序列来识别具体的手势动作,并根据识别结果调用OnGestureListener接口中相应的方法。

GestureDetector gestureDetector = new GestureDetector(context, new GestureDetector.SimpleOnGestureListener() {
    @Override
    public boolean onDown(MotionEvent e) {
        // 当用户按下时触发
        return true;
    }

    @Override
    public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
        // 用户执行fling操作时触发
        return true;
    }

    // 其他手势回调如onScroll, onLongPress等
});

关键组件说明

  • MotionEvent:这个类封装了触摸屏幕时的动作事件(如触摸、移动、松开等),以及触摸点的坐标和其他信息。
  • GestureDetector:这个类用于识别一系列的手势动作。它可以处理由MotionEvent输入的手势,并根据这些手势调用OnGestureListener接口中的方法。
  • OnGestureListener:这是一个监听手势交互的接口,提供了多个抽象方法以响应不同的手势事件,如单击、滑动、长按等。开发者通过实现这些方法来定义特定手势的响应行为。

通过这种机制,Android应用可以灵活地响应和处理用户的手势操作,从而提供丰富的交互体验。需要注意的是,在OnTouchListener的onTouch()方法中返回true表示该触摸事件已被消费,不会再向后传递;返回false则表示事件未被消费,还可以继续传递给其他监听器或处理方法。

GestureListener

GestureListener是Android中处理手势操作的重要接口,它提供了一系列回调方法来响应用户的不同手势动作。这些手势包括但不限于按下、抛掷、长按、滚动、按住和抬起等。下面将详细解释每个回调方法及其用途:

1. onDown(MotionEvent e)

  • 说明:当用户的手指刚刚接触到触摸屏时触发。这是最基本的手势识别方法,几乎所有的手势识别都是从onDown()开始的。
  • 用途:可以用来初始化某些操作,比如高亮显示被触摸的元素。

2. onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY)

  • 说明:当用户在触摸屏上迅速移动手指并松开时触发。e1和e2分别是手指按下和抬起时的MotionEvent对象,velocityX和velocityY表示手指离开屏幕时的速度。
  • 用途:常用于实现翻页效果或者删除条目时的快速滑动。

3. onLongPress(MotionEvent e)

  • 说明:当用户的手指按在屏幕上持续一段时间,并且没有松开时触发。
  • 用途:用于显示上下文菜单、进入拖拽模式等操作。

4. onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY)

  • 说明:当用户的手指在屏幕上滑动时触发。e1是手指按下时的MotionEvent对象,e2是当前移动事件的MotionEvent对象,distanceX和distanceY表示从上一个事件到这个事件的滑动距离。
  • 用途:用于实现滚动列表、图片查看器中的图片滑动等。

5. onShowPress(MotionEvent e)

  • 说明:当用户的手指按在触摸屏上,且还未移动或松开时触发。它的时间范围在按下起效,在长按之前。
  • 用途:可以用来给用户一个视觉反馈,表明他们的按压已经被识别,但还未触发长按。

6. onSingleTapUp(MotionEvent e)

  • 说明:当用户的手指离开触摸屏的那一刹那触发。
  • 用途:用于处理轻触屏幕的点击操作,比如打开一个新的界面或触发按钮等。

SimpleOnGestureListener

如果我们只想要在应用中处理一种或少数几种手势,使用GestureDetector.SimpleOnGestureListener会是一个更加便捷和高效的选择。SimpleOnGestureListener是一个实现了GestureDetector.OnGestureListener和GestureDetector.OnDoubleTapListener接口的类,为所有的手势提供了空实现。这意味着我们可以只覆盖(重写)你感兴趣的那些手势方法,而不是所有的方法。

比如,如果你只对滑动手势(onScroll)感兴趣,你可以创建一个GestureDetector对象,并传入一个匿名内部类,该类继承自SimpleOnGestureListener,然后只重写onScroll方法。

范例

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:id="@+id/tv_gesture"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:text="请在此区域内尝试不同的手势"
        android:textSize="24sp"/>

</RelativeLayout>
package com.example.myapplication3;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;
import android.view.GestureDetector;
import android.view.MotionEvent;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    private GestureDetector gestureDetector;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        gestureDetector = new GestureDetector(this, new GestureDetector.SimpleOnGestureListener() {
            @Override
            public boolean onDown(MotionEvent e) {
                showToast("按下");
                return true;
            }

            @Override
            public void onLongPress(MotionEvent e) {
                showToast("长按");
            }

            @Override
            public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
                showToast("抛掷");
                return true;
            }

            @Override
            public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
                showToast("滚动");
                return true;
            }

            @Override
            public void onShowPress(MotionEvent e) {
                showToast("按住");
            }

            @Override
            public boolean onSingleTapUp(MotionEvent e) {
                showToast("单击抬起");
                return true;
            }
        });
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        gestureDetector.onTouchEvent(event);
        return super.onTouchEvent(event);
    }

    private void showToast(String message) {
        Toast.makeText(this, message, Toast.LENGTH_SHORT).show();
    }
}

参考文档

  1. Android GestureDetector

Android Gesture 手势添加与识别

在Android应用开发中,GestureLibrary和GestureOverlayView是实现高级手势识别和处理的重要工具。通过使用这些工具,开发者可以创建、存储、识别自定义手势,并在应用中实现丰富的交互体验。

使用GestureLibraries

加载手势库:

首先,需要从某个位置加载一个手势库。Android提供了几种加载手势库的方法:

  • fromFile(String path) 或 fromFile(File path):从文件系统中的指定路径加载手势库。
  • fromPrivateFile(Context context, String name):从应用的私有文件目录加载手势库。
  • fromRawResource(Context context, int resourceId):从应用的资源文件中加载手势库。

示例

GestureLibrary gestureLib = GestureLibraries.fromRawResource(context, R.raw.gestures);
if (!gestureLib.load()) {
    // 手势库加载失败处理
}

使用手势库:

加载手势库后,可以使用GestureLibrary对象提供的方法来管理和识别手势。

  • 添加手势:addGesture(String entryName, Gesture gesture)
  • 获取所有手势名称:getGestureEntries()
  • 根据名称获取手势:getGestures(String entryName)
  • 识别手势:recognize(Gesture gesture)
  • 删除手势或手势集:removeEntry(String entryName) 和 removeGesture(String entryName, Gesture gesture)
  • 保存手势库:save()

使用GestureOverlayView

GestureOverlayView是一个透明的覆盖层,允许用户在其上绘制手势。它提供了三种监听器接口来响应手势事件:

  • OnGestureListener:在手势绘制过程中提供回调。
  • OnGesturePerformedListener:当用户完成手势绘制时触发。
  • OnGesturingListener:提供关于手势开始和结束的回调。

最常用的是OnGesturePerformedListener,它用于在用户完成手势绘制时进行响应。

范例

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="请在下方屏幕中绘制手势~"
        android:textSize="20sp"/>

    <!-- gestureStrokeType 控制手势是否需要一笔完成,multiple 表示允许多笔 -->
    <android.gesture.GestureOverlayView
        android:id="@+id/gesture"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gestureStrokeType="multiple" />

</LinearLayout>
<?xml version="1.0" encoding="utf-8"?>
<!--    dialog_save.xml-->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">
        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginRight="8dp"
            android:text="输入手势名称"/>
        <EditText
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:id="@+id/gesture_name"/>
    </LinearLayout>

    <ImageView
        android:id="@+id/gesture_show"
        android:layout_width="128dp"
        android:layout_height="128dp"
        android:layout_marginTop="10dp"/>

</LinearLayout>
package com.example.myapplication3;

import android.gesture.Gesture;
import android.gesture.GestureLibrary;
import android.gesture.GestureOverlayView;
import android.gesture.GestureLibraries;
import android.graphics.Bitmap;
import android.graphics.Color;
import android.os.Bundle;
import android.os.Environment;
import android.view.View;
import android.widget.EditText;
import android.widget.ImageView;
import android.widget.Toast;

import androidx.appcompat.app.AlertDialog;
import androidx.appcompat.app.AppCompatActivity;
import java.io.File;

public class MainActivity extends AppCompatActivity {

    private GestureOverlayView gestureOverlayView;
    private GestureLibrary gestureLibrary;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        gestureOverlayView = findViewById(R.id.gesture);
        gestureOverlayView.setGestureColor(Color.GREEN);
        gestureOverlayView.setGestureStrokeWidth(5);
        gestureOverlayView.addOnGesturePerformedListener(this::onGesturePerformed);

        // 初始化手势库
        String path = Environment.getExternalStorageDirectory().getAbsolutePath() + "/myGestures";
        File file = new File(path);
        if (!file.exists()) {
            file.mkdirs();
        }
        gestureLibrary = GestureLibraries.fromFile(file);
    }

    private void onGesturePerformed(GestureOverlayView overlay, final Gesture gesture) {
        View saveDialog = getLayoutInflater().inflate(R.layout.dialog_save, null, false);
        ImageView imgShow = saveDialog.findViewById(R.id.gesture_show);
        final EditText editName = saveDialog.findViewById(R.id.gesture_name);
        Bitmap bitmap = gesture.toBitmap(128, 128, 10, 0xffff0000);
        imgShow.setImageBitmap(bitmap);

        new AlertDialog.Builder(this)
                .setView(saveDialog)
                .setPositiveButton("保存", (dialogInterface, i) -> saveGesture(gesture, editName.getText().toString()))
                .setNegativeButton("取消", null)
                .show();
    }

    private void saveGesture(Gesture gesture, String name) {
        if (!gestureLibrary.load()) {
            Toast.makeText(this, "手势库加载失败!", Toast.LENGTH_SHORT).show();
            return;
        }

        gestureLibrary.addGesture(name, gesture);
        boolean isSaved = gestureLibrary.save();
        if (isSaved) {
            Toast.makeText(this, "手势保存成功!", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(this, "手势保存失败!", Toast.LENGTH_SHORT).show();
        }
    }
}

然后在 AndroidManifest.xml 文件中加入读 SD 卡的权限

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

参考文档

  1. 官方 API 文档: GestureDetector
  • 19
    点赞
  • 27
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

程序员老李头

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值