Skip to content

Releases

v0.42.0 — 手机九键(拼音):点格子弹字母、按住发数字

Choose a tag to compare

@linxun314 linxun314 released this 18 Nov 11:23

只介绍当前这一代(v0.38.0 → v0.42.0)。 上一版 Release 停在 v0.37.8,这一代补了 5 个版本的内容。

一、手机九键(拼音)布局 —— v0.42.0

「切换布局」现在循环 三档:手机布局(26 键)→ 手机九键 → 电脑布局,选过的档位会记住。

  • 3×4 宫格,每格上面是数字、下面小字是这格的字母(2 abc / 7 pqrs …),一眼看出字母分布
  • 点一下格子 → 这格字母在格子上弹成一条,手指不抬、往右滑到要的字母,抬手就发;不滑就是第一个字母(与 iOS 九键一致)
  • 按住格子约 0.42 秒 → 直接发这一格的数字(轻震一下),打数字不用切符号页
  • 九键发的仍是普通 A–Z 键码,拼音转汉字照旧由平板/电脑自己的输入法完成
  • 九键下方也有「符号」页;电脑模式下切九键会自动跳回电脑布局

二、键盘「点了没反应」「落在键缝里没反应」—— v0.41.0

  • 键盘报文改成先进先出队列:以前队列「每个 report id 只留最新一份」,快按时「抬起」会把还没发出去的「按下」覆盖掉,那一下整条丢失。现在 3 次快速点按实测发出 6 条报文(修前只有 3 条)
  • 按键加 9 dp 容差:手指落在两颗键中间的缝隙里也能就近命中;按住后轻微抖动不再立刻抬键;同键 30 ms 内重复触发会去抖
  • 顺带修掉「HID 注册被系统回收」:主界面和保活服务各注册一次会互相踢掉,现在 1 秒内只注册一次

三、触控板手势与滚动条 —— v0.39.0 – v0.40.2

  • 手势(可在「手势详细设置」逐项开关):点按拖动、拖拽锁定、惯性滚动、自然滚动方向、边缘续推、误触/手掌抑制;平板专属(三指上滑=多任务、三指下滑=主页、双指右滑=返回);电脑专属(三指上=任务视图、下=显示桌面、左右=切窗口、四指左右=切虚拟桌面、双指横滑=横向滚动、双指右滑=后退)
  • 右侧滚动条换成 macOS 风格:磨砂胶囊轨道 + 常驻白滑块(三条细纹)+ 上下细箭头。点箭头 / 点轨道 = 滚一格(滑块不动),按住 = 连续慢滚,只有抓住滑块上下拖才是跟手的滚轮,抓滑块时上下键完全静音
  • 触控板上下键按住 = 连续但慢速(默认 180 ms 一格,可选慢/中/快)
  • 滚轮条灵敏度 / 抬手惯性 / 顺滑度 / 震动 都可在「指针灵敏度」弹窗里调

四、手柄每个键都能改成别的功能 —— v0.38.0

手柄设置 →「按键映射」:14 个物理键(方向、ABXY、L1/R1/LT/RT、SELECT/START)可改成 不发送 / 手柄按键 / 方向键 / 键盘键(Esc、Tab、空格、WASD、方向键、数字、Shift、Ctrl…)/ 鼠标左中右 / 媒体键,三套配置可以给不同游戏用,另有 Xbox / PS / Switch 面键布局。

五、这一代里撤掉的东西

  • 「抓取拖动 2.0」已撤销(v0.40.7):蓝牙鼠标长按拖动在 Android / vivo 桌面上不被接受,这是桌面不认 SOURCE_MOUSE 拖动导致的,App 侧改不出来
  • 媒体页「上一段 / 下一段发送」整行(含滚轮爆发)已移除(v0.40.6),媒体卡回到 ⏮ ⏯ ⏭ + −10s / +10s
  • 触控板底部「中键」已删除(v0.40.3)

下载

文件 设备 说明
PhoneKB-0.42.0.apk 手机 全部键鼠 / 媒体 / 手柄功能,一个 APK 就是全部
—— 平板 / 电脑 零安装:只做一次蓝牙配对,不用装任何 App、免 root

