Android 13设备三指触发FingersGesture致合成器应用多点触控失效求助

什么是FingersGesture #

这是Android 13为平板等大屏设备新增的系统级多指快捷手势，属于系统辅助触控功能的一部分。系统会监听三指及以上的触控动作，用来触发预设的系统操作（比如三指滑动切换应用、三指长按唤起快捷菜单等）。当你的合成器应用触发三指触控时，系统会优先拦截这个手势事件，导致应用的多点触控输入被中断，从而破坏琴键的同时按压功能。

禁用方案 #

1. 针对琴键区域设置系统手势排除区（推荐） #

通过代码将你的屏幕琴键所在的View区域标记为系统手势的排除范围，这样系统就不会在该区域拦截多指触控事件。

Kotlin 示例代码

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_synth)
    
    val keyboardView = findViewById<View>(R.id.synth_keyboard)
    // 等待View布局完成后获取准确区域
    keyboardView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
        override fun onGlobalLayout() {
            keyboardView.viewTreeObserver.removeOnGlobalLayoutListener(this)
            val rect = Rect()
            keyboardView.getGlobalVisibleRect(rect)
            window.insetsController?.setSystemGestureExclusionRects(listOf(rect))
        }
    })
}

Java 示例代码

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_synth);
    
    View keyboardView = findViewById(R.id.synth_keyboard);
    keyboardView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
        @Override
        public void onGlobalLayout() {
            keyboardView.getViewTreeObserver().removeOnGlobalLayoutListener(this);
            Rect rect = new Rect();
            keyboardView.getGlobalVisibleRect(rect);
            if (getWindow().getInsetsController() != null) {
                getWindow().getInsetsController().setSystemGestureExclusionRects(Collections.singletonList(rect));
            }
        }
    });
}

2. 在View层强制消费触控事件 #

在你的屏幕琴键自定义View（或父布局）的onTouchEvent方法中，明确消费所有触控事件，并阻止父布局/系统拦截事件传递：

Kotlin 示例代码

override fun onTouchEvent(event: MotionEvent): Boolean {
    // 这里处理你的多点触控琴键逻辑
    when(event.actionMasked) {
        MotionEvent.ACTION_DOWN, MotionEvent.ACTION_POINTER_DOWN,
        MotionEvent.ACTION_MOVE, MotionEvent.ACTION_UP, MotionEvent.ACTION_POINTER_UP -> {
            // 处理琴键按下/抬起逻辑
        }
    }
    // 阻止父布局拦截触控事件
    parent.requestDisallowInterceptTouchEvent(true)
    // 返回true表示事件已被消费
    return true
}

3. 全局Manifest配置（不推荐） #

如果需要为整个Activity禁用系统多指手势，可以在Manifest的Activity标签中添加静态配置，但这种方式无法动态适配View的位置变化，灵活性较差：

<activity
    android:name=".SynthActivity"
    android:windowSystemGestureExclusionRects="@array/gesture_exclusion_rects">
</activity>

同时在res/values/arrays.xml中定义矩形坐标：

<array name="gesture_exclusion_rects">
    <item>0,0,1080,2000</item> <!-- 格式为left,top,right,bottom -->
</array>

内容的提问来源于stack exchange，提问作者John Am