控制
只读模式
禁用所有控制功能(包括与设备交互的所有操作:输入按键、鼠标事件、拖放文件等):
scrcpy --no-control
scrcpy -n # 简写形式
键盘与鼠标
仅控制模式
仅控制设备而不显示屏幕镜像:
scrcpy --no-video --no-audio
默认情况下,关闭视频播放时鼠标功能会被禁用。
如需使用相对鼠标模式控制设备,启用UHID鼠标模式:
scrcpy --no-video --no-audio --mouse=uhid
scrcpy --no-video --no-audio -M # 简写形式
如需同时使用UHID键盘,需显式设置:
scrcpy --no-video --no-audio --mouse=uhid --keyboard=uhid
scrcpy --no-video --no-audio -MK # 简写形式
如需改用AOA模式(仅限USB连接):
scrcpy --no-video --no-audio --keyboard=aoa --mouse=aoa
复制粘贴
Android剪贴板内容变化时会自动同步到电脑剪贴板。
所有Ctrl快捷键都会转发到设备,例如:
- Ctrl+c 通常执行复制
- Ctrl+x 通常执行剪切
- Ctrl+v 通常执行粘贴(在电脑到设备剪贴板同步后)
这些操作通常符合预期,但具体行为取决于当前应用。例如:
- Termux 会在Ctrl+c时发送SIGINT信号
- K-9 Mail 会触发新建邮件功能
针对此类情况(仅支持Android 7及以上版本),可通过以下组合键实现复制/剪切/粘贴:
- MOD+c 注入
COPY
命令 - MOD+x 注入
CUT
命令 - MOD+v 注入
PASTE
命令(在电脑到设备剪贴板同步后)
此外,MOD+Shift+v会将电脑剪贴板文本作为按键序列注入。这在组件不支持文本粘贴时(如_Termux_中)很有用,但可能破坏非ASCII内容。
警告: 将电脑剪贴板内容粘贴到设备(通过Ctrl+v或MOD+v)会将该内容存入Android剪贴板,导致任何应用均可读取。应避免以此方式粘贴敏感内容(如密码)。
部分Android设备在编程设置剪贴板时行为异常,可通过--legacy-paste
选项修改Ctrl+v和MOD+v的行为,使其同样以按键序列方式注入电脑剪贴板文本(与MOD+Shift+v相同)。
如需禁用自动剪贴板同步,使用--no-clipboard-autosync
。
捏合缩放、旋转与倾斜模拟
模拟"捏合缩放":Ctrl+点击并移动。
具体操作:按住Ctrl的同时按下鼠标左键。在左键释放前,所有鼠标移动都会以屏幕中心为基准对内容进行缩放和旋转(如果应用支持)。
https://github.com/Genymobile/scrcpy/assets/543275/26c4a920-9805-43f1-8d4c-608752d04767
模拟垂直倾斜手势:Shift+点击并上下移动。
https://github.com/Genymobile/scrcpy/assets/543275/1e252341-4a90-4b29-9d11-9153b324669f
类似地,模拟水平倾斜手势:Ctrl+Shift+点击并左右移动。
技术实现上,scrcpy_会通过屏幕中心对称点生成"虚拟手指"的额外触摸事件。按下Ctrl时_x_和_y_坐标会反转,单独按下Shift仅反转_x,而Ctrl+Shift仅反转_y_。
此功能仅适用于默认鼠标模式(--mouse=sdk
)。
文件拖放
安装APK
安装APK时,只需将APK文件(后缀为.apk
)拖放到_scrcpy_窗口。
无视觉反馈,操作日志会打印到控制台。
推送文件到设备
推送文件到设备的/sdcard/Download/
目录:将非APK文件拖放到_scrcpy_窗口。
无视觉反馈,操作日志会打印到控制台。
目标目录可通过启动参数修改:
scrcpy --push-target=/sdcard/Movies/