手机九键只改变「怎么敲字母」,不做拼音联想/候选词:拼音转汉字仍由被控端自己的输入法完成(蓝牙 HID 只能发键码)。

HID 描述符是配对时被主机缓存的,升级后如果手柄/键位异常,到平板或电脑的蓝牙设置里「忘记这台设备」再重新配对一次即可。

PhoneKB v0.37.8 — 电脑上玩奥日这类游戏:为什么看不到手柄,以及 Steam 映射怎么开

Choose a tag to compare

@linxun314 linxun314 released this 06 Nov 11:55

只介绍当前这一代(v0.37.8)。本版只有帮助文案和文档,没有功能改动 —— APK 的行为和 v0.37.7 完全一致。

一句话结论

Windows 只把手机当「通用 HID 游戏控制器」(DirectInput),而奥日、绝大多数 3A 只枚举 XInput(Xbox) 设备,所以游戏里根本列不出这个手柄。不是按键没发出去 —— 是两套协议不同,蓝牙 HID 没法伪装成 Xbox 手柄,App 侧改不出来。

实测证据(这台 Windows 上)

  • 注册表 HKCU\System\CurrentControlSet\Control\MediaProperties\PrivateProperties\Joystick\OEM 里有两条 PhoneKB:VID_000100E0_PID_0000、VID_038F&PID_1200
  • winmm:joyGetNumDevs=16,joyGetPosEx(0) / joyGetPosEx(1) 都是 rc=0 buttons=0 hat=65535 X=32767 Y=32767 Z=0(居中正常响应)
  • 结论:Windows 侧的链路完全正常,只是它把设备挂在 DirectInput 下;只认 XInput 的游戏不会枚举它

怎么在 Steam 里玩(5 步)

  1. Steam → 设置 → 控制器 → 打开「通用手柄配置支持」
  2. 「通用手柄 → 测试设备」里按几下手机上的键,确认 Steam 收到了(能看到按键亮)
  3. 右键游戏 → 属性 → 控制器 → 勾上「启用 Steam 输入」
  4. Steam 会把它虚拟成 Xbox 手柄交给游戏,进游戏就能用
  5. 非 Steam 游戏:先「添加非 Steam 游戏到我的库」,之后同样生效

手边有真 Xbox 手柄时,玩奥日这类游戏直接用真手柄最省事。

文档与帮助

  • App 里「帮助」弹窗:手柄那一段之后新增「电脑上玩只认 Xbox 手柄的游戏」整段
  • docs/使用说明.md:手柄页新增「在电脑上玩游戏(只认 Xbox 手柄的游戏)」条目,FAQ 新增一问
  • 顺带说明:指针上报节奏四个档位(2 / 6 / 9 / 12 ms)实测都可用,默认仍然是 9 ms

下载

文件 装在哪 说明
PhoneKB-0.37.8.apk 手机 全部键鼠 / 媒体 / 手柄功能,一个 APK 就是全部

平板 / 电脑端什么都不用装:Windows 10/11 和 Android 都自带蓝牙 HID 键鼠驱动,配对完即用。

升级提示:HID 描述符是配对时缓存的,如果更新后按键行为异常,在平板 / 电脑的蓝牙设置里「忘记设备」,再用 App 的「配对」重新配一次。

PhoneKB v0.37.7 — 设备可「断开」+ 顶栏重排 + 触控板更跟手

Choose a tag to compare

@linxun314 linxun314 released this 06 Nov 04:38

v0.37.7 — 设备可「断开」 · 顶栏重排 · 触控板更跟手

这一代是 v0.37.0 → v0.37.7 的合集(GitHub 上一次还停在上一个版本)。

1. 在 App 里切换连接的设备,不用再取消配对(v0.37.5)

  • 顶栏电源键右边新增 「设备」 按钮:列出所有已保存的主机(类型角标 + 设备名 + 「类型 · 上次连接时间」),当前那台标绿点「已连接」,其它显示「切换」
  • 点「切换」→ 先松开按住的键 → 断开当前设备 → 连目标设备(约 1–2 秒);已配对过的设备不需要重新配对
  • 设备抢连守护(默认开,可关):切到电脑后平板自己连回来时,2 秒内自动切回你选的那台
  • 列表只显示能当键盘主机的设备(电脑 / 平板 / 手机),耳机、手表不会混进来;「刷新列表」重新读系统配对表

