BetterGI Web Cloud Bridge

BetterGI 与网页云原神之间的双向桥接：捕获标签页画面并通过 CDP 注入输入。

BetterGI Web Cloud Bridge 是连接 BetterGI 与网页版《云·原神》的浏览器桥接扩展。 它让 BetterGI 能够获取浏览器中运行的《云·原神》游戏画面，并将 BetterGI 产生的键盘与鼠标操作转发到对应的游戏标签页，从而为 BetterGI 提供网页端的画面识别与自动化控制能力。 【主要功能】 • 游戏画面捕获 在用户主动连接目标标签页后，通过 Chrome 的标签页捕获能力获取《云·原神》游戏画面，并自动识别和裁剪有效游戏区域。 • 标准化画面回传 捕获的游戏画面会被转换为 BetterGI 使用的标准逻辑分辨率，并以 WebP 或 JPEG 格式编码，通过桥接连接实时发送给 BetterGI。 • 键盘与鼠标输入 通过 Chrome DevTools Protocol（CDP）向已连接的游戏标签页转发 BetterGI 产生的输入操作，包括键盘按键、鼠标点击、按下与释放、绝对移动、拖拽和滚轮。 • 游戏区域与坐标校准 自动检测游戏画面的实际显示区域，并处理窗口尺寸、页面比例、黑边、全屏和设备像素比等变化，使 BetterGI 的逻辑坐标与网页中的实际游戏区域保持对应。 • 会话状态管理 使用独立会话管理 BetterGI 与浏览器标签页之间的连接，并通过心跳、状态检测和输入序列校验维持桥接状态。 • 安全释放输入状态 当连接断开、目标标签页关闭、页面发生变化或调试连接结束时，扩展会主动释放仍处于按下状态的键盘按键和鼠标按钮，降低出现“卡键”等异常状态的可能性。 • 状态与诊断 扩展面板可以查看 BetterGI 连接状态、目标标签页、CDP 状态、游戏区域、画面分辨率、发送帧率和缓冲情况，并支持导出诊断信息。 【工作方式】 1. 在 Chrome 中打开网页版《云·原神》并进入游戏。 2. 确保 BetterGI 的 Web Cloud Bridge 服务已经运行。 3. 打开 BetterGI Web Cloud Bridge 扩展。 4. 点击“连接 BetterGI”。 5. 扩展将当前《云·原神》标签页与 BetterGI 建立桥接。 连接建立后，游戏画面可以被实时回传给 BetterGI，同时 BetterGI 可以通过扩展向该标签页发送键盘与鼠标输入。 【连接方式】 默认情况下，扩展通过 WebSocket 连接 BetterGI 提供的本地桥接服务。默认地址为： ws://127.0.0.1:51888/bridge 桥接地址、端口以及可选的连接 Token 可以在扩展的高级设置中配置。 【权限说明】 为了实现核心功能，本扩展需要使用 Chrome 提供的标签页捕获、后台媒体处理、标签页访问、扩展本地存储以及调试接口等能力。 其中，Chrome 调试接口仅用于向用户主动连接的目标《云·原神》标签页发送 CDP 输入事件以及获取必要的游戏区域信息。结束会话后，扩展会主动解除与目标标签页的调试连接。 【使用要求】 • Chrome 116 或更高版本 • 网页版《云·原神》 • BetterGI 或兼容 BetterGI Web Cloud Bridge 协议的桥接服务 BetterGI Web Cloud Bridge 本身不是游戏客户端，也不提供《云·原神》游戏内容。它作为 BetterGI 的浏览器桥接组件使用。