文档开发者中心
我的
|

HarmonyOS 6

HarmonyOS

HarmonyOS 5

HarmonyOS 7

手势识别在折叠屏铰链区如何区分误触和真实分屏拖拽?

手势识别在折叠屏铰链区如何区分误触和真实分屏拖拽?

点赞
收藏
1
回复
1
分享
举报
浏览7 发布于11分钟前北京
全部评论
最多点赞
最新发布
最早发布
AI 生成内容,仅供参考

折叠屏铰链区(折痕区)区分误触与真实分屏拖拽,核心思路是"空间避让 + 意图确认"双重判定:先通过系统接口获取折痕区的精确位置,将落在折痕区及其避让带内的触点直接判定为疑似误触;再通过"长按确认 + 方向/距离阈值"的组合手势机制,过滤掉短距离抖动和无意图的滑动,只有同时满足"触点不在铰链避让带内"且"长按后发生持续、足量的位移"两个条件,才认定为真实的分屏拖拽。

一、判定机制详解

需要先明确一个前提:折叠屏上由系统提供的分屏手势(智慧多窗)由系统窗口管理统一处理,应用侧无法也不需要拦截;应用内自定义的拖拽交互(如列表项拖拽排序、跨窗口内容拖拽)才需要自行做防误触设计。具体判定链路如下:

是

否

否

是

否

是

手指按下

触点是否落在铰链避让带内

判定为误触 忽略本次手势

长按手势是否识别成功

累计位移是否达到确认阈值

确认为真实拖拽 执行分屏拖拽逻辑

各环节的技术依据:

  1. 铰链区空间判定:通过 display.getCurrentFoldCreaseRegion()(API 10 起,元服务从 API 12 起支持)获取当前折痕区 FoldCreaseRegion,其中 creaseRects 为折痕矩形数组(单位 px)。非折叠设备调用返回 undefined,因此代码中需做空值保护。折痕区位置会随折叠状态变化,应配合 display.on('foldStatusChange') 在状态切换后重新获取。

  2. 意图确认(长按门槛):采用 GestureGroup(GestureMode.Sequence, LongPressGesture, PanGesture) 顺序组合手势,长按未成功则拖拽手势不会触发。这是官方推荐的列表拖拽实现方式,天然过滤掉快速划过铰链区的误触。

  3. 位移阈值确认:PanGesture 的 distance 参数(默认 5vp,手写笔默认 8vp)控制最小触发距离;在 onActionUpdate 中再对累计位移做二次确认,短距离抖动直接忽略。官方文档同时提醒:不合理的阈值设置会导致滑动不跟手,需在防误触与跟手性之间权衡。

  4. 布局层避让:官方设计规范建议折叠设备避免将关键交互组件和手势热区放置在转轴区,悬停态下上半屏内容由中线向上避让 16vp、下半屏向下避让 40vp,从源头减少铰链区误触的可能。

二、示例代码

以下示例实现了完整的防误触拖拽判定(适用于 API 10 及以上版本):

收起
自动换行
深色代码主题
复制
import { display } from '@kit.ArkUI';

@Entry
@Component
struct HingeDragDemo {
  // 折痕区矩形列表,单位px,随折叠状态动态刷新
  @State creaseRects: Array<display.Rect> = [];
  // 铰链避让带半宽(vp),触点落在折痕区±该范围内视为疑似误触
  private readonly GUARD_HALF_VP: number = 16;
  // 真实拖拽确认所需的最小累计位移(vp)
  private readonly DRAG_CONFIRM_VP: number = 10;
  // 拖拽意图是否已确认
  private dragConfirmed: boolean = false;
  @State hint: string = '长按列表项后拖动,试试铰链区内外的差异';
  @State dragIndex: number = -1;
  @State offsetX: number = 0;
  @State offsetY: number = 0;
  private items: Array<string> = ['条目一', '条目二', '条目三', '条目四'];

  aboutToAppear(): void {
    this.refreshCrease();
    // 折叠状态变化后折痕区位置可能改变,需重新获取
    display.on('foldStatusChange', () => {
      this.refreshCrease();
    });
  }

  aboutToDisappear(): void {
    display.off('foldStatusChange');
  }

  private refreshCrease(): void {
    // 非折叠设备返回undefined,需做空值保护
    const region: display.FoldCreaseRegion | undefined = display.getCurrentFoldCreaseRegion();
    this.creaseRects = region ? region.creaseRects : [];
  }