2. 已连接的那台设备可以「断开」(v0.37.7)

  • 只有当前真的连着的那一行会多出红色描边的 「断开」 按钮;没连着的设备仍然只有「切换」
  • 点「断开」:松开所有按住的键 → 断开 → 顶栏变「已断开 / 点「切换」连回来」,点一下就又能连回去
  • 断开后不会再自己连回去:自动重连、首选设备冷启动回连、抢连守护在这期间全部暂停

3. 顶栏重排(v0.37.6)

  • 「设备」键放大成带手机图标的重点按钮(蓝色描边),一眼能认出、好按
  • 「平板」「电脑」折成一个:按钮上写当前模式(「平板 ⌄」/「电脑 ⌄」),点一下弹两项选择
  • 「旋转」从「更多」里拿出来,一直露在页签行右端(长按 = 跟随系统)
  • 删掉「单手」页签:页签固定为 键盘 / 触控板 / 媒体 / 手柄 / 双手 五个
  • 设备列表的类型角标由「平 / 电 / 他」汉字换成 线稿图标(手机 / 显示器 / 电视),并修掉设备名被裁字的 bug

4. 触控板「卡顿、不跟手」(v0.37.4)

  • 根因:以前两帧间隔 ≥2 ms 就发一份鼠标报文,快速划动一秒能发四五百份,而蓝牙 HID 中断通道大约只跑 90 份/秒 —— 多出来的全堆在系统蓝牙栈里排队,光标越滑越落后
  • 现在按节奏发:默认每 9 ms 一份(≈111 份/秒),领先边缘立刻发、中间的移动累加合并,一份都不丢
  • 「更多设置」新增 「指针上报节奏」:2 ms 极速 / 6 ms 跟手 / 9 ms 标准(默认)/ 12 ms 省蓝牙,改完立刻生效并记住

5. 手柄在 Windows 上「某个键一直亮着」(v0.37.1 – v0.37.2)

  • 方向位以前混进了手柄报文的「按钮」字段:Windows 按顺序数按钮,于是方向位变成「按钮 1–4」,只要丢一次松手报文那个按钮就一直亮着 → 现在方向只走 hat 开关
  • 断开 / 重连时的「归零报文」从 3 字节补成完整的 7 字节;离开手柄页、切页、进后台都会自动松开所有键与摇杆
  • 连接更可靠:重连最多 8 次(3 s 起、每次 +3 s、封顶 30 s),失败后明确提示「连不上平板 / 平板没有响应」,点状态文字可立刻重试;冷启动会自动连回上次连过的设备

6. 电脑模式:同一部手机也能当 Windows 电脑的键盘(v0.37.0)

  • 顶栏「平板 / 电脑」切换(记住上次选择)。电脑模式走同一条蓝牙 HID 通道,Windows 10 / 11 自带驱动,电脑端不用装任何软件
  • 键盘页快捷键条换成 Windows 常用键:Ctrl+C / Ctrl+V / Win / Win+D / Alt+Tab / 截屏(Win+Shift+S)/ 锁屏(Win+L)
  • 媒体页常用键卡换成 Windows 版:音量 / 静音 / 截屏 / 任务视图 / 锁屏 / 播放 / 上下首 / 菜单(Shift+F10)
  • 竖屏键盘页、触控板页、媒体页的分隔条可拖动改高度,双击恢复默认

下载

文件 适用
PhoneKB-0.37.7.apk 手机端(Android 9+,免 root,493 KB)

平板 / 电脑都不用装任何东西 —— 纯蓝牙 HID,被控端零安装、免配置。

升级提示:如果手柄按键或方向表现异常,请在被控端的蓝牙设置里「忘记设备」后重新配对一次(HID 描述符是配对时缓存的)。
如果 App 被系统杀掉(后台清理 / 强制停止),被控端不会自动把「输入设备」连回来:在蓝牙设置里点一下手机名字,或者用 App 里的「设备 → 切换」。

PhoneKB v0.36.2 — 媒体快进/快退键 + 手柄摇杆卡死修复

