HarmonyOS 鸿蒙Next中如何禁用双指长按唤起小艺识屏

HarmonyOS 鸿蒙Next中如何禁用双指长按唤起小艺识屏 现在双指长按屏幕会唤起小艺识屏，跟我们 app 的业务逻辑冲突，如何通过 API 或者设置在 app 内禁用小艺识屏？

3 回复

业务没限制的话可以给页面设置隐私模式，这样双指识屏就不会弹出了：如何实现防截屏功能

更多关于HarmonyOS 鸿蒙Next中如何禁用双指长按唤起小艺识屏的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中，禁用双指长按唤起小艺识屏功能，需通过代码控制。在Ability或UI组件中，使用onTouchEvent监听触摸事件，判断是否为双指长按操作（通过PointerEvent的pointers数量及action类型识别），并在事件处理中返回true以拦截默认行为，阻止小艺识屏的触发。具体实现需参考HarmonyOS Next的触摸事件API文档。

在HarmonyOS Next中，可以通过在UIAbility的onWindowStageCreate生命周期中，为应用窗口设置手势拦截来禁用双指长按唤起小艺识屏功能。

具体实现代码如下：

import { UIAbility, AbilityConstant, window } from '@kit.AbilityKit';

export default class EntryAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage) {
    // 获取应用主窗口
    let mainWindow = windowStage.getMainWindow();
    
    // 设置窗口属性，拦截指定手势
    mainWindow.setWindowTouchable({
      // 禁用双指长按手势
      twoFingersLongPress: false,
      // 可根据需要设置其他手势
      // oneFingerLongPress: true, // 单指长按通常不影响
      // twoFingersTap: true,
      // ... 其他手势配置
    }).then(() => {
      console.info('禁用双指长按识屏成功');
    }).catch((err) => {
      console.error('设置窗口手势失败: ' + JSON.stringify(err));
    });
  }
}

关键点说明：

  1. setWindowTouchable API允许应用自定义窗口级别的手势响应行为。
  2. 将twoFingersLongPress参数设置为false即可拦截双指长按手势，阻止系统默认的小艺识屏功能。
  3. 此设置仅影响当前应用窗口，不会影响系统其他应用或设置。

注意事项：

  • 该API需要API version 11及以上版本支持。
  • 如果应用内存在多个窗口，需要对每个需要禁用的窗口单独设置。
  • 禁用该手势后，应用内所有双指长按操作都将由应用自行处理，系统不再拦截。

此方法直接通过窗口手势管理解决冲突，无需修改业务逻辑代码。

回到顶部