使用教程与常见问题

这说明电脑上同时运行了不同版本的 adb，QtScrcpy 自带的 adb 与你已安装的 adb 版本不一致。两种处理方式：

• 打开任务管理器，结束所有 adb 进程后重新操作；
• 修改 config.ini 中的 AdbPath，指向当前正在使用的 adb 可执行文件路径。

核心原则是：让所有调用 adb 的程序共用同一个版本。

先排除线材与授权问题：确认数据线支持数据传输、手机已弹出并同意调试授权、开发者选项中的 USB 调试处于开启状态。

官方 FAQ 提供了一个实用做法：随便安装一个手机助手类工具，先让它成功连接一次手机（这一步会触发驱动安装与授权），再回到 QtScrcpy 刷新设备列表。

部分机型（如小米）除了“USB 调试”之外，还需要在开发者选项中额外打开“USB 调试（安全设置）”，才能允许通过调试通道模拟点击。开启后断开重连即可。

如果只是个别应用的界面无法点击，也可能是该应用做了防自动化处理。

官方 FAQ 给出两个方向：

• Windows 高 DPI 缩放：右键可执行文件 → 属性 → 兼容性 → 更改高 DPI 设置 → 勾选“替代高 DPI 缩放行为”，执行缩放选择“应用程序”。
• 窗口尺寸：如果视频窗口远小于设备原始分辨率，画面会被压缩而显得模糊，文字尤其明显。可尝试 1:1 显示或提高窗口尺寸。

此外，提高启动配置中的分辨率与比特率也会改善观感，但会增加带宽与解码压力。

这通常意味着显卡不支持当前的视频渲染方式。可在 config.ini 中把解码方式改为 1 或 2 后重试。

若提示 Could not open video stream，官方给出的最简单做法是：在分辨率设置中降低一档，选择较低的分辨率再启动。

官方 FAQ 的建议是在手机端安装搜狗输入法或 QQ 输入法等支持中文的输入法，之后即可通过投屏输入中文。

另外，剪贴板的“文本事件”模式不支持非 ASCII 字符，需要粘贴中文时请改用 Ctrl + Shift + V 注入电脑剪贴板文本。

这是《和平精英》这类游戏的已知情况：上车会创建新的界面，导致原有的鼠标触摸点失效。官方说明目前技术上没有更好的解决办法，最实用的方式是连续按两次 ~ 键重新应用映射。

QtScrcpy 内置了基于 sndcpy 的音频转发，仅支持 Android 10 及以上，且官方文档明确标注“目前不推荐使用”，建议改用蓝牙连接播放手机音频。

换句话说，音频不是这个项目的强项，不要按“音画同步的投屏软件”来预期它。

v4.2.1 的 macOS 包执行的是 ad-hoc 签名，未经过 Apple 公证，因此 Gatekeeper 会拦截。处理方式：

• 在“系统设置 → 隐私与安全性”中点击“仍要打开”；
• 或在终端执行 xattr -dr com.apple.quarantine /Applications/QtScrcpy.app 后重新启动。

执行前请确认文件来源可信，并核对下载页给出的 SHA-256 校验值。

不需要注册账号，投屏过程也不依赖厂商云端服务，全部通过本机与设备之间的 ADB 通道完成。项目源码完全公开，可自行审计其行为。

需要注意的是，软件本身不需要联网，但你从第三方渠道下载的修改版可能包含额外组件——这也是本站只提供官方来源指引的原因。