bash
用法:scrcpy [选项]
选项:
--always-on-top
使scrcpy窗口始终位于其他窗口之上。
-b,--bit-rate=value
以指定的比特率对视频进行编码,单位为比特每秒。支持单位后缀:'K'(x1000)和'M'(x1000000)。
默认值为8000000。
--codec-options=key[:type]=value[,...]
为设备编码器设置逗号分隔的key:type=value选项列表。
"type"的可能值为'int'(默认值)、'long'、'float'和'string'。
可在Android文档中找到可能的编解码器选项列表:<https://d.android.com/reference/android/media/MediaFormat>
--crop=width:height:x:y
在服务器上裁剪设备屏幕。
值以设备的自然方向表示(通常,手机为纵向,平板为横向)。任何--max-size值均基于裁剪后的大小计算。
-d,--select-usb
使用USB设备(如果正好有一个,类似于adb -d)。
也可参见-e(--select-tcpip)。
--disable-screensaver
在运行scrcpy时禁用屏幕保护程序。
--display=id
指定要镜像的显示ID。
可通过以下方式列出可能的显示ID:adb shell dumpsys display
(在输出中搜索"mDisplayId=")
默认值为0。
--display-buffer=ms
在显示前增加一个缓冲延迟(以毫秒为单位)。这会增加延迟以弥补抖动。
默认值为0(无缓冲)。
-e,--select-tcpip
使用TCP/IP设备(如果正好有一个,类似于adb -e)。
也可参见-d(--select-usb)。
--encoder=name
使用特定的MediaCodec编码器(必须是H.264编码器)。
--force-adb-forward
不尝试使用"adb reverse"连接到设备。
--forward-all-clicks
默认情况下,右键触发BACK(或打开电源),中键触发HOME。此选项禁用这些快捷键,而是将点击转发到设备。
-f,--fullscreen
全屏启动。
-K,--hid-keyboard
通过AOAv2上的HID模拟物理键盘。
对于IME用户,提供更好的体验,并允许生成非ASCII字符,与默认注入方法相反。
它可能仅通过USB工作。
必须在设备上通过设置->系统->语言和输入->物理键盘中配置键盘布局(一次性操作)。
此设置页面可直接启动:"adb shell am start -a android.settings.HARD_KEYBOARD_SETTINGS"。
但是,此选项仅在启用HID键盘时(或连接物理键盘时)可用。
也可参见--hid-mouse。
-h,--help
打印此帮助信息。
--legacy-paste
将计算机剪贴板文本作为键事件序列注入到Ctrl+v上(类似于MOD+Shift+v)。
这是对某些设备在以编程方式设置设备剪贴板时行为不符预期的一种解决方法。
--lock-video-orientation[=value]
将视频方向锁定为指定值。
可能的值为"unlocked"、"initial"(锁定到初始方向)、0、1、2和3。
设备的自然方向是0,每增加一次则逆时针旋转90度。
默认值为"unlocked"。
在没有参数的情况下传递此选项等同于传递"initial"。
--max-fps=value
限制屏幕捕获的帧速率(自Android 10以来官方支持,但在早期版本可能也适用)。
-M,--hid-mouse
通过AOAv2上的HID模拟物理鼠标。
在此模式下,捕获计算机鼠标以直接控制设备(相对鼠标模式)。
LAlt、LSuper或RSuper切换捕获模式,以将鼠标控制权还给计算机。
它可能仅通过USB工作。
也可参见--hid-keyboard。
-m,--max-size=value
将视频的宽度和高度限制为指定值。另一个维度将根据设备的宽高比进行计算。
默认值为0(无限制)。
--no-cleanup
默认情况下,scrcpy会在退出时从设备中移除服务器二进制文件,并恢复设备状态(显示触摸、保持唤醒和电源模式)。
此选项禁用了此清理操作。
--no-clipboard-autosync
默认情况下,scrcpy会在注入Ctrl+v之前自动将计算机剪贴板与设备剪贴板同步,并在设备剪贴板发生更改时将设备剪贴板与计算机剪贴板同步。
此选项禁用了此自动同步。
--no-downsize-on-error
默认情况下,在MediaCodec出现错误时,scrcpy会自动尝试降低清晰度再次尝试。
此选项禁用了此行为。
-n,--no-control
禁用设备控制(只是镜像设备为只读)。
-N,--no-display
不显示设备(仅在启用屏幕录制或V4L2 sink时)。
--no-key-repeat
当按住键时不转发重复的键事件。
--no-mipmaps
如果渲染器为OpenGL 3.0+或OpenGL ES 2.0+,则将自动生成mipmaps以提高缩小质量。此选项禁用了mipmaps的生成。
--no-power-on
在启动时不启动设备。
--otg
以OTG模式运行:模拟物理键盘和鼠标,就像计算机键盘和鼠标直接通过OTG电缆连接到设备一样。
在此模式下,不需要adb(USB调试),且镜像被禁用。
LAlt、LSuper或RSuper切换鼠标捕获模式,将鼠标控制权还给计算机。
如果设置了--hid-keyboard或--hid-mouse中的任何一个,则只启用键盘或鼠标,否则启用两者。
它可能仅通过USB工作。
参见--hid-keyboard和--hid-mouse。
-p,--port=port[:port]
设置客户端用于监听的TCP端口(范围)。
默认值为27183:27199。
--power-off-on-close
在关闭scrcpy时关闭设备屏幕。
--prefer-text
将Alpha字符和空格作为文本事件注入,而不是键事件。
这避免了在组合多个键输入特殊字符时出现问题,但破坏了游戏中Alpha键的预期行为(通常为WASD)。
--print-fps
启动FPS计数器,将帧速率日志打印到控制台。可以随时使用MOD+i启动或停止。
--push-target=path
设置通过拖放文件到设备时要推送文件的目标目录。它会原样传递给"adb push"。
默认值为"/sdcard/Download/"。
--raw-key-events
为所有输入键注入键事件,并忽略文本事件。
-r,--record=file.mp4
将屏幕录制到文件。
如果设置了--record-format选项,则格式由其确定,否则由文件扩展名(.mp4或.mkv)确定。
--record-format=format
强制录制格式(mp4或mkv)。
--render-driver=name
请求SDL使用给定的渲染驱动程序(这只是一个提示)。
当前支持的名称有"direct3d"、"opengl"、"opengles2"、"opengles"、"metal"和"software"。
<https://wiki.libsdl.org/SDL_HINT_RENDER_DRIVER>
--rotation=value
设置初始显示旋转。
可能的值为0、1、2和3。每增加一次则逆时针旋转90度。
-s,--serial=serial
设备序列号。只有当连接了多个设备到adb时才是强制性的。
--shortcut-mod=key[+...][,...]
指定scrcpy快捷键使用的修饰键。
可用的键为"lctrl"、"rctrl"、"lalt"、"ralt"、"lsuper"和"rsuper"。
一个快捷键可以由多个键组成,以"+"分隔。可以指定多个快捷键,以","分隔。
例如,要将LCtrl+LAlt或LSuper用于scrcpy快捷键,传递"lctrl+lalt,lsuper"。
默认值为"lalt,lsuper"(左Alt或左Super)。
-S,--turn-screen-off
立即关闭设备屏幕。
-t,--show-touches
在启动时启用"显示触摸",并在退出时恢复初始值。
仅显示物理触摸(不显示来自scrcpy的点击)。
--tcpip[=ip[:port]]
配置并重新连接设备的TCP/IP。
如果提供了目标地址,则scrcpy在启动前连接到此地址。设备必须监听给定的TCP端口(默认值为5555)。
如果未提供目标地址,则scrcpy会尝试找到当前设备(通常通过USB连接),启用TCP/IP模式,然后在启动前连接到此地址。
--tunnel-host=ip
设置到达scrcpy服务器的adb隧道的IP地址。此选项自动启用--force-adb-forward。
默认值为localhost。
--tunnel-port=port
设置到达scrcpy服务器的adb隧道的TCP端口。此选项自动启用--force-adb-forward。
默认值为0(不强制):用于建立隧道的本地端口将被使用。
--v4l2-sink=/dev/videoN
输出到v4l2loopback设备。
需要锁定视频方向(见--lock-video-orientation)。
该功能仅在Linux上可用。
--v4l2-buffer=ms
在推送帧之前增加一个缓冲延迟(以毫秒为单位)。这会增加延迟以弥补抖动。
此选项类似于--display-buffer,但专用于V4L2 sink。
默认值为0(无缓冲)。
此选项仅在Linux上可用。
-V,--verbosity=value
设置日志级别(verbose、debug、info、warn或error)。
默认值为info。
-v,--version
打印scrcpy的版本。
-w,--stay-awake
在scrcpy运行时保持设备唤醒,当设备连接时。