Skip to content
linxun314Public

About

把 Android 手机变成蓝牙键盘 / 触控板 / 媒体遥控器 / 游戏手柄:平板、电脑端零安装、免 root;附带 WiFi 伴侣解决中文输入与剪贴板同步。

Topics

Resources

Stars

22 stars

Watchers

0 watching

Forks

Repository files navigation

PhoneKB

手机当键盘用 —— 把 Android 手机变成蓝牙键盘 / 触控板 / 媒体遥控器 / 游戏手柄,平板和电脑零安装、免 root。

纯蓝牙 HID:被控端不装任何 App,手机端一个 APK 就是全部。

Release Downloads Build License Android

Turn your Android phone into a Bluetooth HID keyboard / trackpad / media remote / gamepad — the host device needs zero installation and no root.

实测组合:Redmi K40(Android 13 / HyperOS)→ iQOO Pad2(Android 14)。平板只做一次蓝牙配对,之后打开手机 App 就能用。

⬇️ 下载最新版 · 快速开始 · 功能 · 截图 · 常见问题 · 文档


当前版本 v0.42.0

这一版新增 / 打磨的内容(README 只介绍当前版本,旧版本说明不保留):

  • 手机九键(拼音)布局(v0.42.0):「切换布局」现在循环三档 —— 手机布局(26 键)→ 手机九键 → 电脑布局,选过的档位会记住。九键是 3×4 宫格,每格上面数字、下面小字是这一格的字母(2 abc / 7 pqrs);点一下格子会把这格的字母弹成一条,手指右滑到要的字母、抬手就发(不滑 = 第一个字母);按住格子约 0.42 秒直接发这一格的数字(打数字不用切页)。九键发的仍是普通字母键码,拼音转汉字还是平板/电脑自己的输入法

  • 键盘「点了没反应」修好了(v0.41.0):键盘报文是边沿报文(按下一条、抬起一条),以前队列「每个 id 只留最新一份」,快按时抬起会把还没发出去的按下覆盖掉 → 那一下整条丢失。现在键盘 / 媒体键走先进先出队列,3 次快速点按实测出 6 条报文(修前只有 3 条)

  • 点击带 9 dp 容差(v0.41.0):手指落在键缝里也能点中(9 dp 内找最近的键接管);按住后轻微抖动不再立刻抬键;同一个键 30 ms 内重复触发会被去抖

  • 顺带修掉「HID 注册被系统回收」(v0.41.0):启动时主界面和保活服务各调用一次注册,第二次会把第一次踢掉,日志上 registered=true → 65 ms 后 false → 最后卡在「HID 注册被拒绝」。现在 1 秒内只注册一次,注册后稳定 state=3 | 已连接

  • 「抓取拖动」这个功能已撤销(v0.40.7):v0.40.6 加的光圈 /「抓」胶囊 / 强制震动 / 200–500 ms 阈值档位全部退回 v0.40.5 的样子(阈值仍是 250 / 350(默认)/ 450 ms)。原因:真机上按住确实发了鼠标左键,但拖不动桌面内容,功能没有实用价值,按反馈整块撤掉。想把「拖桌面图标」做成真的能拖,得另走一条路(平板装伴侣 App、用无障碍发真实触摸),要单独做

  • 媒体页回到简洁样子(v0.40.6):按你的要求,v0.40.4 加的「上一段 / 下一段发送」整行(含 v0.40.5 的「滚轮爆发」)整段移除,媒体卡回到 ⏮ ⏯ ⏭ + −10s / +10s,横屏也不再因为多一行而变高。实测四档(媒体键 / 方向键 / PageUp / 滚轮爆发)都无法让红果 / 抖音这类整页视频列表翻页,问题在被控端 App 的翻页判定

  • 按住白滑块时上下键彻底不响应(v0.40.2):上一版还有个小尾巴 —— 手指刚按到滑块那一下,仍会先发一格滚轮、并把箭头闪一下。这一版把「抓滑块」这条路完全静音:一个滚轮报文都不发、箭头一点不提亮、也不进入按住连滚,只有你真的滑动满一格才开始按格发(完全跟手);点上下箭头 / 点轨道空白的行为一点没变。想滚一格就点箭头,想跟手拖就抓滑块,两条通道互不打扰

  • 只有抓住滑块才跟手拖动(v0.40.1):手指按在那根白滑块上才算「抓住」,上下拖才是跟手滚轮;点上下箭头 / 点轨道空白只滚一格,滑块一动不动(停在中间、不变白),按住不动照旧连续慢滚 —— 原来点箭头时滑块会「嗖」地跳上去再弹回来,现在不会了。抬手惯性也只在抓滑块时生效

  • 触控板右侧换成 macOS 风格的滚动条(v0.40.0):整列变成一块磨砂胶囊轨道 + 一根常驻的 30 dp 白滑块(中间三条细纹)+ 上下细箭头(没有文字,一眼看出是滚轮)。点箭头 / 点轨道 = 滚一格(滑块不动),按住 = 连续慢滚,只有按在滑块上不抬手上下拖才是跟手的鼠标滚轮(v0.40.1);抓住时滑块变白变大一圈跟着手指走。横屏这一列很宽时轨道固定最宽 56 dp 居中(命中区仍是整列)。滚轮报文改成平滑队列(默认 10 ms 一格,可选更顺 8 ms),不再一抽一抽;震动每 8 格一次、可关

  • 触控板「跟手的滚轮条」(v0.39.2,v0.40.0 已换成 macOS 胶囊滑块):点一下箭头还是滚一格,按住还是连续滚,按在滚动列上不抬手上下拖就是鼠标滚轮;灵敏度(慢 24 / 中 16 / 快 10 dp)与抬手惯性在「指针灵敏度」弹窗里调,不受「触控板手势」总开关影响

  • 触控板上下键按住 = 连续但慢速(v0.39.1):点一下还是一格;按住 150 ms 后才开始连滚,默认 180 ms 一格(约一秒 5–6 格),在「指针灵敏度」弹窗里可选 慢 / 中 / 快(快 = 以前的 70 ms)

  • 触控板变成「笔记本触控板」(v0.39.0):新增 点按拖动(刚点完再按住就能拖)、拖拽锁定(松手后左键还按着,下次点击才放下)、惯性滚动(甩一下继续滑)、自然滚动方向、边缘续推、误触抑制(手掌贴屏不乱跳)、捏合 = Ctrl+滚轮;平板模式加了 双指右滑=返回、三指下滑=主页、三指上滑/左右=多任务(那颗可配置的中键在 v0.40.3 已删);电脑模式加了 双指横滑=Shift+滚轮、双指右滑=后退·左滑=前进(Alt+←/→)、三指上=任务视图·下=显示桌面·左右=切窗口、四指左右=切虚拟桌面。每一项都在「帮助 → 更多设置 → 触控板手势」里独立开关,触控区左上角还有一颗 「手势 开 / 关」胶囊一键全关

  • 手柄每个键都能改成别的功能(v0.38.0):手柄设置 →「按键映射」,14 个物理键(方向、ABXY、L1/R1/LT/RT、SELECT/START)随便挑一个,改成 不发送 / 手柄按键 / 方向键 / 键盘键(Esc、Tab、空格、WASD、方向键、数字、Shift、Ctrl…)/ 鼠标左中右 / 媒体键;三套配置给不同游戏用,「恢复默认」只重置当前这套。面键布局可选 Xbox / PS / Switch(只换印字和 A/B、X/Y 位置,与映射互不冲突)。某个游戏不认 A 键?把 A 改成「键盘 空格」或「鼠标 左键」立刻能用

  • 电脑上玩「只认 Xbox 手柄」的游戏(奥日等)有了官方解释(v0.37.8):Windows 只把手机当「通用 HID 游戏控制器」(DirectInput),而奥日、绝大多数 3A 只枚举 XInput(Xbox) 设备,所以游戏里根本列不出这个手柄 —— 不是按键没发出去,是协议差异,App 侧改不了。用 Steam 中转即可:Steam → 设置 → 控制器 → 打开「通用手柄配置支持」→ 通用手柄「测试设备」里按键确认 → 右键游戏 → 属性 → 控制器 →「启用 Steam 输入」;这套说明已写进 App 帮助和 docs/使用说明.md(本版只有文案与文档变化)

  • 已连接的那台可以「断开」(v0.37.7):设备列表里只有真连着的那一行多一个红色「断开」按钮,点一下断开、并且暂停一切自动重连(自动重连 / 冷启动回连 / 抢连守护),那一行立刻变回「切换」随时连回来;点「切换」或重启 App 后自动重连恢复

  • 顶栏重排(v0.37.6):电源键右边的 「设备」 换成带手机图标的蓝描边大按钮;「平板」「电脑」折成一个按钮(按钮上写当前模式,点开是两项菜单);「旋转」从「更多」里拿出来一直露在页签行右端;删掉「单手」页签(页签固定 5 个);设备列表的类型角标换成手机 / 显示器 / 电视线稿图标

  • 电脑模式:手机现在也能当 Windows 电脑的键盘。顶栏的「平板 / 电脑」折叠按钮,电脑模式走同一条蓝牙 HID 通道 —— Windows 10 / 11 自带蓝牙键鼠驱动,电脑端不用装任何软件

  • 电脑模式的键盘快捷键条换成 Windows 常用键:Ctrl+C / Ctrl+V / Win / Win+D / Alt+Tab / 截屏(Win+Shift+S) / 锁屏(Win+L);媒体页常用键换成 截屏 / 任务视图(Win+Tab)/ 锁屏 / 菜单(Shift+F10) + 音量与播放键

  • 触控板、滚轮、鼠标左中右键、手柄在电脑模式下完全一样(Windows 认成标准 HID 键鼠 + HID 游戏控制器),状态栏会显示「平板模式 / 电脑模式」和电脑名,配对弹窗按模式给不同步骤

  • 竖屏拉伸条:竖屏键盘页可以在快捷键条与键盘之间拖动分隔条调键盘高度,触控板页 / 媒体页拖动顶部分隔条调功能区高度,双击恢复默认

  • 断开后不再无限重连(v0.37.1):最多重试 8 次(3 s 起、每次 +3 s、封顶 30 s),失败就明确写「连不上平板 / 平板没有响应」,点状态文字立刻重试;冷启动会自动连回上次那台设备,配对被删时直接提示重新配对

  • 设备切换:不用再取消配对就能换机器(v0.37.5)。顶栏电源键右边的 「设备」 打开已保存设备列表(手机 / 显示器图标 + 名称 + 上次连接时间),点「切换」就断开当前、连上目标,约 1–2 秒;已配对过的设备不需要重新配对。「更多设置 → 设备抢连守护」默认开:切到电脑后平板自己连回来会自动切回电脑。注意 Android 的 HID 外设同时只能连一台主机,这是「一键切换」不是「同时连两台」

  • 触控板更跟手了(v0.37.4):以前两帧间隔 ≥2 ms 就发一份报文,手指快划时一秒发四五百份,而蓝牙 HID 通道大约只吃 90 份/秒 —— 多的全在栈里排队,光标越滑越落后。现在按节奏发(默认 9 ms ≈ 111 份/秒,领先边缘立刻发、中间移动合并不丢步),「更多设置 → 指针上报节奏」可选 2 / 6 / 9 / 12 ms,延迟弹窗还会显示实际「节奏 N 份/秒」

  • 手柄在 Windows 上「某个键一直亮」修好了(v0.37.2):十字键的方向位以前混进了按钮字段(Windows 按顺序数按钮,于是变成「按钮 1–4」),加上复位报文长度不对、离开手柄页不发归零 —— 现在方向只走 hat、复位发完整报文,离开手柄页 / 切页面 / 进后台都会自动全松

  • 版本:手机端 0.42.0(versionCode 83);安装包 521 KB

