Escrcpy 设备控制全指南从只读模式、剪贴板同步到捏合缩放与文件拖放【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy本指南完整讲解 scrcpy 桌面客户端Escrcpy 基于其构建的**设备控制Control**能力从一键禁用所有输入的只读模式、无镜像的纯控制模式到双向剪贴板同步、捏合缩放/倾斜手势模拟以及拖放 APK 安装与文件推送。读完你可以在命令行场景下精确控制 scrcpy 的交互行为并能对照 desktop/electron/middleware/scrcpy/index.js 理解 Escrcpy 是如何把这些参数组织成实际进程调用链的。控制能力总览scrcpyEscrcpy 的底层核心在完成视频/音频镜像之外还提供了完整的输入控制链路键盘、鼠标、剪贴板、手势模拟与文件拖放。控制相关的全部行为都通过命令行参数开关Escrcpy 的偏好设置中也以--mouse、--keyboard、--mouse-bind等字段一一对应暴露见 desktop/src/models/preference/input/index.js并在最终启动时拼装为scrcpy args进程见 desktop/electron/middleware/scrcpy/index.js 的createScrcpyProcess与createMirrorProcess。只读模式一键禁用所有交互如果只想“看”设备画面而不希望任何误触影响设备可以禁用全部控制功能——包括按键注入、鼠标事件、拖放文件等所有与设备的交互scrcpy --no-control scrcpy -n # 简写形式此模式常用于演示、录屏或远程围观场景画面照常镜像但任何输入都不会传达到设备。注意--no-control是总开关它同时关闭键盘、鼠标、剪贴板注入与拖放是优先级最高的控制开关。键盘与鼠标输入模式控制能力的主体是键盘与鼠标二者各自提供多种输入模式键盘--keyboardsdk默认、--keyboarduhid简写-K、--keyboardaoa、--keyboarddisabled详见键盘鼠标--mousesdk默认、--mouseuhid简写-M、--mouseaoa、--mousedisabled详见鼠标。其中sdk模式通过 Android API 注入事件鼠标为绝对坐标注入uhid/aoa模式在设备上模拟物理 HID 键鼠disabled则关闭对应输入。Escrcpy 的输入偏好中把这四个选项完整保留并额外提供--mouse-bind自定义按键绑定见 desktop/src/models/preference/input/index.js。开启 UHID 键鼠的前提UHID 模式需要设备内核支持部分旧版 Android 因权限问题无法使用启用后建议在设备上一次性配置与计算机匹配的键盘布局开启后可通过 scrcpy 窗口中的MODk快捷键进入物理键盘设置页。仅控制模式无镜像控制设备某些场景下只想控制设备、不需要屏幕镜像可以同时关闭视频与音频scrcpy --no-video --no-audio这种“纯控制”形态有两点需要注意默认鼠标功能会被禁用——关闭视频播放时SDK 模式的鼠标注入依赖镜像画面定位无法工作如需使用相对鼠标模式控制设备鼠标相对位移直接转发不再依赖画面坐标必须显式启用 UHID 鼠标模式scrcpy --no-video --no-audio --mouseuhid scrcpy --no-video --no-audio -M # 简写形式如果同时希望 UHID 键盘工作需显式指定默认仍为禁用状态scrcpy --no-video --no-audio --mouseuhid --keyboarduhid scrcpy --no-video --no-audio -MK # 简写形式若想改用 AOA 模式仅限 USB 连接无需 USB 调试、不经过 scrcpy 服务端scrcpy --no-video --no-audio --keyboardaoa --mouseaoa在 Escrcpy 中类似的“无镜像纯控制”形态被用于 OTG 模式useOtgAction通过overrides强制注入--no-video、--no-audio、--mouse: uhid、--keyboard: uhid等参数再启动镜像进程见 desktop/src/hooks/use-otg-action/index.js可见--no-video/--no-audio与uhid键鼠组合是“无画面控制设备”的标准配方。双向剪贴板同步与复制粘贴自动同步Android 设备剪贴板内容变化时会自动同步到电脑剪贴板同时在电脑上复制的内容也会在粘贴时同步回设备。所有Ctrl快捷键都会原样转发到设备组合键典型行为Ctrlc复制Ctrlx剪切Ctrlv粘贴在电脑→设备剪贴板同步后但这些操作的具体效果取决于当前应用例如Termux会把Ctrlc解释为发送 SIGINT 信号K-9 Mail则会触发新建邮件。为此仅支持 Android 7可用MOD组合键注入标准剪贴板命令组合键注入命令MODcCOPYMODxCUTMODvPASTE在电脑→设备剪贴板同步后此外MODShiftv会把电脑剪贴板文本以按键序列方式注入——对Termux这类不支持文本粘贴的组件特别有用但可能破坏非 ASCII 内容。粘贴敏感内容的警告警告通过Ctrlv或MODv粘贴到设备的电脑剪贴板内容会被存入Android 剪贴板这意味着任何应用都可以读取。切勿以此方式粘贴密码等敏感信息。兼容性与开关部分 Android 设备在编程设置剪贴板时行为异常可用--legacy-paste让Ctrlv和MODv也退化为“按键序列注入”与MODShiftv相同需要完全禁用自动剪贴板同步时使用--no-clipboard-autosync。捏合缩放、旋转与倾斜手势模拟scrcpy 支持把鼠标拖拽“翻译”成设备上的多点触控手势全部基于虚拟手指技术scrcpy 会以屏幕中心为对称点生成一个额外触点的触摸事件。捏合缩放Zoom按住Ctrl并按下鼠标左键在左键释放前移动鼠标即以屏幕中心为基准缩放应用支持时还会旋转Ctrl 左键 移动 → 捏合缩放垂直/水平倾斜Tilt垂直倾斜Shift 点击并上下移动水平倾斜CtrlShift 点击并左右移动。坐标反转的底层原理技术实现上scrcpy 通过屏幕中心对称点生成“虚拟手指”的额外触摸事件坐标反转规则如下按键组合虚拟手指坐标反转Ctrlx与y均反转Shift仅反转xCtrlShift仅反转y重要限制此功能仅适用于默认鼠标模式--mousesdk在uhid/aoa物理 HID 鼠标模式下不生效。文件拖放APK 安装与文件推送拖放操作是控制模块中最常用的文件交互能力所有拖放行为均无视觉反馈执行日志打印在控制台。安装 APK将后缀为.apk的文件直接拖放到 scrcpy 窗口即触发设备端安装拖放 xxx.apk → 设备安装 APK推送文件到设备将非 APK文件拖放到 scrcpy 窗口文件会被推送到设备的/sdcard/Download/目录拖放 任意文件 → /sdcard/Download/目标目录可通过启动参数修改scrcpy --push-target/sdcard/Movies/这一默认路径与 Escrcpy 文件管理器explorer的下载语义一致——在 Escrcpy 的文件推送流程中--push-target等参数同样由偏好设置装配后进入createScrcpyProcess的命令行见 desktop/electron/middleware/scrcpy/index.js 的record/helper等封装模式。参数速查表将本文涉及的全部控制相关参数汇总如下参数简写作用--no-control-n禁用所有控制功能只读模式--no-video—关闭视频镜像--no-audio—关闭音频转发--keyboarduhid-KUHID 物理键盘模拟--mouseuhid-MUHID 物理鼠标模拟--keyboardaoa—AOA 物理键盘仅 USB--mouseaoa—AOA 物理鼠标仅 USB--keyboarddisabled/--mousedisabled—禁用对应输入--mouse-bindxxxx:xxxx—自定义鼠标按键绑定--legacy-paste—粘贴退化为按键序列注入--no-clipboard-autosync—禁用自动剪贴板同步--push-target目录—设置拖放文件的目标目录结合 Escrcpy 的实际调用链理解上述参数后可以对照 Escrcpy 的实现确认其落地方式用户在偏好面板选择--mouseuhid、--keyboarduhid等选项配置保存在 desktop/src/models/preference/input/index.js 定义的结构中field即命令行参数名启动镜像时Escrcpy 通过createMirrorProcess组装--serialserial --window-titletitle args并交给createScrcpyProcess执行见 desktop/electron/middleware/scrcpy/index.js进程启动后Escrcpy 通过readyPattern如Renderer:、[server] INFO: Device:监听 scrcpy 输出判断是否就绪并对退出做归一化错误处理见 desktop/electron/middleware/scrcpy/index.js。这也解释了为什么 Escrcpy 中调整“鼠标模式/键盘模式/按键注入方式”后无需重启应用——它们最终都只是拼进scrcpy命令行的一段参数。相关文档与延伸阅读键盘输入模式的完整对比SDK / UHID / AOA键盘鼠标模式、悬停与按键绑定鼠标设备侧前置条件如小米设备需开启“USB 调试安全设置”才能注入输入事件scrcpy 总览OTG 模式下“无镜像 UHID 键鼠”的实际用法OTG【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考