常见问题

连接和ADB问题

ADB通信流程

当scrcpy无法与设备建立连接时，问题通常出在ADB通信链中。了解连接过程有助于诊断问题。

常见的ADB失败

问题	技术原因	解决方案
`找不到adb`	`adb`可执行文件不在系统PATH中	确保`adb`在PATH中，或设置`ADB`环境变量
未检测到设备	设备USB调试未启用或缺少驱动程序	启用USB调试并安装正确的驱动程序
设备未授权	Android设备上缺少授权	接受设备上的USB调试提示
多设备	Scrcpy无法确定使用哪个设备	使用`-s`、`-d`或`-e`选项指定设备
ADB版本冲突	多个`adb`版本同时运行	使用单个`adb`版本或设置`ADB`环境变量
设备断开连接	ADB连接意外终止	尝试更换USB线或端口

来源: FAQ.md18-133

视频管道问题

scrcpy中最常见的问题之一涉及视频编码/解码管道。下图说明了可能发生故障的位置。

来源: FAQ.md215-225

编码器/解码器问题

最关键的问题通常围绕编码器/解码器兼容性。当Android设备上的MediaCodec抛出异常时，用户需要尝试替代编码器设置

问题	技术原因	解决方案
`MediaCodec`异常	所选编码器的兼容性问题	使用`--encoder`选项尝试不同的编码器
黑屏	解码器初始化失败	检查编码器/解码器兼容性
视频伪影	丢包或解码错误	降低比特率或使用更兼容的编解码器

来源: FAQ.md215-225

输入控制问题

scrcpy中的输入控制系统将主机上的用户输入连接到Android设备上的模拟输入。

来源: FAQ.md153-178

输入模拟问题

问题	技术原因	解决方案
鼠标/键盘不起作用	缺少“模拟输入”权限	启用“USB调试（安全设置）”选项
特殊字符不起作用	默认输入法的ASCII字符限制	使用`--hid-keyboard`切换到HID键盘模式
输入延迟	控制消息链中的处理延迟	降低设备帧率或分辨率以释放资源

来源: FAQ.md153-178

平台特定问题

Windows

在Windows上，可能会出现与USB驱动程序和OTG功能相关的特定问题

问题	技术原因	解决方案
OTG功能失败	缺少或不正确的USB驱动程序	更新USB驱动程序或使用libusb兼容的驱动程序
未找到USB设备	驱动程序兼容性问题	为设备安装WinUSB驱动程序

来源: FAQ.md136-149

Linux

Linux用户可能会遇到窗口系统兼容性问题

问题	技术原因	解决方案
Wayland问题	SDL默认使用X11	设置`SDL_VIDEODRIVER=wayland`环境变量
缺少libdecor	Wayland窗口装饰所需	安装libdecor包
KWin合成器崩溃	scrcpy与KWin的交互	在KWin设置中禁用“阻止合成”

来源: FAQ.md183-210

故障排除流程

当遇到scrcpy问题时，请遵循此系统性方法来诊断和解决它们

来源: FAQ.md5-7

调试命令

以下是一些用于诊断scrcpy问题的基本命令

目的	命令	要检查的输出
验证ADB连接	`adb devices`	设备应列为“device”
检查ADB版本	`adb version`	所有实例的版本应匹配
测试基本连接	`scrcpy --no-video`	应在不显示视频的情况下连接
详细模式	`scrcpy --verbose`	检查详细日志以获取错误消息
替代编码器	`scrcpy --encoder 'OMX.google.h264.encoder'`	如果默认编码器失败，请尝试此项
强制软件编码器	`scrcpy --encoder 'c2.android.avc.encoder'`	速度较慢但兼容性更好

来源: FAQ.md34-36 FAQ.md97-121 FAQ.md215-225

连接诊断流程

在排除连接问题时，请从验证连接链中的每个组件开始