用途:为 Even Hub G2 应用提供用户输入、手势与生命周期事件的处理指南。
主要能力:支持 G2 镜腿触控板与 R1 戒指触控板,手势包括单击、双击、上滑、下滑;IMU 提供头部朝向与运动数据(详见 device-features 技能)。事件按当前捕获容器类型路由,每页仅一个容器可设 isEventCapture: 1。文本容器激活时,上滑/下滑触发 textEvent(1/2),单击与双击走 sysEvent(单击为 0,双击为 3);列表容器激活时,上下滑由 SDK 内部滚动不触发事件,单击走 listEvent 并带 currentSelectItemIndex,双击走 sysEvent。系统事件包括前台进入 4、前台退出 5、异常退出 6、系统退出 7。
使用方式:通过 waitForEvenAppBridge 获取 bridge,调用 bridge.onEvenHubEvent 注册监听,返回的 unsubscribe 需在组件卸载时调用。SDK 底层使用 protobuf,零值字段会变为 undefined,需用空值合并,如 event.sysEvent.eventType ?? 0、event.listEvent.currentSelectItemIndex ?? 0。退出建议双击后调用 bridge.shutDownPageContainer(1) 弹出系统确认框,不要在确认前清理资源;清理应放在 ABNORMAL_EXIT_EVENT 或 SYSTEM_EXIT_EVENT 处理中。
适用场景:需要处理眼镜与戒指输入、滚动、前后台切换及退出流程的 G2 应用。
限制:文本容器上的点击不会触发 textEvent,这是常见错误来源;每页只能有一个事件捕获容器,多个会校验失败;G2 与 R1 手势相同,需通过 sysEvent 的 eventSource 区分来源。