Choose a tag to compare

@linxun314 linxun314 released this 03 Nov 14:57

v0.36.2 — 媒体快进/快退键 + 手柄摇杆卡死修复

只介绍当前这一代(v0.36.2)。

这一版修的两件事

1. 媒体页 −10s / +10s 只做快进 / 快退

  • 两颗宽键现在发 ← / → 方向键:点一次退/进 10 秒,按住则连续快退/快进。
  • 去掉了原来的「上一段 / 下一段」行为,以及「更多设置 → 媒体页 ±10s 键发什么」这个档位开关 —— 行为固定,不用再选。
  • 抖音 / B 站这类 App 认方向键做 seek,所以能真正拖动进度。

2. 手柄页摇杆「玩久了卡住」

  • 极速模式不重绘:以前极速模式(少震动 / 移动中不重绘)开着时,摇杆轴值在变、但旋钮画面完全不刷新,看着就像卡住。现在摇杆移动只重绘旋钮那一小块,跟手且不牺牲流畅度。
  • 触控板抢事件:手柄页「触控板」浮层打开时会把所有 MOVE 事件吞掉,摇杆轴值停在最后一次位置(人物一直朝一个方向走)。现在按手指分流 —— 触控板只处理自己那根手指,其它手指继续控制摇杆,两者可以同时用。
  • 顺手修掉两个小隐患:触控板起始时硬编码用第 0 根手指(现在用真实按下序号,非第一根手指也能拖);正在追踪的手指失效时立刻复位摇杆。

顺带保留的上一版改动(v0.36.1)

  • 手柄页「触控板」浮层右侧的 ↑ ↓ 滚动键:以前只画没做触摸判定,点上去被当成移动指针;现在上半上滚、下半下滚,按住连发,按下的半边高亮。

下载

文件 适用
PhoneKB-0.36.2.apk 手机端(Android 9+,免 root,481 KB)

平板不用装任何东西 —— 纯蓝牙 HID,被控端零安装、免配置。

如果 App 被系统杀掉(后台清理 / 强制停止),平板不会自动把「输入设备」连回来:在平板蓝牙设置里点一下手机名字连接,或者取消配对后重新配对。

PhoneKB v0.36.1 — 手柄页触控板浮层上下键修复

Choose a tag to compare

@linxun314 linxun314 released this 03 Nov 11:54

v0.36.1 — 手柄页触控板浮层的上下键修好了

只介绍当前这一代(v0.36.1)。

这一版

  • 手柄页「触控板」浮层右侧的 ↑ ↓ 之前只画出来、没有触摸判定,点上去会被当成按在触控区,只是移动指针。现在:上半 = 上滚、下半 = 下滚,按下立刻滚一格,按住 220 ms 后每 110 ms 连发,按下的半边会高亮,抬手 / 手势取消 / 关掉浮层都立刻停。
  • 步长沿用触控板页里的「滚轮速度 N 行」设置。

这一代顺带清掉的东西(不再需要平板伴侣)

  • 移除 WiFi 伴侣整条通道:伴侣页、二维码配对、TCP 长连接、平板伴侣 APK、无障碍文字注入、剪贴板同步、WiFi 亮度、语音输入全部删掉。原因是每次都要扫码配对、平板还要常开无障碍服务,识别出的文字还会混进搜索框的预搜索内容。
  • 现在只有一条通道:纯蓝牙 HID,被控端不装任何 App。安装包 713 KB → 481 KB,零第三方依赖。
  • 配对弹窗不再显示 MIUI 的占位符「本机」;帮助与文档只描述当前版本。
  • 中文输入回到平板自己的输入法(蓝牙键盘只发按键码,这是 HID 的边界)。

下载

文件 说明
PhoneKB-0.36.1.apk 手机端,Android 9+,免 root

平板不用装东西:平板蓝牙里连上手机,就能当键盘 / 触控板 / 媒体键 / 手柄用。

App 被系统清理后,平板不会自动把「输入设备」连回来 —— 到平板蓝牙里点一下这台设备,或者取消配对后重新配对一次即可。

v0.25.0 — 指针灵敏度 + 手柄三布局

Choose a tag to compare

