Skip to content

安卓:外接手柄马达 / 六轴、手柄按键布局 padFace(#528 第 10 项第二片) - #1600

Open
wwmogu wants to merge 1 commit into
claude/project-thread-e4rhgnfrom
claude/project-thread-0j8ur7
Open

wwmogu wants to merge 1 commit into
claude/project-thread-e4rhgnfrom
claude/project-thread-0j8ur7

Conversation

@wwmogu

@wwmogu wwmogu commented Nov 18, 2026

Copy link
Copy Markdown
Collaborator

Requested by wwmogu · project thread

本 PR 关的卡:Part of #528(差距表第 10 项,第二片:外接手柄自己的马达 / 六轴 + 手柄按键布局;第一片是 #1561)

叠在 #1561 上(base = 它的分支,只看最后一个提交 fc7c9ed)。#1561 合入、分支删掉后 GitHub 会自动把 base 改成 main。

问题与要证明什么

#1561 之后,安卓接着实体手柄时:手柄马达不震(手机马达也按 iOS 规矩让开,所以整局没震动);手柄自带的陀螺仪不用,体感一直读手机;面键只有按位置一种(缺省)或 adb 参数切 label,没有 iOS / Mac 的 padFace 自动 / Switch / Xbox。

要证明:接着有马达的手柄时 HD Rumble 左右两侧出到手柄左右马达;接着 DS4 / DualSense / Pro / Joy-Con 时六轴读手柄、坐标与 NS2 原始坐标一致,断了回落手机;按键布局三档与 runtime/src/pad.c 同义。

改动(只改了哪些文件)

  • android/app/.../PadFeedback.java(新):选玩家 1 的手柄(最近一次有输入的那只,否则第一只),拿马达(API 31 InputDevice.getVibratorManager,id 0 左 / 强、id 1 右 / 弱;API 29/30 InputDevice.getVibrator)和传感器(API 31 InputDevice.getSensorManager,加速度计 + 陀螺仪 200 Hz,只在游戏要六轴且在前台时注册)。反注册整个监听器,避开 InputDeviceSensorManager 逐个移除时的 ConcurrentModificationException(Dolphin DolphinSensorEventListener 记过这个 AOSP 坑)。
  • android/native/phone_feedback.c:
  • android/native/phone_feedback_policy.h:纯函数 s2a_android_side_level / s2a_android_pad_rumble_key、s2a_android_pad_frame / s2a_android_pad_axes、s2a_android_motion_step。
    • 坐标:安卓只把 Linux 驱动读数换成 m/s²、rad/s,不统一轴向。PlayStation(hid-playstation / hid-sony):x 右、y 正面法线、z 朝玩家;任天堂(hid-nintendo,右 Joy-Con 驱动已翻同向):x 上沿、y 左、z 法线。两套与 SDL SDL_hidapi_switch.c 的「任天堂 → PS」换序一致。认不出的厂商(含 Xbox,系统不给六轴)不用,回落手机。
  • GamepadState.java、MainActivity.java:padFace auto / switch / xbox。安卓按键码对所有手柄都按位置报(AOSP Vendor_057e_Product_2009.kl 把任天堂下键「B」报成 BUTTON_A),所以 auto = 任天堂手柄(厂商 057e 或名字含 Nintendo / Switch / Joy-Con,同 s2a_pad_kind 的片段)用 Switch 布局、其余用 Xbox 布局(PS × 确认)。旧值 position = switch、label = xbox,旧偏好 gamepadMapping 照搬;四指菜单加「手柄按键布局」「手柄震动」。缺省从 position 改成 auto(同 iOS / Mac)。
  • NativeBridge.java:configurePadFeedback、padSensor。中英文案各 7 条。README.md 两节。
  • 测试:android/tests/phone_feedback_test.c、GamepadStateTest.java、GamepadMappingInstrumentation.java(改成新缺省,旧值存成新偏好);CMakeLists.txt 给单测加 motion_pick.c。

修前 → 修后读数

期望值按物理姿态和按键位置手算,不跑被测实现。

项 期望 → 实测
phone_feedback_test 新增三组在 #1561 上 红(没有被测函数,编不出) → 编译失败
phone_feedback_test 在本 PR(gcc 13 / clang 18,-Wall -Wextra -Werror) 绿 → phone_feedback_test: ok
平放 / 上沿朝天 / 右侧朝天,PS 与任天堂各一 (0,0,1) / (0,1,0) / (1,0,0) g → 一致
绕法线 / 绕上沿 1 rad/s,两套 z / y = +57.30 °/s → 一致
SDL 换序交叉核对(任意非对称向量) 两套换出来相同 → 一致
左右马达档位:左 0.5 / 右封顶 / NaN / ≤ 0.01 128<<8 / +255 / 0 / 0 → 一致
来源:手柄优先、满 2 秒让手机、断了回手机丢一帧、回来再丢一帧、只有手机永不让 → 一致
GamepadStateTest:auto × 非任天堂 / 任天堂、switch、xbox、旧值、按着切型号不卡键、型号判断 → padFace auto/switch/xbox … passed
全部 app Java + 仪器测试按 API 34 框架类编译(robolectric android-all 14 当 classpath,R / BuildConfig 桩) 0 错 → 0 错(SystemPowerRails 用 API 35 类,换桩,与本 PR 无关)
phone_feedback.c 语法检查(gcc / clang,JDK jni.h + NDK 签名的 sensor / looper 头) 无告警 → 只有 JDK / NDK AttachCurrentThread 形参类型差那一条(同 #1561)
strings_translation_test / touch_strings_test / debug_gate_test / debug_environment_test / touch_appearance_wiring_test 全过 → 全过

负对照

  • PS 坐标上沿那一轴去掉取反:红 3 条。
  • 换源不丢帧(drop 恒 0):红 2 条。
  • 手机不等 2 秒就让:红 4 条。
  • 左右马达对调:红 3 条。
  • GamepadState 缺省改回 switch:GamepadStateTest.java:70 红;任天堂厂商号写错::124 红。

射程

宿主单测:两套坐标 × 3 个姿态 × 加速度 / 两轴角速度 + 交叉核对 + 两条反向对照;马达 6 例 + 节奏 3 步;来源 10 步;布局 3 档 × 2 种手柄 + 旧值 + 6 个非法值 + 7 个型号名。没有安卓真机、没有 NDK 链接与出包,以 CI「贡献者自检」为准。

一级自检

本地云端环境缺 NDK / .NET 10,tools/contrib_check.sh 跑不全;以 CI 为准。

平台耦合只减不增

没改 compat/tree、services/。

苹果路径不受影响的证明

没改共用源(runtime/src/motion_pick.c 只是单测多链一份)。

限制 / 未测项 / 后续

  • 真机未测。请 @n06ody 或维护者有空时用安卓 12+ 设备 + 手柄跑(PS / Switch Pro 手柄最好,Xbox 只能测震动和布局),原始输出贴回:
    1. 接手柄起局,adb logcat -s S2Arm | grep -E "Controller for|手柄|六轴|按键":应有 Controller for rumble / six-axis: <名字> (054c:0ce6), motor true, sensors true 与 手柄:震动 接手柄马达,六轴 PlayStation 坐标。
    2. 游戏震动时:手柄震动:首次 左 N/255、右 M/255,手柄两侧马达有区别。拔掉手柄后改由手机马达震。
    3. 会用六轴的游戏:手柄六轴:开(…,200 Hz)、六轴:来源 手机 → 手柄;平放 / 上沿朝上 / 右侧朝上各转一下,看视角方向是否跟手。拔掉手柄应出 六轴:来源 手柄 → … 再回到手机。
    4. 四指菜单「手柄按键布局」切三档:auto 下 Xbox / PS 手柄下键确认、Switch 手柄右键确认;switch 档一律右键确认,xbox 档一律下键确认。「手柄震动」关掉后手柄、手机都不震。
  • 别的厂商的手柄即使系统给传感器也不用,等有设备读数再加坐标。
  • 多只手柄仍全都并给玩家 1(原有行为),反馈跟最近一次有输入的那只。
  • iOS 的震动强度档位 / 手感曲线安卓还没有。

@jhaizhou-ops 请评审。


Generated by Claude Code

- 震动:接着有马达的手柄就震手柄(同 iOS 系统手柄)。API 31 两路马达(InputDevice VibratorManager,
  id 0 左 / 强、id 1 右 / 弱)分别接 HD Rumble 左右两侧;一路马达或 API 29/30(InputDevice.getVibrator)取大的一侧。
  租约 / 节流同手机马达;四指菜单「手柄震动」,缺省开。
- 六轴:API 31 InputDevice.getSensorManager,游戏要六轴且在前台才开(200 Hz)。安卓不统一手柄传感器轴向,
  按驱动的两套坐标换成 NS2 原始坐标:PlayStation(x 右、y 法线、z 朝玩家)、任天堂(x 上沿、y 左、z 法线),
  对照 Linux hid-playstation / hid-nintendo 与 SDL hidapi;认不出的厂商不用,回落手机陀螺仪。
  来源仍走共用 motion_pick(有样本的手柄优先),换源丢一帧,手柄供满 2 秒手机传感器歇着(同 iOS)。
  反注册整个监听器,避开 InputDeviceSensorManager 逐个移除的并发修改异常(Dolphin 记过)。
- 按键布局:padFace auto / switch / xbox 同 iOS / Mac(pad.c)。安卓按键码对所有手柄都按位置报,
  所以 auto = 任天堂手柄用 Switch 布局、其余用 Xbox 布局;旧值 position = switch、label = xbox,
  旧偏好 gamepadMapping 照搬。四指菜单可切,缺省 auto(原缺省 position)。
- 测试:phone_feedback_test 按姿态手算坐标换算(另拿 SDL 的任天堂→PS 换序交叉核对)、左右马达档位、来源仲裁,
  含反向对照;GamepadStateTest 覆盖三种布局 × 任天堂 / 其他手柄、旧值、型号判断;仪器测试改成新缺省。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@wwmogu wwmogu self-assigned this Nov 18, 2026
@wwmogu
wwmogu requested a review from jhaizhou-ops November 18, 2026 12:48
@jhaizhou-ops

Copy link
Copy Markdown
Owner

@wwmogu 收到,#528 第 10 项第二片(手柄马达、手柄六轴、padFace 自动 / Switch / Xbox)看到了。这支叠在 #1561 上,按你说的顺序:#1561 合进去、base 自动换成 main 之后再评审最后那一笔。已转给安卓线,后续由他们在这里接。

@jhaizhou-ops

Copy link
Copy Markdown
Owner

收到。只动 android/,没碰共用服务层。它叠在 #1561 上,#1561 已在合入队列里。等它合入后,我在新 main 上排 macOS 主机安卓整套和 Vulkan 容器夹具车道,跑你最后那笔 fc7c9ed9;如果到时需要 rebase 会在这里说。绿了就入车。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants