其他镜像选项

只读

要禁用控件（可以与设备交互的所有内容：输入键，鼠标事件，拖放文件）：

scrcpy --no-control
scrcpy -n

显示

如果有多个显示器可用，则可以选择要镜像的显示器：

scrcpy --display=1

可以通过以下方式检索显示 ID 列表：

adb shell dumpsys display   # search "mDisplayId=" in the output

仅当设备至少运行 Android 10 时，才能控制辅助显示屏（否则会镜像为只读）。

保持清醒

要防止设备在插入设备时延迟后休眠，请执行以下操作：

scrcpy --stay-awake
scrcpy -w

关闭 scrcpy 时恢复初始状态。

关闭屏幕

可以使用命令行选项在启动时镜像时关闭设备屏幕：

scrcpy --turn-screen-off
scrcpy -S

或者随时按 +。MODo

要重新打开它，请按 ++。MODShifto

在安卓设备上，该按钮始终打开屏幕。为方便起见，如果通过scrcpy（通过右键单击或+）发送，它将在小延迟后强制关闭屏幕（尽最大努力）。物理按钮仍会导致屏幕打开。

POWER

POWER

POWER

防止设备进入睡眠状态也很有用：

scrcpy --turn-screen-off --stay-awake
scrcpy -Sw

关闭时关闭电源

要在关闭 scrcpy 时关闭设备屏幕：

scrcpy --power-off-on-close

开机启动

默认情况下，在启动时，设备已打开电源。

若要防止此行为，请执行以下操作：

scrcpy --no-power-on

显示触摸

对于演示文稿，显示物理触摸（在物理设备上）可能很有用。

Android 在开发者选项中提供了此功能。

Scrcpy 提供了一个选项，用于在启动时启用此功能并在退出时恢复初始值：

scrcpy --show-touches
scrcpy -t

请注意，它仅显示物理触摸（通过设备上的手指）。

禁用屏幕保护程序

默认情况下，scrcpy 不会阻止屏幕保护程序在计算机上运行。

要禁用它：

scrcpy --disable-screensaver

输入控制

旋转设备屏幕

按 + 可在纵向和横向模式之间切换。MODr

请注意，仅当前台中的应用程序支持请求的方向时，它才会旋转。

复制粘贴

每当Android剪贴板更改时，它都会自动同步到计算机剪贴板。

任何快捷方式都会转发到设备。特别：Ctrl

• Ctrl+c通常复制
• Ctrl+x通常切割
• Ctrl+v通常粘贴（在计算机到设备剪贴板同步后）

这通常按预期工作。

但是，实际行为取决于活动应用程序。例如，Termux 在 + 上发送 SIGINT，而 K-9 Mail 撰写新邮件。Ctrlc

在这种情况下要复制、剪切和粘贴（但仅在 Android >= 7 上支持）：

• MOD+c注入

  COPY

• MOD+x注入

  CUT

• MOD+v注入（计算机到设备剪贴板同步后）

  PASTE

此外，++ 将计算机剪贴板文本作为一系列关键事件注入。当组件不接受文本粘贴（例如在 Termux 中）时，这很有用，但它可能会破坏非 ASCII 内容。MODShiftv

警告：将计算机剪贴板粘贴到设备（通过 + 或 +）会将内容复制到 Android 剪贴板中。因此，任何Android应用程序都可以读取其内容。你应该避免以这种方式粘贴敏感内容（如密码）。CtrlvMODv

以编程方式设置设备剪贴板时，某些 Android 设备的行为不符合预期。提供了一个选项来更改 + 和 + 的行为，以便它们也将计算机剪贴板文本作为键事件序列注入（与 ++ 相同）。

--legacy-paste

要禁用自动剪贴板同步，请使用 。

--no-clipboard-autosync

捏合缩放

要模拟“捏合缩放”：+单击并移动。Ctrl

更准确地说，按住并按下左键单击按钮。在释放左键单击按钮之前，所有鼠标移动都会相对于屏幕中心缩放和旋转内容（如果应用程序支持）。Ctrl

从技术上讲，scrcpy 从屏幕中心倒置位置的“虚拟手指”生成额外的触摸事件。

物理键盘模拟 （HID）

默认情况下，scrcpy使用Android密钥或文本注入：它可以在任何地方使用，但仅限于ASCII。

或者，可以在 Android 上模拟物理 USB 键盘以提供更好的输入体验（通过 AOAv2 使用 USB HID）：虚拟键盘已禁用，适用于所有字符和 IME。

scrcpy

但是，仅当设备通过USB连接时，它才有效。

注意：在 Windows 上，它可能只能在 OTG 模式下工作，而在镜像时不能工作（如果 USB 设备已经被另一个进程（如 adb 守护程序）打开，则无法打开 USB 设备）。

要启用此模式：

scrcpy --hid-keyboard
scrcpy -K  # short version

如果由于某种原因（例如，由于设备未通过 USB 连接）而失败，它会自动回退到默认模式（在控制台中登录）。这允许在通过 USB 和 TCP/IP 连接时使用相同的命令行选项。