30 秒了解

你想要的 PhoneKB 怎么做
用手机给平板打字、按快捷键 手机注册成标准蓝牙键盘,平板把它当普通蓝牙键盘用,平板不装 App
用手机当鼠标 触控板 + 物理左/中/右键,支持点击、点按拖动、拖拽锁定、惯性滚动、双指滚动/右键、三指四指手势,速度可调(含加速度)
躺床上刷视频、拖进度、切歌、调音量、调亮度、截屏 媒体页:上一段 / 播放暂停 / 下一段、−10s / +10s 快退·快进(可按住连发)、音量 ± / 静音 / 亮度 −/+ / 截屏 / 多任务 / 返回主页菜单
用手机控制 Windows 电脑 顶栏切到电脑模式:同一套蓝牙 HID,Windows 免安装就认成键盘 + 鼠标 + 手柄,配 Win / Win+D / Win+Shift+S / Win+L 等常用组合
手机当手柄玩模拟器 手柄页:浮键 / Xbox 式皮肤 / 自定义三种布局,移动盘(十字键 / 圆盘 / 模拟摇杆)+ ABXY + L1/R1/LT/RT + SELECT/START + 双模拟摇杆,大小可分别无级调节
键盘 触控板
键盘 触控板

功能

  • 蓝牙 HID,一装一配:手机端一个 APK,被控端只需蓝牙配对,不装软件、不 root
  • 电脑模式:顶栏「平板 / 电脑」折叠按钮一键切换被控设备。电脑模式走同一条蓝牙 HID,Windows 免安装;键盘快捷键条变成 Win / Win+D / Alt+Tab / Win+Shift+S 截屏 / Win+L 锁屏,媒体页常用键变成 截屏 / 任务视图 / 锁屏 / 菜单(Shift+F10),其余页面行为不变
  • 键盘:手机布局 / 电脑布局两套,含符号页、Ctrl+C/V/X/A、Alt+Tab、方向键
  • 触控板:单指移动 · 点击左键 · 双指滚动 · 双指点击右键;底部 返回 / 主页 / 后台 三颗键;右侧是 macOS 风格滚动条(v0.40.0:磨砂胶囊轨道 + 30 dp 白滑块三条细纹 + 上下细箭头),点一下一格 / 按住连续慢滚 / 不抬手上下拖 = 跟手滚轮;一键弹出浮层数字键盘 / 浮层键盘 / 浮层触控板
  • 触控板手势(v0.39.0):点按拖动 · 拖拽锁定 · 惯性滚动 · 自然滚动方向 · 边缘续推 · 误触抑制 · 捏合缩放;平板模式 双指右滑=返回、三指下滑=主页、三指上滑/左右=多任务;电脑模式 双指横滑=横向滚动、双指右滑=后退、三指上=任务视图/下=显示桌面/左右=切窗口、四指左右=切虚拟桌面。全部可在「更多设置 → 触控板手势」单独开关
  • 指针灵敏度:0.4×–2.5× 无极滑块 + 慢/标准/快预设 + 加速度开关 + 滚轮 1–6 行 + 上下键按住滚动 慢/中/快 + 滚轮条灵敏度 · 抬手惯性 · 顺滑度(10 / 8 ms)· 震动开关,四处触控面统一生效
  • 媒体键:媒体卡 ⏮ 上一段 / ⏯ 播放暂停 / ⏭ 下一段(按住连发)+ 两颗宽键 −10s / +10s,发 ← / → 方向键,点一次退 / 进 10 秒、按住连续快退·快进;功能键卡两排 5 个圆键:音量 + / 音量 − / 静音 / 截屏 / 多任务、亮度 − / 亮度 + / 返回 / 主页 / 菜单
  • 触控延迟优化:一帧历史采样全累加、合并窗口 2 ms、极速模式(移动中不重绘不震动)、点击方式「抬手 / 按下即点」、长按拖拽 250/350/450 ms 可调;「更多设置」里可读指针延迟 p50/p95(实测 age p50=8 ms / p95=10 ms,App 侧发送成本 p50=2 ms)
  • 游戏手柄
    • 三种布局:浮键(左下移动盘、右下 X/Y/A/B、两侧肩键、顶部 SELECT/START,中间留空不挡画面)/ 皮肤(整块 Xbox 式机身 + 白色圆环 + 双摇杆)/ 自定义(任何按键都能拖,横竖屏各存一套)
    • 移动盘三种形态:十字键 / 圆盘(按住滑动选 8 方向、扇区高亮、松手回中)/ 摇杆(真模拟摇杆,摇杆头跟手,输出 X/Y 轴;可开「摇杆同时发方向键」兼容只认方向键的老模拟器)
    • 大小:移动盘 与 按键(ABXY / 肩键 / 菜单键) 各一个 60%–200% 无级滑块,滑块下方显示「本屏实际 N%」(屏幕放不下时如实钳制),立即生效并记忆
    • 大键模式:隐藏肩键 / 摇杆 / 菜单键,只留方向盘与 ABXY —— 横屏左右贴边、竖屏上下竖排,按键可放到接近满屏
    • 右摇杆轴向可选 RX/RY 或 Z/RZ(选 Z/RZ 需在平板上忘记设备后重新配对一次)
    • 输入:ABXY + L1/R1/LT/RT + SELECT/START + L/R 模拟摇杆(四轴),支持多指同时按
    • 触控板:中间空白可当触控板(关 / 中间面板 / 整片空白),手势与触控板页一致,可选「只移动」不点击;另有可拖动位置的触控板浮层(带 返回/主页/后台),左半屏按键照常可用
    • 按键映射:设置 →「按键映射」,14 个物理键任意改(不发送 / 手柄按键 / 方向键 / 键盘键 / 鼠标左中右 / 媒体键),三套配置 + 面键布局 Xbox / PS / Switch,给「某个游戏不认某个键」兜底
    • 排错:设置里有「方向键方向 · 修正一格」开关,旧配对导致方向整体偏一格时可临时纠正;震动反馈可关
  • 双手模式:左侧触控区 + 右侧按键板,页签行右端的「互换」一键对调左右/上下并记忆
  • 设备切换:顶栏「设备」列出已保存的主机(手机 / 显示器 / 电视图标区分类型),点「切换」就断开当前、连上目标,已配对设备无需重新配对;「设备抢连守护」默认开
  • 横竖屏自适应:横屏紧凑工具栏 + 沉浸全屏;「旋转」键常驻页签行,强制横/竖屏(长按恢复跟随系统)
  • 自适应界面:以 393dp 为基准按屏幕宽度与系统字体缩放,顶栏实在放不下时才把帮助等收进「更多」(「旋转」始终在页签行);帮助 →「界面大小」可选 自动 / 小 / 标准 / 大
  • 比例可调:键盘页(触控区 / 键盘)、触控板页与媒体页(功能区 / 留空区)都能拖动调节、双击复位并记忆
  • 稳定连接:前台服务保活、HID 断连自动重新注册、内置配对引导与排错帮助

