如何在HarmonyOS使用Java SDK开发的自定义组件中检测双击事件

错误原因 #

你原有代码中使用TouchEvent.getPointerCount()判断双击的逻辑是错误的：该方法返回的是同一时间触摸屏幕的手指数量，pointerCount == 2对应的是双指同时按压的操作，和连续两次点击的双击操作完全不同，所以无法正确识别双击。

正确实现方案 #

HarmonyOS Java SDK提供了和Android功能一致的手势检测器GestureDetector，可以直接用来实现双击检测，不需要自行封装时间判断逻辑：

步骤1：初始化手势检测器

import ohos.multimodalinput.event.GestureDetector;
import ohos.multimodalinput.event.TouchEvent;
import ohos.agp.components.Component;

GestureDetector gestureDetector = new GestureDetector(context, new GestureDetector.SimpleOnGestureListener() {
    @Override
    public boolean onSingleTapConfirmed(TouchEvent event) {
        // 单击触发逻辑
        LogUtil.info(TAG, "single click detected");
        return super.onSingleTapConfirmed(event);
    }

    @Override
    public boolean onDoubleTap(TouchEvent event) {
        // 双击触发逻辑，在此处添加你需要执行的任务
        LogUtil.info(TAG, "double click detected");
        return super.onDoubleTap(event);
    }
});

步骤2：绑定触摸监听，转发事件给手势检测器

Component.TouchEventListener touchEventListener = new Component.TouchEventListener() {
    @Override
    public boolean onTouchEvent(Component component, TouchEvent touchEvent) {
        // 所有触摸事件交给手势检测器处理
        return gestureDetector.onTouchEvent(touchEvent);
    }
};

// 给自定义组件绑定触摸监听
yourCustomComponent.setTouchEventListener(touchEventListener);

轻量自定义实现方案 #

如果不想依赖系统手势检测器，也可以通过记录两次点击的时间差自行实现双击判断：

// 类成员变量
private long lastTapTime = 0L;
// 双击最大间隔阈值，可根据需求调整，通常设置为200~350ms
private static final long DOUBLE_TAP_GAP = 300;

Component.TouchEventListener touchEventListener = new Component.TouchEventListener() {
    @Override
    public boolean onTouchEvent(Component component, TouchEvent touchEvent) {
        // 只处理手指按下的动作
        if (touchEvent.getAction() == TouchEvent.PRIMARY_POINT_DOWN) {
            long currentTime = System.currentTimeMillis();
            if (currentTime - lastTapTime < DOUBLE_TAP_GAP) {
                // 满足双击间隔要求，触发双击逻辑
                LogUtil.info(TAG, "double click detected");
                lastTapTime = 0L; // 重置时间，避免连续点击误判为多次双击
                return true;
            }
            lastTapTime = currentTime;
            return true;
        }
        return false;
    }
};

内容的提问来源于stack exchange，提问作者Shivam Jamaiwar