当前位置：首页 > news >正文

MHY_Scanner：基于C++/Qt的跨平台游戏扫码登录解决方案架构解析

news 2026/6/9 18:32:09

MHY_Scanner：基于C++/Qt的跨平台游戏扫码登录解决方案架构解析

【免费下载链接】MHY_ScannerMHY扫码登录器，支持从直播流抢码。项目地址: https://gitcode.com/gh_mirrors/mh/MHY_Scanner

MHY_Scanner是一款专为米哈游游戏生态设计的开源扫码登录工具，采用C++/Qt技术栈实现跨平台支持，通过双模式识别架构（屏幕捕获与直播流直连）提供毫秒级二维码识别能力。该项目针对游戏直播抢码场景进行了深度优化，解决了传统手动操作在3-5秒有效窗口期内的响应瓶颈，为多账号管理和自动化登录提供了完整的解决方案。

技术架构设计与核心组件分析

模块化设计：解耦识别、捕获与网络通信

MHY_Scanner采用分层架构设计，将二维码识别、屏幕捕获、直播流处理和用户界面完全解耦。核心模块通过清晰的接口定义实现高内聚低耦合，便于功能扩展和维护。

核心组件架构图：

应用层 (UI) ├── 主控制模块 (WindowMain) ├── 屏幕扫码模块 (QRCodeForScreen) └── 直播流扫码模块 (QRCodeForStream) 业务逻辑层 (Core) ├── 二维码识别引擎 (QRScanner) ├── 屏幕捕获引擎 (ScreenScan) ├── 直播流处理引擎 (LiveStreamLink) ├── 加密通信模块 (CryptoKit) └── 配置管理模块 (ConfigDate) 基础设施层 ├── OpenCV图像处理 ├── Qt框架UI ├── cpr网络请求库 └── nlohmann/json配置解析

双引擎识别系统：微信二维码算法的工业级应用

项目采用OpenCV的微信二维码识别算法作为核心识别引擎，该算法在复杂背景和低光照条件下仍能保持92%以上的识别准确率。QRScanner类封装了完整的识别逻辑：

class QRScanner { public: QRScanner(); ~QRScanner(); void decodeSingle(const cv::Mat& img, std::string& qrCode); void decodeMultiple(const cv::Mat& img, std::string& qrCode); private: cv::Ptr<cv::wechat_qrcode::WeChatQRCode> detector; };

识别系统采用两级处理策略：首先进行快速预筛选，排除非二维码区域；然后对候选区域进行高精度解码。这种设计在1080p分辨率下平均处理时间低于50ms，满足直播场景的实时性要求。

多源捕获机制：DirectShow与GDI混合方案

ScreenScan类实现了基于Windows GDI的屏幕捕获机制，支持全屏和区域截取两种模式。直播流处理则通过LiveStreamLink类实现，支持Bilibili和Douyin两大主流平台的直播协议解析。

捕获性能对比表： | 捕获方式 | 延迟(ms) | CPU占用率 | 适用场景 | |---------|---------|----------|---------| | 屏幕捕获(GDI) | 30-50 | 5-8% | 常规游戏登录 | | 直播流(DirectShow) | 20-40 | 8-12% | 直播抢码场景 | | 混合模式 | 25-45 | 7-10% | 多场景切换 |

跨平台部署与编译配置指南

环境依赖与构建系统

项目采用CMake作为构建系统，支持Windows/Linux跨平台编译。主要依赖库包括：

Qt6：跨平台GUI框架
OpenCV 4.x：计算机视觉库
cpr：现代C++ HTTP请求库
nlohmann/json：JSON解析库
Boost：C++工具库

编译配置示例：

cmake_minimum_required(VERSION 3.26) project(MHY_Scanner VERSION 1.1.15 LANGUAGES CXX ) set(CMAKE_CXX_STANDARD 23) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(OpenCV REQUIRED opencv_world) find_package(Qt6 COMPONENTS Widgets REQUIRED) find_package(cpr CONFIG REQUIRED)

快速部署流程

环境准备：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/mh/MHY_Scanner cd MHY_Scanner # 安装vcpkg依赖 ./vcpkg install opencv4[core,wechat_qrcode]:x64-windows ./vcpkg install qt6-base:x64-windows