一条通道:蓝牙 HID

        ┌────────────────────────────┐
        │     平板 / 电脑 / TV        │
        │    (被控端,零安装、免 root)│
        └──────────▲─────────────────┘
             蓝牙 HID 键鼠 / 媒体 / 手柄
        ┌──────────┴─────────────────┐
        │        Android 手机         │
        │          PhoneKB            │
        └────────────────────────────┘

手机把自己注册成标准蓝牙键盘 + 鼠标 + 媒体控制器 + 手柄,被控端系统直接认成外设,所以:

  • 不需要 在被控端装 App、开调试、给权限,也不需要 root
  • 不需要 连同一个 WiFi,纯蓝牙即可
  • 中文输入用被控端自己的输入法(外接键盘的身份,任何输入法都正常)

截图

电脑模式(控制 Windows 电脑)

键盘(Win 快捷键条) 媒体(截屏 / 任务视图 / 锁屏) 触控板
电脑模式键盘 电脑模式媒体 电脑模式触控板
竖屏键盘(电脑模式) 电脑模式 · 竖屏触控板 电脑模式 · 手柄
电脑模式竖屏键盘 电脑模式竖屏触控板 电脑模式手柄

设备切换(换平板 / 电脑不用重新配对,类型用图标显示)

竖屏 · 设备列表(底部面板) 横屏 · 设备列表(居中卡片)
设备列表竖屏 设备列表横屏