@linxun314 linxun314 released this 02 Nov 09:29

v0.25.0 — 指针灵敏度 + 手柄三布局

手机端 0.25.0(versionCode 39)· 伴侣 0.4.0(versionCode 4)

新增

  • 指针灵敏度:触控板页左上角「灵敏度 1.0x」胶囊 → 指针速度 0.4×–2.5× 无极滑块(慢/标准/快预设)、加速度开关、滚轮 1–6 行;对触控板页 / 单手遥控台 / 键盘页触控板浮层 / 手柄页触控区同时生效,改完立即生效并记住,不需要重新配对
  • 手柄三种布局:浮键 / 皮肤(Xbox 式整机 + 白圆环 + LB/LT/RB/RT + 双摇杆)/ 自定义,切换立即生效并记忆,横竖屏各存一套
  • 真模拟摇杆:L/R 摇杆输出四轴(-127..127),同时新增 LT/RT 键(描述符变了,需要在平板「忘记设备 → 重新配对」一次)
  • 自定义布局编辑器:设置里点「编辑布局」或长按空白约 3 秒,蓝色虚线框拖动即存,顶部「重置 / 完成」
  • 手柄页触控板:中间空白可当触控板(关 / 中间 / 全屏),可选「完整」或「只移动」,另有可拖动位置的触控板浮层(带 返回/主页/后台)

修复

  • 离开手柄页自动退出编辑模式(不再残留虚线框)
  • 触控区优先接管落在它上面的触摸,长按不再误触下层按键
  • 媒体页亮度键:vivo/iQOO 等忽略蓝牙键码的平板走 WiFi 伴侣调系统亮度

下载

文件 装在哪
PhoneKB-0.25.0.apk 手机(Android 9+)
PhoneKB-Companion-0.4.0.apk 平板(可选,中文/剪贴板/亮度)

升级提示:若手柄摇杆或 LT/RT 无反应,请在平板蓝牙设置里「忘记设备」后重新配对一次。

PhoneKB v0.23.4

Choose a tag to compare

@linxun314 linxun314 released this 02 Nov 05:57

手柄页浮层按钮重新配比

  • 右侧 ↑ / ↓ 滚动条变短:从原来几乎占满整条边,改成 52×104dp 的短条(两个方向键各 52dp 高),不再和下面三个键抢位置。
  • 底部 返回 / 主页 / 后台 加高:每个从 26dp 加到 34dp,间距 6→8dp,字号 11→13sp —— 拇指更容易命中,这三个键本来就是最常用的。
  • 其余不变:面板仍是 392dp 宽、贴满整个高度、右留 130dp,左上「⇔」把手、点外面收起、双指滑滚动(方向已反转)都照旧。

安装

文件 用途
PhoneKB-0.23.4.apk 手机端(Android 9+),覆盖安装即可
PhoneKB-Companion-0.4.0.apk 平板 WiFi 伴侣,本次未改动

PhoneKB v0.23.3

Choose a tag to compare

@linxun314 linxun314 released this 02 Nov 05:51

手柄页触控板浮层:改成「手柄面板」的样子

按你给的那张效果图改的:

  • 横屏尺寸:宽 392dp,从顶部一直铺到底边(上边 0dp、下边只留 10dp),不再是中间一小块。
  • 位置更居中:右边留 130dp,左边落在屏幕宽度约 40% 处 —— 触控区面积比之前大一圈,拇指横扫不用跨半个屏幕。
  • 左半屏照常可用:方向盘完整露在外面;右下角 ABXY 依旧露出大部分(Y/B 会被面板右边缘压住一点,和效果图一致)。
  • 右上角「触控板」小键不受影响,仍然一按开、一按关;点浮层外面收起(v0.23.2 起)。
  • 面板里的东西没变:左上「⇔」把手(长按后左右拖、松手记忆位置)、右下竖排 返回/主页/后台、右侧 ↑↓ 滚动列、双指滑=滚动(方向已按你要求反过来)。
  • 拖动把手时如果拖到最右,面板会自动往下让开自己的「触控板」小键,不会自己挡住开关。

竖屏暂时保持原样(232×400dp,贴右下),因为你这张效果图是横屏的。如果你也想让竖屏变成这种"整条面板"的样子,告诉我,我照同样思路改。

