常见问题

QtScrcpy 是基于开源项目 scrcpy 开发的 Qt 图形界面版本。scrcpy 是命令行工具，而 QtScrcpy 提供了直观的图形界面，额外支持以下功能：

• 可视化按键映射编辑器，方便配置游戏操控方案
• 多设备群控管理，可同时操控多台手机
• 图形化参数设置，无需记忆命令行参数
• 配置文件导入导出，方便分享和复用按键方案

项目完全开源免费，代码托管在 GitHub 和 码云。

访问本站 下载页面，选择对应系统版本下载。也可以直接前往 GitHub Releases 或 码云 Releases 获取最新版本。Windows 版解压即用，无需安装。

不需要。QtScrcpy 通过 ADB 调试协议与手机通信，只需在手机上开启 USB 调试即可使用。开启方法：设置 → 关于手机 → 连续点击"版本号"7次开启开发者模式 → 返回设置进入开发者选项 → 开启 USB 调试。

请按以下步骤排查：

1. 确认手机已开启 USB 调试（参考上一问题）
2. 检查数据线是否支持数据传输（部分线只能充电）
3. 换一根数据线或换一个 USB 接口试试
4. 手机上是否弹出了"允许 USB 调试"的授权提示？需要点击"允许"
5. 点击 QtScrcpy 中的"刷新"按钮重新扫描设备
6. 检查电脑是否安装了手机对应的 ADB 驱动（一般 Windows 10+ 会自动安装）

无线投屏需要先通过 USB 建立初始连接，然后切换到 WiFi 模式。常见问题排查：

1. 确认手机和电脑在同一个 WiFi 网络下
2. 确认输入的 IP 地址正确（在手机 WiFi 设置中查看当前 IP）
3. 端口号默认为 5555，确保没有被防火墙拦截
4. 部分路由器开启了 AP 隔离，会阻止设备间通信，需要在路由器设置中关闭
5. 建议使用 5GHz WiFi 频段，2.4GHz 频段延迟较高且容易受到干扰

可以。QtScrcpy 的按键映射功能专为游戏操控设计，支持：

• 将键盘按键映射到屏幕触摸位置（如 WASD 控制移动）
• 鼠标控制视角转向（类似 FPS 游戏的鼠标瞄准）
• 技能施法方向映射（拖动释放技能）
• 支持保存和加载配置方案，不同游戏使用不同配置

社区已分享三角洲行动、和平精英、王者荣耀等热门手游的按键映射配置，可直接导入使用。

可以尝试以下优化：

1. 降低分辨率（如从 1080P 降到 720P）
2. 降低码率（如从 8Mbps 降到 4Mbps）
3. 使用 USB 连接代替 WiFi 连接（USB 延迟更低更稳定）
4. 关闭电脑上其他占用 CPU 较高的程序
5. 确保使用 USB 3.0 接口（蓝色接口）
6. WiFi 模式下切换到 5GHz 频段

在按键映射编辑器中，可以使用"导出"按钮将当前配置保存为 JSON 文件。需要使用时点击"导入"按钮加载配置文件即可。你也可以在编辑器中直接编辑 JSON 配置，或从社区论坛下载其他玩家分享的配置文件导入使用。

连接多台设备后，在 QtScrcpy 主界面勾选需要同步操作的设备，开启"同步操作"功能。开启后，在一台设备上的触摸、点击、滑动操作会自动同步到所有已勾选的设备上。注意：所有同步设备的屏幕分辨率最好一致，否则触摸坐标映射可能不准确。

QtScrcpy 是完全开源的软件，代码公开在 GitHub 上可供任何人审查。它通过 ADB 协议在本地与手机通信，投屏数据不会上传到任何服务器。所有操作都在你的电脑上完成，不存在数据泄露风险。建议只从 GitHub 或 码云 下载，避免使用来路不明的修改版本。

QtScrcpy 支持 Android 5.0（API 21）及以上版本的安卓设备。部分高级功能（如无线调试）需要 Android 11 及以上版本。建议手机系统保持在较新版本以获得最佳兼容性。

如果遇到本站未覆盖的问题，可以通过以下渠道获取帮助：

• GitHub Issues — 提交 Bug 报告或功能建议
• 飞书文档 — 查看详细使用教程