scrcpy用法大全

用法：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运行时保持设备唤醒，当设备连接时。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213