当前连着的那一行多一个「断开」(v0.37.7)

已连接(右侧红色「断开」) 断开之后(都变回「切换」)
断开按钮 已断开
键盘(电脑布局) 键盘(手机布局) 数字键盘浮层
电脑布局 手机布局 数字键盘
媒体 手柄(皮肤布局) 双手模式
媒体 手柄 双手
手柄(竖屏皮肤) 手柄设置 数字键盘 / 触控板浮层
手柄竖屏 手柄设置 手柄触控板

手柄按键映射(v0.38.0)

按键映射(14 个键 + 三套配置 + 面键布局) 单个键的 46 个可选目标 横屏同样是整块可滚动
按键映射 目标选择 横屏映射

触控板 macOS 风格滚动条(v0.40.0 / v0.40.1 / v0.40.2)

竖屏滚动条(磨砂轨道 + 白滑块三条细纹) 抓住滑块拖动(变白变大) 横屏(轨道固定 56 dp 居中)
滚动条竖屏 滚动条按住 滚动条横屏
点箭头(v0.40.1:箭头提亮、滑块留在中间不动) 抓住滑块(v0.40.1:滑块跟手走、变白变大)
点箭头 抓住滑块
抓住滑块(v0.40.2:滑块变白变大,上下箭头一点不提亮、也不发滚轮) 拖动中(v0.40.2:滑块跟手、箭头同样保持暗)
抓滑块箭头暗 拖动箭头暗

