虚拟键盘 · 四种连接方式
虚拟键盘提供三种需要 Mac 端 eTouch 的方式:蓝牙、局域网和数据线;另有一个不需要 Mac 端的“通用蓝牙”实验室模式。可以随时在手机首页的“连接管理”里切换。
怎么选
- 蓝牙:最适合随身使用,不需要 Wi-Fi,带宽和延迟在三者中居中。首次需要 6 位配对码。
- 局域网:手机和 Mac 在同一个 Wi-Fi 时使用,Bonjour 自动发现,延迟低于蓝牙。首次需要 6 位配对码。
- 数据线:延迟最低、最稳定,不受 Wi-Fi 和蓝牙干扰。插上线后自动切换到 USB,不需要配对码。
- 通用蓝牙:手机直接作为标准蓝牙 HID 设备,Mac、Windows、Linux 和 iPad 都不需要安装配套程序;功能有限,默认关闭。
延迟从低到高依次是:数据线、局域网、蓝牙。
蓝牙
蓝牙使用 BLE 自定义 GATT 服务,手机作为外设,Mac 主动连入。
- 确认 eTouch 正在运行。
- 手机选择“蓝牙”。
- 在 Mac 菜单栏、eTouch 弹窗或主窗口读取 6 位配对码。
- 在手机上输入配对码。
配对成功后两端各保存一个令牌,以后启动会自动连回。配对码错误时会提示剩余尝试次数;配对码过期后可以点“重新获取配对码”,不用退出重来。
蓝牙连接间隔由 Mac 决定,手机只能请求低延迟。输入延迟通常在几十毫秒内;如果周围蓝牙设备很多,可能会略有波动。
局域网
局域网使用 TCP 45120 端口和 Bonjour 发现,手机作为客户端。
- 让手机和 Mac 在同一个 Wi-Fi 或同一个有线局域网。
- 手机选择“局域网”。
- 在“可连接的设备”里点选 Mac;已配对过的上次那台会自动连回。
- 首次连接输入 Mac 上显示的 6 位配对码。
如果 Bonjour 发现失败,检查“本地网络”权限、Wi-Fi 是否开启、VPN 或代理是否拦截了 mDNS,以及路由器是否开启了客户端隔离。也可以使用数据线,不需要依赖网络。
数据线
数据线通过 usbmuxd 建立本机 USB 隧道,再走与局域网相同的协议。它不需要 Wi-Fi、蓝牙或配对码。
- 用支持数据传输的线连接手机和 Mac。只充电的线不适用。
- 解锁手机;如果系统询问是否信任这台电脑,选择“信任”。
- 手机自动检测到 USB 连接并切换过去。
无线连接期间插上线,App 会立即从蓝牙或局域网切到数据线,复用已经建立的连接。拔线后如果 4 秒内没有重新连上,会回到切换前的无线方式并自动重连。手动选择过某种连接方式后,本次运行期间不会再被自动切回数据线;重启 App 后恢复“插线优先”。
通用蓝牙(实验室)
通用蓝牙使用标准 Bluetooth HID 服务,手机在目标设备看来是键盘、鼠标、媒体键和手柄等 HID 设备。它不经过 App 的私有帧协议,也不使用 eTouch。
- 在手机“设置 → 实验室功能”中打开“通用蓝牙”。
- 回到连接管理,选择“通用蓝牙”。
- 在 Mac、Windows、Linux 或 iPad 的蓝牙设置里连接名称类似
VK-<手机名>的设备。Mac 首次需要手动连接一次,之后才会自动重连。 - 已连接的主机可以在手机列表中切换为输入目标;同时连接多台时,输入默认发给“默认主机”。
通用蓝牙的功能限制:
- 剪贴板、听写、含非 ASCII 文字的文本键和部分未映射的媒体键不可用。
- 默认不声明横向滚动,部分主机因此无法横向滚动;可以在连接管理页打开“横向滚动”,这会重建鼠标 HID 服务并要求主机重新连接。
- 主机可能缓存旧的 HID 描述符。重装或重启 App 后如果显示已连接但收不到输入,先点“重新广播”;仍无效时在主机上关闭再打开蓝牙。
- 连接页提供“兼容 Android(不要求加密)”开关;关闭加密会降低安全性,只在确认主机不兼容时使用。
配对、重连与多设备
- 配对:蓝牙和局域网首次连接需要 6 位配对码;成功后保存令牌,之后自动重连。数据线链路建立即可信,不需要配对码。
- 自动重连:无线链路断开后按 1、2、4 秒递增退避,最长约 64 秒。局域网只自动连回上次使用的 Mac,其他 Mac 需要手动点选;蓝牙和数据线由 Mac 主动连入。
- 一台手机连多台 Mac:手机会记住多台已配对的 Mac,可以在目标行或连接管理页切换输入目标。切换时先抬起旧 Mac 上按住的键,避免残留按住状态。
- 一台 Mac 接多台手机:蓝牙、局域网和数据线三条 App 链路都可以同时接入多台手机,输入在 Mac 上合并;按键和鼠标按钮按引用计数合并,拖拽等手势由先开始的那台手机独占。
- 设备角色:设置中可以把手机限定为“仅键盘”或“仅触控板”,默认“自动”由当前页面决定。
加密与隐私
- 蓝牙 / 局域网:配对成功后使用令牌协商帧加密,输入内容不会以明文经过网络。
- 数据线:按设计保持明文,但只绑定手机回环地址,经 usbmuxd 隧道传输,同一 Wi-Fi 的其他设备无法连入。
- 通用蓝牙:走系统蓝牙配对与 HID,不经过 App 的帧加密;默认要求配对加密,可在连接页为兼容旧主机关闭。
- 所有连接都在手机和你的 Mac 之间直连,不经过 Flavor 服务器;Mac 端也不会上传输入内容。
已知限制
- 登录窗口和 FileVault 解锁界面不能使用,协议链路要在用户会话建立后才通。
- 手机切到后台、锁屏或被系统挂起会断开。
- 通用蓝牙必须保持前台亮屏;切到后台时手机会主动撤掉 HID 外设。
- 蓝牙和局域网需要 eTouch 运行;通用蓝牙不需要,但功能受限。