  // 判断窗口坐标(px)是否落在铰链避让带内
  private isInCreaseGuard(globalX: number, globalY: number): boolean {
    const guardPx: number = this.getUIContext().vp2px(this.GUARD_HALF_VP);
    for (const rect of this.creaseRects) {
      if (globalX >= rect.left - guardPx && globalX <= rect.left + rect.width + guardPx &&
        globalY >= rect.top - guardPx && globalY <= rect.top + rect.height + guardPx) {
        return true;
      }
    }
    return false;
  }

  build() {
    Column({ space: 12 }) {
      Text(this.hint)
        .fontSize(14)
        .fontColor('#666')
        .width('100%')
        .textAlign(TextAlign.Center)

      ForEach(this.items, (item: string, index: number) => {
        Text(item)
          .fontSize(16)
          .width('100%')
          .padding(16)
          .borderRadius(8)
          .backgroundColor(this.dragIndex === index ? '#d5e8ff' : '#f0f4f8')
          .translate({ x: this.dragIndex === index ? this.offsetX : 0, y: this.dragIndex === index ? this.offsetY : 0 })
          .gesture(
            // 顺序组合手势:长按未成功则拖拽不触发,天然过滤快速划过的误触
            GestureGroup(GestureMode.Sequence,
              LongPressGesture({ repeat: false })
                .onAction(() => {
                  this.dragIndex = index;
                  this.offsetX = 0;
                  this.offsetY = 0;
                }),
              PanGesture({ fingers: 1, direction: PanDirection.All, distance: 8 })
                .onActionStart((event: GestureEvent) => {
                  this.dragConfirmed = false;
                  // 空间判定:触点落在铰链避让带内,直接判定为误触
                  if (this.isInCreaseGuard(event.globalX, event.globalY)) {
                    this.hint = '触点位于铰链避让带内,判定为误触,忽略本次拖拽';
                    this.dragIndex = -1;
                    return;
                  }
                  this.hint = '长按成功,等待拖拽位移确认';
                })
                .onActionUpdate((event: GestureEvent) => {
                  if (this.dragIndex < 0) {
                    return;
                  }
                  // 位移确认:累计位移不足时视为抖动,不进入拖拽
                  if (!this.dragConfirmed) {
                    const dist: number = Math.sqrt(event.offsetX * event.offsetX + event.offsetY * event.offsetY);
                    if (dist < this.DRAG_CONFIRM_VP) {
                      return;
                    }
                    this.dragConfirmed = true;
                    this.hint = '拖拽意图已确认,执行真实拖拽';
                  }
                  this.offsetX = event.offsetX;
                  this.offsetY = event.offsetY;
                })
                .onActionEnd(() => {
                  this.dragIndex = -1;
                  this.offsetX = 0;
                  this.offsetY = 0;
                })
            )
          )
      }, (item: string) => item)
    }
    .width('100%')
    .height('100%')
    .padding(16)
  }
}

三、补充说明

  1. 坐标系换算:getCurrentFoldCreaseRegion 返回的折痕区坐标基于屏幕坐标系,而 GestureEvent 的 globalX/globalY 基于应用窗口坐标系。应用处于全屏模式时两者基本一致;在分屏、悬浮窗等模式下,需要叠加窗口相对屏幕的偏移量后再做判定,否则会出现铰链区判定偏移。

  2. 阈值调优建议:distance 建议设置在 8~12vp,位移确认阈值建议 10vp 左右。阈值过小防误触效果弱,过大则拖拽不跟手。若手势与 Tabs、List 等可滑动组件存在竞争,官方建议将 distance 设为 1 提升灵敏度,此时更应依赖长按门槛和铰链区判定来防误触。

  3. 真正拦截手势:上述代码采用"忽略策略"(回调内不执行拖拽逻辑),手势本身仍会被识别。若需要在铰链区内彻底不响应手势,可使用 API 12 及以上版本的手势处理器(PanGestureHandler 等)配合事件回调动态控制,或在布局层通过 responseRegion 将铰链区对应组件的触摸热区排除。

  4. 布局层配合:建议结合 FolderStack、FoldSplitContainer 等折叠屏预置组件做悬停态与分栏布局适配,从设计层面避免把可拖拽元素和手势热区布置在折痕区附近,这是减少铰链区误触最根本的手段。

展开全部
1楼回复于10分钟前 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。