编译配置：

mkdir build && cd build cmake .. -DCMAKE_TOOLCHAIN_FILE=[vcpkg路径]/scripts/buildsystems/vcpkg.cmake cmake --build . --config Release

运行时配置：编辑doc/salt.json配置文件，设置游戏版本对应的salt值，确保加密通信的正确性。

核心功能实现与性能优化

直播流协议解析机制

LiveStreamLink模块实现了对Bilibili和Douyin直播平台的协议适配，通过实时解析直播流中的二维码数据实现毫秒级响应。该模块采用异步网络请求和流式处理技术，确保在弱网环境下的稳定性。

协议解析流程：

输入直播间RID（纯数字标识）
通过平台API获取真实房间ID
请求直播流地址和推流信息
建立DirectShow捕获管道
实时解码视频帧中的二维码

多账号管理与状态同步

ConfigDate类实现了基于JSON的配置文件管理，支持多账号的表格化管理和状态持久化。账号信息包括UID、用户名、游戏类型和自定义备注，支持批量导入导出功能。

账号配置数据结构：

{ "accounts": [ { "uid": "100000001", "username": "player1", "game_type": "hk4e", "priority": 1, "last_login": "2024-12-01T10:30:00Z" } ], "rotation_strategy": "priority_based", "auto_switch": true }

加密通信与安全机制

CryptoKit模块实现了米哈游游戏通信协议的加密解密算法，包括MD5、SHA256和自定义的salt算法。该模块确保扫码登录过程中的数据安全，防止中间人攻击。

图1：崩坏3游戏扫码登录界面，展示MHY_Scanner的识别目标区域

高级配置与性能调优

识别参数优化策略

通过调整QRScanner的识别参数，可以针对不同游戏界面进行优化：

置信度阈值调整：在复杂背景场景下适当降低阈值
区域检测优化：针对特定游戏UI布局调整ROI区域
预处理增强：增加图像锐化和对比度调整

性能调优参数表： | 参数项 | 默认值 | 优化范围 | 影响效果 | |--------|--------|----------|----------| | 扫描间隔 | 33ms | 16-100ms | 帧率与CPU占用平衡 | | 识别置信度 | 0.75 | 0.6-0.9 | 准确率与误报率 | | 缓冲区大小 | 1024KB | 512-2048KB | 内存使用与稳定性 | | 重试次数 | 3 | 1-5 | 网络容错能力 |

多实例部署方案

对于游戏工作室需要管理大量账号的场景，推荐采用多实例部署方案：

负载均衡：每个实例管理10-15个账号
进程隔离：避免单点故障影响整体服务
监控聚合：统一日志收集和状态监控

图2：原神游戏扫码登录界面，显示MHY_Scanner支持的多种登录方式

扩展开发与二次开发指南

插件化架构设计

项目采用模块化设计，便于功能扩展。开发者可以通过以下接口实现自定义功能：

识别算法插件：实现新的二维码识别算法
捕获源插件：支持更多直播平台或视频源
输出插件：集成到第三方自动化系统

API接口文档

核心API接口定义在ApiDefs.hpp中，提供统一的HTTP客户端和游戏API封装：

// HTTP客户端接口 class HttpClient { public: bool GetRequest(std::string& response, const std::string& url); bool PostRequest(std::string& response, const std::string& url, const std::string& data); }; // 游戏API接口 std::optional<LoginResult> getStokenByGameToken( const std::string& gameToken, const std::string& gameUid);

测试框架集成

项目集成了Google Test框架，提供完整的单元测试和集成测试：

TEST(QRScanner, DecodeSingle) { QRScanner scanner; cv::Mat testImage = loadTestQRCode(); std::string result; scanner.decodeSingle(testImage, result); EXPECT_FALSE(result.empty()); } TEST(LiveStreamLink, BilibiliRoomID) { auto info = GetLiveInfo<LiveBili>("123456"); EXPECT_EQ(info.status, LiveStreamStatus::Normal); }

图3：崩坏：星穹铁道游戏扫码界面，展示深色主题下的识别效果