键盘(v0.41.0:按键容差 9 dp + 键盘报文保序,快按不再丢字)

竖屏键盘页(手机布局) 横屏键盘页
键盘竖屏 键盘横屏

手机九键(v0.42.0:3×4 宫格,点格子弹字母、右滑选字母、按住发数字)

竖屏九键 字母条弹出(b 高亮) 横屏九键
九键竖屏 字母条 九键横屏

触控板(v0.40.7:抓取拖动已撤销,回到 v0.40.5 的样子)

竖屏触控板 横屏触控板
触控板竖屏 触控板横屏
更多设置:长按拖拽阈值回到 250 / 350(默认)/ 450 ms
长按阈值

媒体页回到简洁样子(v0.40.6):chip 行已移除

竖屏媒体页 横屏媒体页
媒体页竖屏 媒体页横屏

触控板底部「上一集 / 下一集」(v0.40.3 的样子,v0.40.4 已撤回到三颗键)

竖屏(返回 / 主页 / 后台 / 上一集 / 下一集) 按下「上一集」(发方向键 ↑) 横屏
翻页键竖屏 上一集按下 翻页键横屏

滚轮条顺滑度 / 震动设置(v0.40.0)

指针灵敏度弹窗:顺滑度 标准 10 ms · 震动 开
顺滑度设置

