Sobre o projeto

Scrcpy Mask 是一个用于控制 Android 设备的跨平台桌面客户端,使用 Rust、Bevy 和 React 构建。它提供了一个可视化界面来配置鼠标和键盘映射,支持类似 Android 模拟器的多点触控操作,旨在满足从计算机控制 Android 设备或玩手机游戏等场景。 自 v0.7.0 起,该项目已完全迁移到 Bevy 游戏引擎,增加了 scrcpy 屏幕镜像、组合键映射以及内置脚本系统和外部控制机制等功能。早期的 Rust + Tauri + Vue 分支已不再维护。 该项目基于 Scrcpy(开源 Android 远程控制工具)构建,并扩展了增强的鼠标和键盘控制。为了支持这种交互,原始的 scrcpy-server 被扩展和优化,成为一个独立的分支项目 scrcpy-mask-server。 README 中列出的关键功能包括: - 国际化(i18n) - 有线和无线 Android 设备连接 - 用于输入映射的 Scrcpy 控制协议 - 用于屏幕镜像的 Scrcpy 视频协议 - 可视化按键映射配置 - 内置脚本支持,附带单独的脚本语法指南 - 鼠标和键盘映射,包括点击、重复点击、多点点击、滑动、方向键、施法控制、FPS/射击、RawInput 和脚本 - 输入随机化增强:随机触摸偏移、滑动路径、随机锚点和微抖动 - 可选的实验性 UHID 触摸屏后端,支持最多 10 个同时触点 - 通过 HTTP API 和 WebSocket 进行外部控制,用于设备、映射配置和应用设置,并附带窗口同步示例 计划中或尚未完成的项目包括游戏控制器映射(等待赞助)和文档。 README 还链接了中文视频教程、设备、映射、屏幕投射和设置界面的截图、用于运行和编译项目的构建帮助文档,以及 Star 历史图表。欢迎通过 PR 或 issue 贡献,但注意响应时间可能有限。