使用手册

本手册面向用户快速完成键鼠映射、联网连接与按键调校。

拓展坞直连 局域网双机映射 高帧率实时绘制 宏 / 连点 / 多指 / 组合键等高级功能

快速开始

以局域网双机（PC + Android）为例，可自行更换其他连接方式

1，准备文件
群文件下载pc发送端压缩包到电脑并解压运行exe程序，下载bb7_pro压缩包到手机运行sh脚本，首次使用先选择GPU版本进行配置。
2，连接
先执行手机端sh脚本，记下显示的局域网IP地址，然后在PC端程序输入该IP地址，点击开始监听，连接完成。
3，映射配置
自行进行键位配置或导入他人配置文件到程序并加载。
4，开始
按下配置热键（默认ESC）退出配置界面，开始游玩。

连接方式

可选键鼠直连或双机局域网连接

本机直连

  • 1) 需要的设备：随便能用的键盘、鼠标和拓展坞
  • 2) 填入 PC：在 PC 端输入 IP，确认端口按默认即可。

    • 前置检查

    • 同网段：PC 与手机保持同一路由器 / 有线网卡。可在手机端界面读取 Wi-Fi IP（优先显示 w），若无 Wi-Fi 则显示网卡 IP（e）。
    • Ping 通：在 PC 上 ping 手机 IP，延迟稳定 (<40ms) 为佳。
    • 防火墙：允许局域网流量；若启用防录屏/隐私权限，先开映射再投屏。

    协议选择

    • UDP（默认）：低延迟，适合稳定局域网。
    • TCP：当 Wi-Fi 抖动或偶发丢包时使用，牺牲少量延迟换稳定性。
    • 切换方式：PC 端勾选 UDP/TCP 互斥复选框，配置会持久化保存。

    前后端逻辑

    理解数据流便于排查：PC 端监听键鼠 → 网络传输 → 手机端触控注入 → 游戏内表现。

    端到端链路
    PC 前端

    键鼠监听 & 编码

    Hook 键盘/鼠标事件，按配置生成触摸/宏指令。支持连点、宏滑动、滚轮映射。

    ⇨ UDP/TCP 传输
    网络层

    低延迟传输

    默认 UDP；如网络抖动或需可靠性，可切换 TCP。局域网优先 Wi-Fi，其次有线网卡。

    Android 后端

    触控合成

    解析指令，合成多指触摸、长按、滑动。支持显示/隐藏鼠标状态、压枪、灵敏度调节。

    ⇨
    游戏呈现

    画面与交互

    游戏内完成视角、移动、开火、开镜等操作。保持游戏设置与映射一致以避免跳屏。

    提示：若感觉延迟/跳屏，优先检查网络稳定性与游戏内“按钮转向”等设置，其次在 PC 端切换 UDP/TCP 或调低触摸采样率（可设置为 0 解除限制）。

    使用流程（详解）

    按端口分工执行，方便复查每一步。

    操作清单

    PC 端

    1. 启动：运行 GPU 版（或 CPU 版）。
    2. 网络：选择 UDP/TCP，输入手机 IP。
    3. 按键：点击“设置热键/按键”逐一绑定（含鼠标中键/侧键/滚轮）。
    4. 宏/连点：按需绑定，宏需先转换后再执行。
    5. 监听：点击“开始监听”，界面会禁用其他控件，停止时全部恢复。
    6. 压枪/灵敏度：根据需要开启并微调，确认开镜键匹配。

    手机端

    1. 前置：关闭系统多指手势/区域截屏/悬浮球等可能抢占触控的功能。
    2. 确认 IP：在主界面查看 Wi-Fi/网卡 IP，保持屏幕常亮。
    3. 连接：在 PC 端输入 IP 后开始监听，手机端应收到触控。
    4. 游戏设置：关闭“按钮转向/开火旋转”之类的自动转向选项，保证映射稳定。
    5. 测试：进入训练场或自定义房，验证移动、开火、开镜、滚轮缩放是否正常。
    6. 切换 CPU：若需隐藏界面或兼容检测，退出 GPU 版后启动 CPU 版继续连接。

    按键设置 & 推荐方案

    常用键位模板 + 配置要点，减少冲突与误触。

    键位与宏
    功能 推荐键位 说明
    移动 W / A / S / D 基础移动，保持与游戏内布局一致。
    跳跃 / 蹲伏 / 站起 Space / C / Ctrl 避免与系统热键冲突；如有冲突可改为 Alt 组合。
    开镜 / 开火 Right Mouse / Left Mouse 开镜后压枪才生效；测试连发稳定性。
    切枪 / 换弹 1 / 2 / R 切枪可配合宏滑动实现快速丢弃。
    疾跑模式 Shift（按下或松开切换） 支持模式切换，重新配置后生效。
    滚轮 Wheel Up / Down 1.3.2+ 修复冲突；映射时确认指针状态。
    截图快捷键 请避开 PC 系统截图键 否则可能触发电脑自身截图，导致窗口失焦。
    宏 / 连点 自定义 宏执行前需转换；连点需重新配置绑定键。

    配置小贴士

    • 显示鼠标状态：可单独设置中键/右键/侧键，便于界面操作。
    • 多指触控：1.2.0 起优化多指速度，适合压枪+移动等复合动作。
    • 触摸采样率：若遇到跳屏/触摸不生效，可适当降低采样率，设置为 0 代表不限制。
    • 宏滑动偏移：在显示鼠标状态下，可设置起点为实时位置，再设偏移点与终点。

    避坑指南

    • 冲突检查：同一时间避免多个键映射到同一触控点，防止覆盖。
    • 重置视角：遇到漂移可使用“重置视角”功能；仍异常时检查游戏内灵敏度。
    • 跳屏修复：关闭“按钮转向/探头键转动视角”，必要时降低触摸采样率。
    • 保存配置：修改后务必保存；主页连接方式/绘制开关已支持持久化。

    必看注意事项

    来源于实际问题反馈，提前规避可避免大多数故障。

    系统/手势

    • 关闭三指截屏、区域截屏、四指悬浮等系统手势，防止触摸失灵。
    • 投屏前固定手机方向，再开启投屏，避免坐标错位。

    最小化 / 前后台

    • 推荐双机；如需最小化：开映射 → 进游戏 → 退游戏 → 关映射 按顺序操作。
    • 本机直连时，游戏内不要拔插键鼠，以防驱动重新枚举导致掉线。

    检测与兼容

    • 部分游戏对 Android 16 以下 GPU 渲染有检测，需用 CPU 版游玩。
    • 如遇掐雷跳屏、滚轮异常，更新到最新版本后重新配置对应键位。

    性能与延迟

    • 网络抖动时切 TCP；高帧率时可适度降低压枪/触摸频率保持稳定。
    • 保持屏幕常亮，防止息屏后触控被系统节电策略拦截。

    常见问题 & 排查

    遇到异常先对照下列检查项。

    故障排查

    触摸不生效 / 跳屏

    • 确认系统手势已关闭，游戏内关闭按钮转向。
    • 在 PC 端降低触摸采样率；必要时切 TCP。
    • 重新校准键位（尤其是滚轮、探头键）。

    延迟高 / 丢包

    • 切换到 5G Wi-Fi 或有线网卡；减少同网段占用。
    • 尝试 TCP，或减少宏/连点频率。

    滚轮/按键冲突

    • 1.3.2+ 已修复；更新后重新绑定滚轮。
    • 避免把系统快捷键（如 Win+Shift+S）设为游戏操作。

    压枪不生效

    • 确认开镜键已按下，压枪在开镜状态才触发。
    • 调整水平随机偏移开关，观察抖动改善情况。

    版本要点（摘要）

    便于确认你是否已覆盖近期修复与功能。

    建议保持最新版

    1.3.8

    • IP 获取支持 Wi-Fi/网卡优先显示。
    • 支持任意两个组合键；主页配置持久化。
    • 修复非网络原因的掉后台。

    1.3.7

    • 扩展宏/连点功能（宏需先转换）。
    • 参数优化，连点需重新配置。

    1.3.6 及更早

    • 新增按键混合模式；宏界面优化。
    • 压枪水平随机偏移、滚轮冲突修复。
    • 触摸采样率配置、多指触控优化。

    扩展与后续维护

    页面结构采用卡片与网格，便于后续追加新章节或下载链接。

    可拓展

    可以继续添加

    • 下载/更新入口（区分 GPU / CPU 版）。
    • 常用游戏模板与灵敏度参考表。
    • 视频演示或 GIF，放入专门的“演示”区块。

    维护建议

    • 新增功能时，更新“快速开始”与“版本要点”。
    • 遇到新问题，直接在“排查 & FAQ”补充卡片。
    • 保持导航锚点命名一致，方便 GitHub Pages 锚点跳转。