触控板手势(v0.39.0)与上下键按住滚动(v0.39.1)

竖屏触控板(手势胶囊 + 四格导航) 手势设置(14 项独立开关) 横屏触控板
触控板竖屏 手势设置 触控板横屏
上下键按住滚动(慢 / 中 / 快) 横屏手势设置 横屏触控板
按住滚动 横屏手势设置 横屏触控板

| 竖屏顶栏(设备 / 模式 / 旋转) | 横屏顶栏(同一套) | 平板 / 电脑折叠菜单 | |---|---|---|---| | 竖屏顶栏 | 横屏顶栏 | 模式菜单 |

竖屏键盘 指针灵敏度入口 指针灵敏度设置
竖屏键盘 灵敏度胶囊 灵敏度弹窗
竖屏触控板 界面大小 手柄(浮键 · 竖屏)
竖屏触控板 界面大小 手柄浮键竖屏

更多截图见 docs/screenshots/。

下载与安装

从 Releases 下载:

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

安装提示:Android 13+ 首次安装需允许「此来源的应用」;首次运行请允许通知权限(前台服务保活,否则后台会被系统回收导致蓝牙断开)。

快速开始

  1. 手机装 PhoneKB 并打开,顶部状态显示「等待配对 / 已连接」
  2. 点右上角「配对」,按提示让手机蓝牙处于可被发现状态
  3. 在被控设备上配对:打开平板/电脑的蓝牙设置 → 搜索手机蓝牙名称 → 配对(Windows:设置 → 蓝牙和其他设备 → 添加设备 → 蓝牙);回到 App 看到「已连接 · 设备名」即可使用
    • 控制 Windows 时先在顶栏点那个写着「平板 ⌄ / 电脑 ⌄」的按钮选「电脑(Windows)」,控制平板/手机选「平板(Android)」,选择会被记住
graph LR
  A[手机打开 PhoneKB] --> B[点「配对」]
  B --> C[平板蓝牙搜索手机名]
  C --> D[配对成功]
  D --> E[顶部显示「已连接」]
  E --> F[键盘 / 触控板 / 媒体 / 手柄]
Loading

连上了但按键没反应? 在手机蓝牙设置里删掉该设备的配对,再从 App 的配对引导重新走一次(HID 需要正确的配对流程)。换了新版本如果手柄摇杆 / LT / RT 没反应,同样需要「忘记设备 → 重新配对」一次(HID 报告描述符更新过)。更多排错见 docs/使用说明.md。

应用被系统杀掉后平板不自动重连? 杀掉 App 等于注销了 HID 外设,平板只会在已配对列表里保留记录、不会自动把「输入设备」连回来。回到 App 后到平板蓝牙里点一下这台手机即可(必要时「取消配对」再重新配对一次)。

手势与快捷键速查

触控板 操作
移动光标 单指滑动(速度可在左上角「灵敏度」里调)
左键 单指点击
右键 双指点击
上一集 / 下一集 媒体页卡顶「上一段 / 下一段发送」选 方向键 ↑↓ 后,⏮ ⏭ 变成「上一集 / 下一集」(按住连续切);选 PageUp 是「上一页 / 下一页」;选 滚轮爆发 是「上一屏 / 下一屏」(一次连发多格滚轮,红果 / 抖音整页视频靠它翻页)
手势 点按拖动、拖拽锁定、惯性滚动、双指/三指/四指手势(见「更多设置 → 触控板手势」)
拖拽 按住底部「左键」再用触控区移动
键盘 说明
切换布局 顶部「切换布局」:手机布局 / 电脑布局
符号 手机布局左下角「符号」页,ABC 返回
快捷键 Ctrl+C / Ctrl+V / Ctrl+X / Ctrl+A / Alt+Tab 专用键
浮层键盘 / 数字键盘 触控板页左侧「键盘」「数字」按钮随时呼出
手柄 说明
换布局 / 大小 / 类型 左上「移动盘」→ 手柄设置,或右上齿轮
拖动按键位置 设置里「编辑布局」,或长按空白约 3 秒;顶部「重置 / 完成」
中间当触控板 顶部「触控」小键切 关 / 中间 / 全屏;黑底浮层可拖动位置

兼容性

