Scrcpy Mask

English

Scrcpy Mask 是一款基于 Rust + Bevy + React 构建的跨平台桌面客户端，用于高效控制安卓设备。 它提供了可视化的鼠标与键盘按键映射配置，实现了类似安卓模拟器的多点触控操作，具备毫秒级响应速度，带来流畅自然的交互体验。该工具可广泛应用于在电脑上操控安卓设备、玩手游等场景。

从 v0.7.0 开始，项目已完全迁移至 Bevy 游戏引擎，带来了更强大、更稳定的功能，包括 scrcpy 投屏、组合按键映射、以及更灵活的 内置脚本系统与外部控制机制。

⚠️ 旧版基于 Rust + Tauri + Vue 的分支已停止维护。

特别感谢 Scrcpy 项目的开发者。Scrcpy 是一个功能强大、性能卓越的开源工具，为 Android 设备的远程控制提供了坚实基础。 Scrcpy Mask 基于其优秀架构，针对鼠标与键盘控制进行了进一步的增强与扩展。

为了更好地支持 Scrcpy Mask 与安卓设备的交互，对原 scrcpy-server 进行了功能扩展与优化，并基于此创建了分支项目 scrcpy-mask-server。

特性

• [x] 国际化
• [x] 有线、无线连接安卓设备
• [x] Scrcpy 控制协议（映射）
• [x] Scrcpy 视频协议（投屏）
• [x] 按键映射配置可视化
• [x] 内置脚本，见脚本语法规则简介
• [x] 鼠标、键盘按键映射，支持点击、连点、多点、滑动、方向盘、施法、FPS/开火、RawInput、脚本等映射类型
• [x] 按键随机化增强，支持触摸随机偏移、滑动轨迹随机化、随机锚点和微抖
• [ ] 手柄按键映射（等待赞助支持❤️）
• [x] 外部程序控制（HTTP API + WebSocket，可管理设备、映射配置和应用设置，含窗口同步示例），见外部控制
• [ ] 帮助文档

视频教程

• “像模拟器一样控制安卓设备玩手游” Scrcpy Mask 重要版本更替说明与教程

截图

• 设备

• 映射

• 投屏

• 设置

贡献

build-help 简要说明了如何运行和编译项目。

如果你对本项目感兴趣，欢迎提交 PR 或 Issue。 由于个人时间和精力有限，可能无法及时处理所有反馈，敬请谅解。