安装

文件 用途
PhoneKB-0.23.3.apk 手机端(Android 9+),覆盖安装即可
PhoneKB-Companion-0.4.0.apk 平板 WiFi 伴侣,本次未改动

PhoneKB v0.23.2

Choose a tag to compare

@linxun314 linxun314 released this 02 Nov 05:45

本次两个小改动

1. 点浮层外面就收起(改回 B 方案)

  • 手柄页的「触控板」浮层:点浮层外面的任何位置,浮层直接收起,手感和键盘页那个触控板浮层一致。
  • 收起时不会把这一下点击传给下面的手柄按键 —— 贴着方向盘/ABXY 点也不会误触发游戏按键。
  • 浮层左上角「⇔」把手(长按后左右拖动、松手记忆位置)保留不变。

2. 双指滚动方向反过来

  • 双指上下滑的滚动方向全部反转,跟你在触控板上的直觉一致。
  • 覆盖所有触控区域:手柄页浮层、触控板页、双手页的触控区、单手遥控台。
  • 侧边那对 ↑ / ↓ 滚动按键不受影响,按 ↑ 仍然是往上滚。

安装

文件 用途
PhoneKB-0.23.2.apk 手机端(Android 9+),覆盖安装即可
PhoneKB-Companion-0.4.0.apk 平板 WiFi 伴侣,本次未改动,继续用旧的即可

如果滚动手感还是反的(或者想改成"自然滚动"那种),告诉我一声,我可以做成设置里的一个开关。

PhoneKB v0.23.1

Choose a tag to compare

@linxun314 linxun314 released this 02 Nov 05:39

本次更新:手柄页触控板浮层 + 再降一次延迟

手柄页加「触控板浮层」

  • 右上角新增「触控板」小键(横屏在 R1 下一格;竖屏在顶部三键行最右)。点一下,右侧浮出一块触控板;再点一下收起。
  • 浮层不占满屏幕:横屏 360×313dp(右留 128dp)、竖屏 232×400dp(右留 40dp)—— 左半屏的方向盘和 ABXY 仍然看得见、按得到。
  • 点浮层外面不会收起:双手玩的时候不会误关;要关就再点一次右上角的「触控板」。
  • 浮层左上角有「⇔」把手:按住约 0.3 秒,然后左右拖动,就能把整块浮层挪到自己顺手的位置,松手自动保存(下次打开还在那儿)。拖动时把手变蓝,并提示「左右拖动 · 松手保存」。
  • 浮层右下角竖排 返回 / 主页 / 后台;原来的滚动 ↑↓ 列缩短到中段,两者不再打架。
  • 浮层里的手势和「触控板」页完全一致:单指移动 · 轻点=左键 · 双指点击=右键 · 双指上下滑=滚动。

再降一次延迟

  • 合并定时器改到独立线程(HandlerThread,URGENT_DISPLAY 优先级)。之前挂在主线程 looper 上,界面满负荷时每次合并都会被推迟一帧(最多 ~16ms)。
  • 首包 leading-edge:一串移动的第一个事件立即发出去,不再等 4ms 合并窗口。
  • 回放所有采样点:触控板(页面和手柄浮层)都改用 MotionEvent.getHistoricalX/Y,把系统批量合并掉的中间点全部还原 —— 快速拖动不再「少走一段」。

0.23.1 小修

  • 浮层里第二根手指按下时会被当成新的单指手势,导致「双指点击=右键」「双指上下滑=滚动」失效,已修好。

安装

文件 用途
PhoneKB-0.23.1.apk 手机端(Android 9+),覆盖安装即可
PhoneKB-Companion-0.4.0.apk 平板 WiFi 伴侣(中文输入 / 剪贴板),本次未改动,可继续用旧版

调试参数:--ei gptp 1 直接打开浮层、--ei gptpoff 110 模拟把浮层往左挪,方便截图与验证。

提示:方向键「偏一格」的老问题来自平板缓存的旧蓝牙描述符。根治办法是在平板上「忘记设备 → 重新配对」;暂时不想重配,可以在「手柄设置 → 方向键方向」里改成「修正一格」。