角色 要求
手机(控制端) Android 9(API 28)及以上;系统保留 Bluetooth HID Device profile(少数厂商 ROM 会屏蔽,App 会检测并提示)
被控端 支持蓝牙键盘/鼠标的设备:Android 平板/手机、Windows、macOS、Linux;iPadOS 13+ 理论支持(未实测)
界面适配 以 393dp 为基准自动缩放,约 320–480dp 宽度、系统字体 0.85–1.3 倍下均可用

为什么不用投屏 / 远程桌面?

方案 延迟 被控端安装 能打字/用快捷键 适合场景
PhoneKB(蓝牙 HID) 极低(HID 事件) 不需要 系统级键盘,任何 App 都能输入 打字、快捷操作、演示、躺床操作
scrcpy / 无线投屏 中(视频编码) 需要开 USB/无线调试 部分 需要看屏幕、精细操作
远程桌面类 App 较高 两端都装 部分 完整桌面操控

PhoneKB 不传输画面,只把手机当外设,所以延迟低、被控端干净;需要看屏幕时仍可配合投屏使用。

隐私与权限

  • 手机端权限:只有 蓝牙(HID 必需)和 通知(前台服务保活);不需要网络、存储、通讯录、位置、麦克风、相机
  • 没有服务器、没有账号,不采集也不上传任何数据,所有配置只保存在本机 SharedPreferences

构建

Gradle(Android Studio 用户)

./gradlew assembleDebug        # Windows: gradlew.bat assembleDebug

产物:app/build/outputs/apk/debug/app-debug.apk。需要 JDK 17+、Android SDK Platform 36。

命令行(不装 Android Studio,Windows)

powershell -ExecutionPolicy Bypass -File tools/build.ps1 -Clean -VersionName 0.42.0 -VersionCode 83

脚本直接调用 aapt2 → javac → d8 → zipalign → apksigner,产物在 build/。设备没有 adb 时,可用 node tools/serve-apk.js 起一个局域网下载页(端口 8000)。

GitHub Actions

仓库自带 CI(build.yml),push / PR 自动构建 debug APK 并上传 Artifacts。发布流程见 docs/发布指南.md。

项目结构

app/src/main/java/com/phonekb/          手机端
  MainActivity.java      页面框架、顶栏、浮层、设置记忆
  HidManager.java        BluetoothHidDevice 封装:注册、连接、报文发送
  HidConstants.java      HID Report Descriptor 与键值常量
  KeyboardView.java      键盘页(两套布局 + 符号页)
  TouchpadView.java      触控板页(手势 / 滚动 / 按键)
  PadController.java     触控板手势判定
  ControlPadView.java    浮层数字键盘 / 键盘 / 触控板(含灵敏度入口)
  MediaView.java         媒体页
  GamepadView.java       手柄页(三布局 / 圆盘 / 摇杆 / 编辑 / 触控板)
  GamepadMap.java        手柄按键映射(14 物理键 × 46 目标 × 3 套配置 + 面键布局)
  TwoHandView.java       双手模式
  PointerSettings.java   指针灵敏度 / 滚轮 / 加速度设置
  SensitivityDialog.java 指针灵敏度弹窗
  KeepAliveService.java  前台保活服务
  ChromeBar.java / Ui.java / Icons.java  顶栏折叠、自适应尺寸、自绘图标
  IconView.java          小图标 View(设备类型角标、模式按钮的 ⌄ 等)
tools/build.ps1          无 IDE 构建脚本
tools/serve-apk.js       局域网 APK 下载页
docs/                    文档与截图

技术实现

  • 手机端用 BluetoothHidDevice(API 28+)注册复合 HID 设备,一个 Report Descriptor 内 4 个 Report ID:
    • 键盘:8 字节,6KRO + 修饰键
    • 鼠标:按键 + 相对位移 + 滚轮
    • Consumer Control:16 位 usage(媒体、音量、亮度、浏览器/主页/返回等)
    • Gamepad:hat + 16 个按键 + 4 个轴(X / Y / Rx / Ry,-127..127,摇杆用)
  • 全部 UI 为自绘 View(Canvas),蓝牙功能无第三方依赖(连 jar 都没有);自适应缩放、顶栏折叠也由自绘逻辑完成
  • 手势统一走 PadController;指针位移 = 手指数 × 1.7(基准)× 灵敏度,开启加速度时快扫最多再 ×1.9
  • 手柄低延迟:HID 报告在专用线程发送、鼠标/摇杆移动 4ms 合并上报(≈250Hz)
  • 前台服务保活,避免 Activity 被回收导致 HID 静默注销;注册失败自动重试

