Repository navigation
Releases
PadLink v1.0.0
PadLink v1.0.0
第一个正式版。设置页重做,补齐震动回传,并修了一轮输入与连接可靠性问题。
新增
- 游戏震动回传:PC 端把驱动收到的 Rumble 通过 8 字节反向帧发回手机,手机驱动马达。ADB(TCP)通道已真机验证;WiFi(UDP)通道代码已实现,未真机验证。
- 自定义连接端口:PC 设置 → 端口 → 控制端口,手机 设置 → 连接设置,两端填同一个端口(默认 42312)。端口被 VPN/代理或其它程序临时占住时,换一个即可;两端各自保存。
- 设置页重构:快捷面板 + 独立设置页,主题色/动态取色,新的设置图标。
- 连接心跳:PC 每秒发
ping,手机回pong;挂机不动不会再被当成“已拔出”回收。 - 连接状态即时更新:TCP EOF、心跳超时、发送失败都会立刻提示并自动重连。
修复
- 输入改为位置判定:按键以当前位置是否还在区域内决定按下,滑出立即释放;摇杆/扳机/八向可以从中途滑入接管。特殊控件接管一根手指后独占它:滑出后仍按手指在控件外的位置继续算值(摇杆夹到边缘、扳机夹到 0/1),抬手才归零;这根手指滑过其他控件也不会误触。滑块从其它控件滑入时的震动由根手势统一触发。
- 帧数显示:顶部不再显示累计帧数(挂机半小时会到十几万),改成实时
fps。 - 后台重力未冻结:切到后台时先停传感器、再归零左摇杆,回前台恢复。
- PC 单实例:重复双击
PadLink.Gui.exe会把已有窗口从托盘叫回来,不再报端口占用。 - 缺 ViGEmBus 的报错:显示明确的安装提示,GUI/CLI/自检都不再甩未处理异常堆栈。
- 端口占用提示:服务启动失败时直接提示换端口或检查托盘里的已有实例。
已知限制
- PS4 陀螺仪未透传:ViGEm 的高层 DS4 API 没有 IMU 接口,需要改
SubmitRawReport并扩展协议。 - WiFi 模式、DS4 Y 轴方向仍需真机校准。
- PC 包不包含 .NET 运行时,需要 .NET 10 Desktop Runtime。
版本
1.0.0(versionCode 23)
PadLink v1.0.0-rc1
PadLink v1.0.0-rc1
第一个 1.0 候选版。设置页重做,补齐震动回传,并修了一轮后台与连接可靠性问题。
新增
- 游戏震动回传:PC 端把驱动收到的 Rumble 通过 8 字节反向帧发回手机,手机驱动马达。ADB(TCP)通道已真机验证;WiFi(UDP)通道代码已实现,未真机验证。
- 自定义连接端口:PC 设置 → 端口 → 控制端口,手机 设置 → 连接设置,两端填同一个端口(默认 42312)。端口被 VPN/代理或其它程序临时占住时,换一个即可;两端各自保存。
- 设置页重构:快捷面板 + 独立设置页,主题色/动态取色,新的设置图标。
- 连接心跳:PC 每秒发
ping,手机回pong;挂机不动不会再被当成“已拔出”回收。 - 连接状态即时更新:TCP EOF、心跳超时、发送失败都会立刻提示并自动重连,不再等下一次手动操作。
修复
- 后台重力未冻结:切到后台时先停传感器、再归零左摇杆,回前台恢复;开关和零点不丢。
- PC 单实例:重复双击
PadLink.Gui.exe会把已有窗口从托盘叫回来,不再报cannot bind listener address already in use。 - 缺 ViGEmBus 的报错:显示明确的安装提示,GUI/CLI/自检都不再甩未处理异常堆栈。
- TCP 断开即时清理:ADB 连接关闭立即销毁对应虚拟手柄,不再等 5 分钟空闲回收。
- 端口占用提示:服务启动失败时直接提示“可能已有一个 PadLink 在运行(托盘)”。
已知限制
- PS4 陀螺仪未透传:ViGEm 的高层 DS4 API 没有 IMU 接口,需要改
SubmitRawReport并扩展协议。 - WiFi 模式、DS4 Y 轴方向仍需真机校准。
- PC 包不包含 .NET 运行时,需要 .NET 10 Desktop Runtime。
版本
1.0.0-rc1(versionCode 22)
PadLink v0.8.5
PadLink v0.8.5
PC 端启动优化与一轮审计修复。
启动卡顿
根因是两处:
AdbTunnel.Run()先同步ReadToEnd()、再WaitForExit(timeout)。adb 一卡,ReadToEnd就永远不返回,超时形同虚设。- 启动时在 UI 线程同步做 ADB 探测。窗口已经画出来了,但消息循环被堵住十几秒,看起来就是“打开卡住”。
修复:
- 管道改为异步读取,等待退出带真实超时,超时直接杀进程树
- 启动时的 ADB 探测移到后台;窗口先完成绘制,再启动服务
- 设置页「ADB 隧道」按钮也改后台,不再冻住弹窗
FindAdb()结果缓存,后台 3 秒巡检不再反复起 4 个进程试错- 本机地址从
Dns.GetHostAddresses(本机名)改成枚举网卡,去掉 DNS 依赖 - 会话表加锁并返回快照,修掉 UI 每 500ms 枚举时网络线程增删会话的并发风险
实测
- 窗口出现 245ms(修复前十几秒)
- 窗口出现后 2ms 消息循环空闲
- ADB 探测 5.4s 在后台完成,界面全程可操作
版本
0.8.5(versionCode 20)
PadLink v0.8.4
PadLink v0.8.4
震动时长调整,并加了一个乘区。
时长
- 八向键方向切换:10ms → 20ms
- 扳机滑条按在弱加载区:10ms → 20ms
- 扳机滑条跨过强弱分界:两个方向都改为 20ms(强→弱也有小震动)
- 强加载区按下仍为 30ms;其它按键/摇杆 30ms
主界面
- 连接状态从左上角移到屏幕底部居中,顶部只留「设置」
- 长错误信息单行显示,超出省略;状态浮在手柄画布上方
新增「震动乘区」
- 设置 → 按键设置 → 震动设置 → 震动乘区
- 0.5× – 2.0×,步进 0.1,默认 1.0×
- 所有震动时长都乘这个系数,上限 200ms
- 存进
padlink-app,重启后保留
版本 0.8.4(versionCode 19)
PadLink v0.8.3
PadLink v0.8.3
补齐控件震动。10ms / 30ms 都是震动时长,不是延迟。
摇杆
- 触摸按下:30ms
- 重力转向开启时,左摇杆触摸不震(那是让位/微调);L3 按钮仍按普通按键震 30ms
扳机滑条
- 按在弱加载区:10ms
- 按在强加载区:30ms
- 跨过强弱分界:两个方向都 10ms(弱→强、强→弱)
八向键
- 方向切换时 10ms,停在同方向不重复震
其余
- ABXY / 肩键 / Back / Start / Guide / L3 / R3 / 按钮式扳机仍为 30ms
版本 0.8.3(versionCode 18)
PadLink v0.8.2
PadLink v0.8.2
修复震动、主题背景和设置页的几处问题。
震动
- 事件已经送到系统,但被归类为
USAGE_TOUCH;这台机器TOUCH = OFF,于是标记成ignored_for_settings,马达不响 - 33+ 改为显式
USAGE_HARDWARE_FEEDBACK,对应「硬件反馈」强度,不受触感反馈开关影响
主题
- 背景不再所有预设共用同一套灰色:
background/surface/surfaceContainer*/outline都按主题色相派生(6%–10% 低饱和),五个预设的底色调明显不同 - 设置页 chip 改为自动换行,最后一个「粉」不会被挤出屏幕
设置页
- 新增「关于」:PadLink 版本号、syhugh7、前往项目(右上箭头)与 Star 提示
- 编辑键位界面的右上角按钮抬到最上层,不再被手柄控件盖住
设置留存
主题模式 / 主题色 / 按键反馈 / 退出前台冻结 / 状态栏策略都存在 SharedPreferences;布局与陀螺仪参数分别存在 LayoutStore / TiltStore。重启后仍在。
版本 0.8.2(versionCode 17)
PadLink v0.8.1
PadLink v0.8.1
修复「按钮按下反馈」没有震动。
原因
- manifest 没有
android.permission.VIBRATE - 原实现走 Compose
LocalHapticFeedback→View.performHapticFeedback(),还受系统「触感反馈」开关控制;本机该开关是关闭的(haptic_feedback_enabled=0)
修复
- 补上
android.permission.VIBRATE - 改成
VibratorManager/Vibrator直接驱动马达,30ms 短震,不再依赖系统触感开关 - 没有马达的机器静默跳过
- 设置里打开「按钮按下反馈」时会立即试震一次
版本 0.8.1(versionCode 16)
PadLink v0.8.0
PadLink v0.8.0
「前台时禁用状态栏」可用了,走 Dhizuku。
新功能
- 设置 → 应用设置 → 前台时禁用状态栏
- 通过 Dhizuku 的 UserService 在 Device Owner 进程里调用官方
DevicePolicyManager.setStatusBarDisabled(),不是改系统设置、也不是只隐藏状态栏 - 首次打开会拉起 Dhizuku 授权界面;没装 Dhizuku 时开关置灰
- 主界面和设置页都算前台;切到其他应用 600ms 后恢复状态栏,避免两屏切换时闪一下
- 进程被强杀后,下次启动会补一次恢复(SharedPreferences 里留了标记)
技术
- 本地依赖 Dhizuku-API 2.7.0 的
classes.jar:aar 的minCompileSdk=36,不为了它把项目 compileSdk 拉上去 - 新增 AIDL
IPadLinkUserService和PadLinkUserService,后者由 Dhizuku 加载进自己的进程执行 AppPrefs新增disableStatusBar(用户设置)与statusBarApplied(强杀保险丝)
仍然待做
选择布局、PS4 全局体感、PS4 震动回传。
版本 0.8.0(versionCode 15)
PadLink v0.7.0
PadLink v0.7.0
主题色真正接入全局,Guide 键换成 Xbox logo。
主题
- 五个预设主题色降低饱和度(雾蓝 / 灰紫 / 灰绿 / 暖橙 / 灰粉),暗底上不再刺眼
- 主题色不再只改
primary:secondary / tertiary / 各种 container / 开关 / chip / 选中态全部由种子色派生,整套 Material3 配色一起变 - Android 12+ 的动态取色与预设色走同一条 ColorScheme 链路
- 主界面全部自绘控件接入主题:按键、摇杆、十字键、扳机、编辑轮廓;按下态统一用主题色,亮 / 暗主题自动适配
主界面
- 快捷面板「连接状态」后显示「未连接 / 已连接」
- Guide 键改用 Xbox 西瓜 logo(SVG 转 VectorDrawable,跟随主题着色,按下反色)
仍然待做
选择布局、PS4 全局体感、PS4 震动回传、Dhizuku 前台禁用状态栏。
版本 0.7.0(versionCode 14)
PadLink v0.6.0
PadLink v0.6.0
设置从「一个对话框」改成「快捷面板 + 独立设置页」。
主界面
顶部「设置」不再是对话框,弹出一个快捷面板:
- 连接状态(开关)
- 重力转向(开关)
- 调整布局
- 全部设置 >
连接方式(ADB / WiFi)没放进去 —— 那是 PC 端握手时定的,手机端不该再选一次。
设置页(新开一个界面)
个性化
- 主题设置:亮 / 暗 / 跟随系统
- 主题色:动态取色(Android 12+)/ 蓝 / 紫 / 绿 / 橙 / 粉
按键设置
- 扳机键设置:线性 / 扳机;线性时可调弱加载区、宽度、长度
- 十字键设置:8 向 / 四分
- 陀螺仪设置:重力转向开关,死区 / 满舵角 / 曲线 / 平滑 / 恢复延时,重定中心
- 震动设置:按钮按下反馈
- 调整布局
- 选择布局(灰的,还没做)
应用设置
- 退出前台时冻结:切走时把输入归零
- 前台时禁用状态栏(灰的,需要 Dhizuku)
顺带
- 按键按下有触感反馈了,设置里可以关
- 主题切换立刻生效,主界面和设置页共用同一份状态
结构变化
PadLinkApplication 持有 controller / prefs / layout —— 设置页是另一个 Activity,
两边要看同一份状态。顺带界面重建也不会再把连接和传感器收掉。
旧的 AppSettingsDialog 已删除(SettingsDialogs.kt 从 511 行缩到 320 行)。
待做
选择布局、PS4 全局体感、PS4 震动回传、Dhizuku 那个开关、Guide 键的 Xbox logo 贴图。