
QtScrcpy 10 分钟完整实操指南Android USB 投屏、无线连接与键鼠控制【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpyQtScrcpy 是一款跨平台的 Android 投屏控制工具手机通过 USB 或 Wi-Fi 接上电脑画面立刻镜像到桌面键鼠可反向操作手机。帧率 30~60fps端到端延迟 35~70ms启动服务后 1 秒内出第一帧免 root手机端不安装任何 App。适合设备测试、投屏演示、在 PC 上用键鼠打手游这类场景。使用前核对手机、线材、网络三件套开始之前把下表逐项过一遍能省掉后面 80% 的排查时间。核对项如何确认不满足怎么办手机版本设置 → 关于手机显示 Android 5.0API 21及以上系统不达标则无法使用换一台设备数据线插上后手机有充电反应、电脑有识别提示换一根支持传数据的线或换一个 USB 口USB 调试开发者选项中开关已打开在关于手机连点版本号 7 次解锁该选项再打开控制权限**USB 调试安全设置**或允许模拟点击已开启在开发者选项中打开否则能看到画面但点不动adb 可用终端执行adb devices不报命令不存在安装 adb 工具或在config/config.ini的AdbPath里指定 adb 路径同一局域网手机 Wi-Fi 与电脑连在同一个路由器下切到同一 Wi-Fi5GHz 频段优先5555 端口防火墙已放行 5555 的 TCP 入站Linux/macOS 执行sudo ufw allow 5555/tcpWindows 在入站规则里放行从零到第一帧三个阶段点亮画面阶段一连线前确认两端具备条件确认手机为 Android 5.0 及以上版本。插上数据线把手机接到电脑。打开终端执行adb devices验证 adb 可用。怎么算对命令正常输出版本信息、不报错说明电脑端就绪。阶段二手机端设置打开两个调试开关打开设置 → 关于手机连续点击版本号7 次直到提示已开启开发者模式。进入开发者选项打开USB 调试。同页打开USB 调试安全设置小米等机型靠它授予模拟点击权限。手机上弹出允许 USB 调试吗时勾选始终允许并点确定。怎么算对终端再跑一次adb devices列表出现一串序列号状态为device而非unauthorized。阶段三首帧验证1 秒内看到画面启动 QtScrcpy点击刷新设备列表。在设备区确认出现刚才的序列号选中该设备。在启动配置区按需填好bit rate比特率与max size分辨率。点击启动服务。怎么算对1 秒内出现手机屏幕的第一帧在投屏窗口上移动鼠标、点击手机画面同步响应说明显示与控制双链路都通了。无线连接USB 通一次之后拔掉线USB 只是钥匙真正无线投屏靠手机端临时开启的 adbd 服务默认监听 5555 端口。确认手机与电脑处于同一局域网建议都在 5GHz 频段。点击获取设备 IP再点启动 adbd。在无线区域填入 IP 与端口 5555点击无线连接。再次点击刷新设备列表选中新增的 IP 开头设备点击启动服务。连上之后就可以拔掉数据线adbd 会一直运行到手机重启或你手动断开。若连接被拦先确认防火墙放行了 5555 的 TCP 入站见上表。怎么算成功设备列表里 IP 开头的条目稳定在列投屏连续不闪断拔掉线画面照旧。群组控制多台设备一次同步操作手里不止一台设备、要执行同一套流程时逐台点按太慢。把每台设备都连好并启动服务。在设备列表按住Ctrl点选多台设备加入群组。在群组控制里执行安装、配置、截图等操作整组同步响应。多设备同开时 CPU 偏高改config/config.ini的[common]段UseDesktopOpenGL2走 OpenGL 硬解1 为 DX 硬解、0 软解、-1 自动RenderExpiredFrames0跳过过期帧用一点流畅度换更低延迟多窗口同开时把MaxFps从不限设为 30只给重点设备留高帧率。怎么算成功一次点击整组设备同时完成任务管理器里 CPU 曲线平稳不再随窗口数飙升。按键映射键鼠玩 FPS 手游虚拟摇杆给不了精细瞄准也没有快捷键就用 JSON 映射文件把键盘鼠标翻译成手指动作。把 JSON 文件放进keymap/目录仓库自带gameforpeace.json、FRAG.json可直接参考点刷新脚本并选中它。启动服务后点击应用脚本。按~映射里的 switchKey切入自定义模式再按一次切回普通控制。鼠标移动由mouseMoveMap接管映射为以startPos为起点的划屏speedRatio越大灵敏度越低下限 0.00225FPS 游戏再配一个smallEyes键缩小瞄准范围。其余按键写在keyMapNodes数组里共五种类型KMT_CLICK点击、KMT_CLICK_TWICE双击、KMT_CLICK_MULTI多点、KMT_DRAG拖拽、KMT_STEER_WHEEL方向盘需 4 个键配合坐标是相对值(0.5, 0.5) 即屏幕中心。取坐标不用量屏幕投屏中左键点一下目标位置控制台直接打印该点的 pos复制到 JSON 即可。怎么算成功~切进映射后WASD 走位、鼠标开镜开火手感接近端游。省电镜像息屏不熄画面长时间挂着投屏很耗手机电量而 QtScrcpy 息屏后仍能继续镜像。启动前在启动配置区勾选自动息屏已连接时按CtrlO也可手动关屏。只想录屏不显示界面勾选仅后台录制画面在后台录制到本地。顺手装包、传文件拖拽 apk 到投屏窗口即安装拖拽任意文件即推送到手机。怎么算成功手机端黑屏电脑端投屏窗口仍在持续刷新录制文件按设置的路径正常落盘。一页速查常用参数参数默认值建议值什么情况下改ADBD 端口55555555走无线连接时确保防火墙放行该端口 TCP 入站UseDesktopOpenGL-1 自动2OpenGL 硬解多设备 CPU 高或报 shader 相关错误时RenderExpiredFrames00保持 0跳过过期帧换更低延迟MaxFps0 不限30多窗口同开或设备老旧时仅 Android 10 生效CodecName默认设备 H.264 编码器如OMX.qcom.video.encoder.avc想指定手机端编码器时分辨率max size随设备强网 1080p弱网 720p无线画面出现花屏、码率撑不住时比特率bit rate2Mbps弱网 ≤2Mbps无线投屏卡顿时的第一调整项出问题了6 个高频问答问刷新设备列表后看不到设备 答先跑adb devices状态是unauthorized就回手机点授权否则执行adb kill-server后adb start-server再刷新仍不行用任意手机助手连接一次回来再刷新。问控制台报 adb server version ... doesnt match 答电脑里多个版本的 adb 在冲突。任务管理器结束 adb 进程后重试反复出现就把config/config.ini的AdbPath固定为你正在用的 adb 路径。问画面能看键鼠却无反应 答先确认投屏窗口有焦点、且没被~卡在自定义映射里再查手机 **USB 调试安全设置**是否开启最后用adb shell input tap 500 500验证设备端输入链路是否通。问能控制但看不到画面日志有 shader 相关报错 答显卡不支持当前渲染方式。把config/config.ini的UseDesktopOpenGL改为1或2重启 QtScrcpy 生效。问提示 Could not open video stream 答先在启动配置的分辨率里选一个更低的值重试仍报错再同时压低比特率重新启动服务。问画面发虚文字尤其明显 答Windows 上右击程序 → 属性 → 兼容性 → 更改高 DPI 设置把缩放改为由应用程序执行同时把投屏窗口放大到接近手机真实分辨率。从插线到第一帧顺利的话 10 分钟内就能点亮无线、群控、键鼠映射各多花几步操作即可上手。想继续深入读这三份文档常见问题 FAQ按键映射编写规则开发指南【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考