在此模式下，原始密钥事件（扫描码）将发送到设备，与主机密钥映射无关。因此，如果你的键盘布局不匹配，则必须在 Android 设备上的“系统→语言设置”→“中对其进行配置，然后输入→物理键盘。

此设置页面可以直接启动：

adb shell am start -a android.settings.HARD_KEYBOARD_SETTINGS

但是，该选项仅在启用 HID 键盘（或连接物理键盘）时可用。

物理鼠标模拟 （HID）

与物理键盘模拟类似，可以模拟物理鼠标。同样，仅当设备通过USB连接时，它才有效。

默认情况下，scrcpy 使用具有绝对坐标的 Android 鼠标事件注入。通过模拟物理鼠标，Android 设备上会出现鼠标指针，并注入相对鼠标运动、点击和滚动。

要启用此模式：

scrcpy --hid-mouse
scrcpy -M  # short version

你还可以添加以转发所有鼠标按钮。

--forward-all-clicks

启用此模式后，计算机鼠标将被“捕获”（鼠标指针从计算机中消失，而是出现在 Android 设备上）。

特殊捕获键（或 ）切换（禁用或启用）鼠标捕获。使用其中一个将鼠标的控制权交还给计算机。AltSuper

奥特格

可以仅使用物理键盘和鼠标模拟 （HID） 运行 scrcpy，就像计算机键盘和鼠标通过 OTG 电缆直接插入设备一样。

在此模式下，不需要（USB调试），并且禁用了镜像。

adb

要启用 OTG 模式：

scrcpy --otg
# Pass the serial if several USB devices are available
scrcpy --otg -s 0123456789abcdef

只能启用 HID 键盘或 HID 鼠标：

scrcpy --otg --hid-keyboard              # keyboard only
scrcpy --otg --hid-mouse                 # mouse only
scrcpy --otg --hid-keyboard --hid-mouse  # keyboard and mouse
# for convenience, enable both by default
scrcpy --otg                             # keyboard and mouse

喜欢和，它仅在设备通过USB连接时才有效。

--hid-keyboard

--hid-mouse

文本注入首选项

键入文本时会生成两种类型的事件：

• 键事件，表示按键被按下或释放;
• 文本事件，表示已输入文本。

默认情况下，使用键事件注入字母，以便键盘在游戏中按预期运行（通常用于 WASD 键）。

但这可能会导致问题。如果遇到此类问题，可以通过以下方式避免：

scrcpy --prefer-text

（但这会破坏游戏中的键盘行为）

相反，你可以强制始终注入原始密钥事件：

scrcpy --raw-key-events

这些选项对 HID 键盘没有影响（在此模式下，所有键事件都作为扫描码发送）。

按键重复

默认情况下，按住某个键会生成重复的键事件。这可能会导致某些游戏的性能问题，在这些游戏中，这些事件无论如何都是无用的。

要避免转发重复的关键事件，请执行以下操作：

scrcpy --no-key-repeat

此选项对 HID 键盘没有影响（在此模式下，Android 直接处理按键重复）。

右键单击和中键单击

默认情况下，右键单击触发器返回（或开机），中键单击触发主页。要停用这些快捷方式并将点击内容转发到设备，请执行以下操作：

scrcpy --forward-all-clicks

文件放置

安装 APK

要安装APK，请将APK文件（以 结尾）拖放到scrcpy窗口中。

.apk

没有视觉反馈，日志打印到控制台。

将文件推送到设备

要将文件推送到设备上，请将（非APK）文件拖放到scrcpy窗口中。

/sdcard/Download/

没有视觉反馈，日志打印到控制台。

可以在启动时更改目标目录：

scrcpy --push-target=/sdcard/Movies/

音频转发

音频不是由 scrcpy 转发的。使用sndcpy。

另请参阅问题 #14。

快捷方式

在下面的列表中，是快捷方式修饰符。默认情况下，它是（左）或（左）。MODAltSuper

可以使用 进行更改。可能的键是 、 、 和 。例如：

--shortcut-mod

lctrl

rctrl

lalt

ralt

lsuper

rsuper

# use RCtrl for shortcuts
scrcpy --shortcut-mod=rctrl

# use either LCtrl+LAlt or LSuper for shortcuts
scrcpy --shortcut-mod=lctrl+lalt,lsuper

Super通常是Windows或Cmd键。

HOME

BACK

APP_SWITCH

MENU

VOLUME_UP

VOLUME_DOWN

POWER

¹双击黑色边框以将其删除。
²右键单击将打开屏幕（如果屏幕已关闭），否则按返回。
³第 4 和第 5 个鼠标按钮（如果鼠标有）。
⁴对于开发中的 React 原生应用，MENU 会触发开发菜单。
⁵仅在安卓上 >= 7。

adb

ADB

ADB=/path/to/adb scrcpy

scrcpy-server

SCRCPY_SERVER_PATH

SCRCPY_ICON_PATH

scrcpy

Copyright (C) 2018 Genymobile
Copyright (C) 2018-2022 Romain Vimont

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.