虚拟键盘 · 连接与排查
先按顺序检查这几项,大多数问题都能在这里定位:
- Mac 上的 eTouch 是否正在运行,菜单栏图标是否可见。
- Mac 是否已授予 eTouch“辅助功能”权限。
- 手机端是否允许蓝牙和本地网络权限。
- 手机 App 是否保持在前台并亮屏。
- 当前选择的连接方式是否与 Mac 端链路一致。
蓝牙连不上
- 确认 eTouch 正在运行;蓝牙链路由 Mac 主动连入,手机不能主动搜索 Mac。
- 在手机连接管理页点“重新连接”,或在 Mac 上关闭再打开蓝牙。
- 删除旧的配对记录后重新配对;重新配对需要 Mac 上显示的 6 位码。
- 如果周围蓝牙设备很多,先关闭暂时不用的设备,减少 2.4GHz 干扰。
- 蓝牙连接间隔由 Mac 决定;延迟突然变大时,检查 Mac 是否同时在使用蓝牙音频或大量外设。
局域网找不到 Mac
- 确认手机和 Mac 在同一个 Wi-Fi,且没有使用访客网络或开启客户端隔离。
- 检查手机“设置 → 隐私与安全性 → 本地网络”,确保虚拟键盘已打开。
- 关闭 VPN、代理或会拦截 mDNS 的安全软件后再试。
- 确认 eTouch 正在运行,Mac 防火墙没有阻止它。
- 局域网只自动连回上次使用的 Mac;其他 Mac 需要在“可连接的设备”里手动点选。
- 仍然找不到时,直接用数据线连接,绕过网络问题。
数据线没有反应
- 换一根支持数据传输的线;只充电的线不适用。
- 解锁手机;如果系统询问是否信任这台电脑,选择“信任”。
- 确认 Mac 上的 eTouch 正在运行。
- 插线后手机应自动从无线切到数据线;如果状态没有变化,在连接管理页手动选择一次数据线。
- 拔线后 4 秒内没有重新连上,App 会回到原来的无线方式;如果一直停在数据线,检查线缆和接口。
配对码问题
- 配对码显示在 Mac 菜单栏、eTouch 弹窗或主窗口,是 6 位数字。
- 输错时会提示剩余尝试次数;过期或次数用尽后,点“重新获取配对码”让 Mac 生成新码。
- 如果 Mac 上已经有旧的配对记录,先在手机“设置 → 连接 → 已配对设备”里移除,再重新配对。
Mac 收不到输入
按可能性检查:
- 辅助功能权限:打开“系统设置 → 隐私与安全性 → 辅助功能”,确认 eTouch 已打开;授权后如果仍无效,退出并重新打开 eTouch。
- 安全输入:密码框、sudo、系统授权面板或终端“安全键盘输入”开启时,macOS 会丢弃合成按键。键盘页会显示锁形提示;请改用 Mac 键盘或通用蓝牙模式。
- 登录窗口 / FileVault:这两种界面不支持,必须先完成登录。
- 前台状态:手机锁屏、切到后台或被系统挂起会断开;回到 App 后等待自动重连。
- 目标 Mac:同时连接多台 Mac 时,确认目标行指向正在使用的那台。
- 键盘页焦点:确认当前在键盘页而不是触控板页;键盘页有按键反馈但 Mac 无输入时,优先检查辅助功能和安全输入。
触控板不移动或手势不对
- 确认触控板页在前台,且没有误触系统边缘手势或 Home 条。
- 四指、五指手势需要足够的移动距离和时间;动作太快或幅度太小可能不触发。
- 不支持压感的机型请用“按住”拖动,不要期待轻压。
- 双指横滑默认是横向滚动;需要后退 / 前进时,在触控板设置中打开“兼容模式”。
- 掌压抑制可能把边缘的大面积接触判为手掌;换一个握持姿势,或在设置中调整。
延迟或卡顿
- 优先使用数据线;其次是同一 Wi-Fi 下的局域网,最后才是蓝牙。
- 局域网下让手机和 Mac 靠近路由器,优先 5 GHz,暂停大流量下载或视频流。
- 关闭 VPN、代理和会扫描局域网的网络工具。
- 在触控板设置中降低指针加速或关闭触摸特效;在通用设置中打开性能模式。
- 蓝牙延迟受 Mac 侧连接间隔影响;如果同时使用蓝牙耳机,尝试切到有线音频或开启“蓝牙音频优先”。
断线、锁屏与后台
- 手机 App 必须保持前台亮屏。锁屏、切到后台、来电或其他 App 抢占前台都可能断开。
- 在“设置 → 通用”中打开“屏幕常亮”,避免系统自动锁屏。
- 手动点“断开连接”后,本轮不会自动重连;重新选择连接方式或重启 App。
- Mac 休眠、eTouch 退出或重启后,手机会按退避间隔尝试重连;等待或手动点“重新连接”。
通用蓝牙问题
- 通用蓝牙默认关闭,需要先在“设置 → 实验室功能”中打开。
- 主机必须在自己的蓝牙设置里连接
VK-<手机名>;Mac 首次需要手动连接一次,之后才会自动重连。 - 如果显示已连接但主机收不到输入,先点“重新广播”;仍无效时在主机上关闭再打开蓝牙。
- 重装或重启 App 后,macOS 可能缓存旧的 HID 描述符;在蓝牙设置里忽略旧记录再重新配对。
- 剪贴板、听写、非 ASCII 文本键和部分媒体键在通用蓝牙下不可用;需要这些功能时切换到蓝牙 / 局域网 / 数据线。
- 横向滚动默认关闭;需要在连接管理页打开,主机会要求重新连接。
多台 Mac 或手机
- 一台手机可以记住多台 Mac;切换目标时先抬起旧 Mac 上按住的键,避免残留。
- 一台 Mac 可以同时接入多台手机;如果输入发到了错误的手机,检查目标行和“自动切换输入目标”设置。
- 通用蓝牙模式下,多台主机以“默认主机”为准;可以在连接管理页修改。
还是解决不了
请通过反馈页面提交问题,并附上:
- 手机型号与 iOS / iPadOS 版本。
- Mac 型号、macOS 版本与 eTouch 版本。
- 使用的连接方式(蓝牙 / 局域网 / 数据线 / 通用蓝牙)。
- 具体现象、出现时间和是否可稳定复现。
- 如果方便,附上连接管理页“诊断”中的链路、加密、目标、延迟和安全输入状态。
不要附上密码、配对码或任何敏感内容。