已知限制

  • 中文输入:蓝牙 HID 只发键码,汉字由被控端自己的输入法完成(手机端不做语音/上传,这也是 v0.36.0 移除 WiFi 伴侣后的取舍)
  • 光标外观:光标由被控端系统绘制,蓝牙鼠标只能发相对位移,无法改形状/大小;可在平板「辅助功能 / 鼠标」里调指针大小
  • 亮度键:多数 Android 平板/电视盒子响应 Consumer 亮度 usage,iQOO / vivo 等部分平板会完全忽略(属于被控端行为,App 无法绕过)
  • 截屏 / 多任务:走 PrintScreen / Alt+Tab,最终由系统决定,个别 App 可能拦截
  • 少数手机 ROM 禁用 HID Device profile,只能当主机用
  • 同一时间只能有一个 App 注册 HID 外设,装了其它 HID 类 App 需先停用
  • 旧配对缓存会保留旧的 HID 描述符:新增摇杆 / LT / RT 后需「忘记设备 → 重新配对」一次

常见问题

Q:平板需要 root 吗?手机需要 root 吗? A:都不需要。被控端甚至不需要装 App。

Q:为什么平板打不出中文? A:蓝牙键盘只能发送键码(和外接键盘一样),平板不会把手机上的拼音变成汉字。改用平板自己的输入法即可:拼音、语音、手写都能用,键盘照常打字。

Q:手机和平板需要连同一个 WiFi 吗? A:不需要。PhoneKB 只走蓝牙 HID。

Q:手柄摇杆 / LT / RT 没反应? A:这几项是后加的,HID 描述符变了,需要在平板蓝牙设置里「忘记设备」,再从 App 重新配对一次。

Q:电脑连上了,但奥日这类游戏里根本找不到手柄? A:Windows 只把它认成「通用 HID 游戏控制器」(DirectInput),而这些游戏只枚举 XInput(Xbox) 设备 —— 协议差异,App 改不了。用 Steam 输入中转:Steam → 设置 → 控制器 → 打开「通用手柄配置支持」→ 在「通用手柄 → 测试设备」里按手机上的键确认 Steam 收到 → 右键游戏 → 属性 → 控制器 →「启用 Steam 输入」;非 Steam 游戏先「添加非 Steam 游戏到我的库」。手边有真 Xbox 手柄的话,玩奥日直接用真手柄最省事。

Q:手柄方向键整体偏一格 / 按左出下? A:旧配对缓存的旧描述符导致。重新配对可根治;不想重配可在 手柄设置 →「方向键方向」改成「修正一格」。

Q:能控制 iPhone / iPad 吗? A:iPadOS 13+ 支持蓝牙键盘鼠标,理论上可配对使用(本仓库主要在 Android 平板实测,Apple 设备未实测)。

Q:能反向,用平板控制手机吗? A:不能。PhoneKB 的方向固定:手机是外设,被控端是主机。

Q:一次能连几台设备? A:HID 同一时间只保持一条连接;换设备时在系统蓝牙里切换即可,配对关系会保留。

Q:为什么不用 scrcpy 那种方案? A:那是「投屏 + 注入」,需要被控端开调试;PhoneKB 追求被控端零安装、系统级键盘、低延迟。两者可以互补。

Roadmap

  • 媒体页重做(截屏 / 多任务 / ±10s 长按连发)
  • 手柄三布局 + 十字键 / 圆盘 / 模拟摇杆
  • HID 绝对触控(数字化仪)模式:触控板 1:1 映射平板屏幕,点哪打哪
  • USB 通道(ADB 注入)
  • Apple 设备实测(iPadOS)与兼容性说明

参与贡献

Issues / PR 都欢迎。提交前请先看 docs/需求与进展.md(当前能力与待办)与 docs/使用说明.md。

文档

文档 内容
docs/使用说明.md 完整安装、配对、各页面操作、各平台注意事项、排错、卸载
docs/调试参数.md adb am start 调试参数(切页、模拟窄屏、浮层、灵敏度等)
docs/需求与进展.md 当前版本的能力清单、限制、待办
docs/验证记录.md 真机验证记录(Redmi K40 + iQOO Pad2)
docs/发布指南.md 建仓库、构建、打 tag、发布 Release
CHANGELOG.md 当前版本更新说明

致谢

实现前调研并参考了这些开源项目的行为与思路(本仓库代码为独立实现,未复制任何 GPL/AGPL 代码):

License

Apache-2.0 © linxun314


如果这个项目对你有用,欢迎点一个 ⭐ Star,让更多人看到。

About

把 Android 手机变成蓝牙键盘 / 触控板 / 媒体遥控器 / 游戏手柄:平板、电脑端零安装、免 root;附带 WiFi 伴侣解决中文输入与剪贴板同步。

Topics

Resources

Stars

22 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages