Scrcpy 设备操作

在 scrcpy 运行期间，部分命令行参数会直接对设备本身进行操作。

保持唤醒

在设备接入电源的情况下，避免一段时间后自动休眠：

scrcpy --stay-awake
scrcpy -w

关闭 scrcpy 时会恢复初始状态。

如果设备未接入电源（即仅通过 TCP/IP 连接），--stay-awake 不生效（Android 的默认行为）。

该选项会修改 stay_on_while_plugged_in 的值，也可以手动更改：

# get the current show_touches value
adb shell settings get global stay_on_while_plugged_in
# enable for AC/USB/wireless chargers
adb shell settings put global stay_on_while_plugged_in 7
# disable
adb shell settings put global stay_on_while_plugged_in 0

息屏超时

Android 屏幕会在一段延迟后自动关闭。

在 scrcpy 运行期间更改该延迟：

scrcpy --screen-off-timeout=300  # 300 seconds (5 minutes)

退出时会恢复初始值。

也可手动更改该设置：

# get the current screen_off_timeout value
adb shell settings get system screen_off_timeout
# set a new value (in milliseconds)
adb shell settings put system screen_off_timeout 30000

注意：Android 系统值单位为毫秒，而 scrcpy 命令行参数单位为秒。

关闭屏幕

可在启动时通过命令行选项，在镜像的同时关闭设备屏幕：

scrcpy --turn-screen-off
scrcpy -S   # short version

也可在任意时刻按 MOD+o（见快捷键）。

要重新点亮屏幕，按 MOD+Shift+o。

在 Android 上，POWER 按钮总是会点亮屏幕。为了便于操作，如果通过 scrcpy 发送了 POWER（右键或 MOD+p），则会在短暂延时后强制息屏（尽力而为）。物理 POWER 按钮仍会点亮屏幕。

也可以避免设备休眠：

scrcpy --turn-screen-off --stay-awake
scrcpy -Sw   # short version

自 Android 15 起，也可手动更改该设置：

# turn screen off (0 for main display)
adb shell cmd display power-off 0
# turn screen on
adb shell cmd display power-on 0

显示触点

在演示场景中，显示（设备上的）物理触点会更直观。Android 在“开发者选项”中提供了该功能。

Scrcpy 提供了在启动时启用该功能、退出时恢复初始值的选项：

scrcpy --show-touches
scrcpy -t   # short version

注意：它仅显示设备上的“物理”触控（手指触摸）。

也可手动更改该设置：

# get the current show_touches value
adb shell settings get system show_touches
# enable show_touches
adb shell settings put system show_touches 1
# disable show_touches
adb shell settings put system show_touches 0

关闭时息屏

在关闭 scrcpy 时让设备息屏：

scrcpy --power-off-on-close

启动时点亮屏幕

默认情况下，启动时设备会被点亮。若想禁止：

scrcpy --no-power-on

启动 Android 应用

列出设备上已安装的 Android 应用：

scrcpy --list-apps

可在启动时根据包名指定并启动某个应用：

scrcpy --start-app=org.mozilla.firefox

该特性可用于在虚拟显示屏中运行应用：

scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc

在启动前可选地先强行停止该应用：在包名前添加 + 前缀：

scrcpy --start-app=+org.mozilla.firefox

也可为了方便通过应用“名称”选择：在前面添加 ? 前缀：

scrcpy --start-app=?firefox

但检索应用名称可能需要一些时间（有时需要几秒），因此推荐传递包名。

+ 与 ? 前缀可组合使用（按此顺序）：

scrcpy --start-app=+?firefox