scrcpy/README.zh-Hans.md

_Only the original [README](README.md) is guaranteed to be up-to-date._

_只有原版的 [README](README.md)是保证最新的。_

Current version is based on [f4c7044]

本文根据[f4c7044]进行翻译。

[f4c7044]: https://github.com/Genymobile/scrcpy/blob/f4c7044b46ae28eb64cb5e1a15c9649a44023c70/README.md

# scrcpy (v1.22)

<img src="data/icon.svg" width="128" height="128" alt="scrcpy" align="right" />

_发音为 "**scr**een **c**o**py**"_

本应用程序可以显示并控制通过 USB (或 [TCP/IP][article-tcpip]) 连接的安卓设备，且不需要任何 _root_ 权限。本程序支持 _GNU/Linux_, _Windows_ 和 _macOS_。

![screenshot](assets/screenshot-debian-600.jpg)

本应用专注于：

 - **轻量**： 原生，仅显示设备屏幕
 - **性能**： 30~120fps，取决于设备
 - **质量**： 分辨率可达 1920×1080 或更高
 - **低延迟**： [35~70ms][lowlatency]
 - **快速启动**： 最快 1 秒内即可显示第一帧
 - **无侵入性**： 不会在设备上遗留任何程序
 - **用户利益**： 无需帐号，无广告，无需联网
 - **自由**： 自由和开源软件

[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646

功能：
 - [屏幕录制](#屏幕录制)
 - 镜像时[关闭设备屏幕](#关闭设备屏幕)
 - 双向[复制粘贴](#复制粘贴)
 - [可配置显示质量](#采集设置)
 - 以设备屏幕[作为摄像头(V4L2)](#v4l2loopback) (仅限 Linux)
 - [模拟物理键盘 (HID)](#物理键盘模拟-hid) (仅限 Linux)
 - [物理鼠标模拟 (HID)](#物理鼠标模拟-hid) (仅限 Linux)
 - [OTG模式](#otg) (仅限 Linux)
 - 更多 ……

## 系统要求

安卓设备最低需要支持 API 21 (Android 5.0)。

确保设备已[开启 adb 调试][enable-adb]。

[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling

在某些设备上，还需要开启[额外的选项][control]以使用鼠标和键盘进行控制。

[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323


## 获取本程序

<a href="https://repology.org/project/scrcpy/versions"><img src="https://repology.org/badge/vertical-allrepos/scrcpy.svg" alt="Packaging status" align="right"></a>

### 概要

 - Linux: `apt install scrcpy`
 - Windows: [下载][direct-win64]
 - macOS: `brew install scrcpy`

从源代码编译: [构建][BUILD] ([简化过程][BUILD_simple])

[BUILD]: BUILD.md
[BUILD_simple]: BUILD.md#simple

### Linux

在 Debian 和 Ubuntu 上：

```
apt install scrcpy
```

在 Arch Linux 上:

```
pacman -S scrcpy
```

我们也提供 [Snap] 包： [`scrcpy`][snap-link]。

[snap-link]: https://snapstats.org/snaps/scrcpy

[snap]: https://en.wikipedia.org/wiki/Snappy_(package_manager)

对 Fedora 我们提供 [COPR] 包： [`scrcpy`][copr-link]。

[COPR]: https://fedoraproject.org/wiki/Category:Copr
[copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/

对 Gentoo 我们提供 [Ebuild] 包：[`scrcpy/`][ebuild-link]。

[Ebuild]: https://wiki.gentoo.org/wiki/Ebuild
[ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy

您也可以[自行构建][BUILD] ([简化过程][BUILD_simple])。


### Windows

在 Windows 上，为简便起见，我们提供包含了所有依赖 (包括 `adb`) 的预编译包。

 - [README](README.md#windows)

也可以使用 [Chocolatey]：

[Chocolatey]: https://chocolatey.org/

```bash
choco install scrcpy
choco install adb    # 如果还没有 adb
```

或者 [Scoop]:

```bash
scoop install scrcpy
scoop install adb    # 如果还没有 adb
```

[Scoop]: https://scoop.sh

您也可以[自行构建][BUILD]。


### macOS

本程序已发布到 [Homebrew]。直接安装即可：

[Homebrew]: https://brew.sh/

```bash
brew install scrcpy
```

你还需要在 `PATH` 内有 `adb`。如果还没有：

```bash
brew install android-platform-tools
```

或者通过 [MacPorts]，该方法同时设置好 adb：

```bash
sudo port install scrcpy
```

[MacPorts]: https://www.macports.org/

您也可以[自行构建][BUILD]。


## 运行

连接安卓设备，然后执行：

```bash
scrcpy
```

本程序支持命令行参数，查看参数列表：

```bash
scrcpy --help
```

## 功能介绍

### 采集设置

#### 降低分辨率

有时候，可以通过降低镜像的分辨率来提高性能。

要同时限制宽度和高度到某个值 (例如 1024)：

```bash
scrcpy --max-size 1024
scrcpy -m 1024  # 简写
```

另一边会被按比例缩小以保持设备的显示比例。这样，1920×1080 分辨率的设备会以 1024×576 的分辨率进行镜像。


#### 修改码率

默认码率是 8 Mbps。改变视频码率 (例如改为 2 Mbps)：

```bash
scrcpy --bit-rate 2M
scrcpy -b 2M  # 简写
```

#### 限制帧率

要限制采集的帧率：

```bash
scrcpy --max-fps 15
```

本功能从 Android 10 开始才被官方支持，但在一些旧版本中也能生效。

#### 画面裁剪

可以对设备屏幕进行裁剪，只镜像屏幕的一部分。

例如可以只镜像 Oculus Go 的一只眼睛。

```bash
scrcpy --crop 1224:1440:0:0   # 以 (0,0) 为原点的 1224x1440 像素
```

如果同时指定了 `--max-size`，会先进行裁剪，再进行缩放。


#### 锁定屏幕方向


要锁定镜像画面的方向：

```bash
scrcpy --lock-video-orientation     # 初始（目前）方向
scrcpy --lock-video-orientation=0   # 自然方向
scrcpy --lock-video-orientation=1   # 逆时针旋转 90°
scrcpy --lock-video-orientation=2   # 180°
scrcpy --lock-video-orientation=3   # 顺时针旋转 90°
```

只影响录制的方向。

[窗口可以独立旋转](#旋转)。


#### 编码器

一些设备内置了多种编码器，但是有的编码器会导致问题或崩溃。可以手动选择其它编码器：

```bash
scrcpy --encoder OMX.qcom.video.encoder.avc
```

要列出可用的编码器，可以指定一个不存在的编码器名称，错误信息中会包含所有的编码器：

```bash
scrcpy --encoder _
```

### 采集

#### 屏幕录制

可以在镜像的同时录制视频：

```bash
scrcpy --record file.mp4
scrcpy -r file.mkv
```

仅录制，不显示镜像：

```bash
scrcpy --no-display --record file.mp4
scrcpy -Nr file.mkv
# 按 Ctrl+C 停止录制
```

录制时会包含“被跳过的帧”，即使它们由于性能原因没有实时显示。设备会为每一帧打上 _时间戳_ ，所以 [包时延抖动][packet delay variation] 不会影响录制的文件。

[packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation


#### v4l2loopback

在 Linux 上，可以将视频流发送至 v4l2 回环 (loopback) 设备，因此可以使用任何 v4l2 工具像摄像头一样打开安卓设备。

需安装 `v4l2loopback` 模块：

```bash
sudo apt install v4l2loopback-dkms
```

创建一个 v4l2 设备：

```bash
sudo modprobe v4l2loopback
```

这样会在 `/dev/videoN` 创建一个新的视频设备，其中 `N` 是整数。 ([更多选项](https://github.com/umlaeute/v4l2loopback#options) 可以用来创建多个设备或者特定 ID 的设备)。

列出已启用的设备：

```bash
# 需要 v4l-utils 包
v4l2-ctl --list-devices

# 简单但或许足够
ls /dev/video*
```

使用一个 v4l2 漏开启 scrcpy：

```bash
scrcpy --v4l2-sink=/dev/videoN
scrcpy --v4l2-sink=/dev/videoN --no-display  # 禁用窗口镜像
scrcpy --v4l2-sink=/dev/videoN -N            # 简写
```

(将 `N` 替换为设备 ID，使用 `ls /dev/video*` 命令查看)

启用之后，可以使用 v4l2 工具打开视频流：

```bash
ffplay -i /dev/videoN
vlc v4l2:///dev/videoN   # VLC 可能存在一些缓冲延迟
```

例如，可以在 [OBS] 中采集视频。

[OBS]: https://obsproject.com/


#### 缓冲

可以加入缓冲，会增加延迟，但可以减少抖动 (见 [#2464])。

[#2464]: https://github.com/Genymobile/scrcpy/issues/2464

对于显示缓冲：

```bash
scrcpy --display-buffer=50  # 为显示增加 50 毫秒的缓冲
```

对于 V4L2 漏:

```bash
scrcpy --v4l2-buffer=500    # 为 v4l2 漏增加 500 毫秒的缓冲
```


### 连接

#### TCP/IP （无线）

_Scrcpy_ 使用 `adb` 与设备通信，并且 `adb` 支持通过 TCP/IP [连接]到设备（设备必须连接与电脑相同的网络）。

##### 自动配置

参数 `--tcpip` 允许自动配置连接。这里有两种方式。

对于传入的 adb 连接，如果设备（在这个例子中以192.168.1.1为可用地址）已经监听了一个端口（通常是5555），运行：

```bash
scrcpy --tcpip=192.168.1.1       # 默认端口是5555
scrcpy --tcpip=192.168.1.1:5555
```

如果adb TCP/IP（无线） 模式在某些设备上不被启用（或者你不知道IP地址），用USB连接设备，然后运行：

```bash
scrcpy --tcpip    # 无需其他参数
```

这将会自动寻找设备IP地址，启用TCP/IP模式，然后在启动之前连接到设备。

##### 手动配置

或者，可以通过 `adb` 使用手动启用 TCP/IP 连接：

1. 将设备和电脑连接至同一 Wi-Fi。
2. 打开 设置 → 关于手机 → 状态信息，获取设备的 IP 地址，也可以执行以下的命令：

    ```bash
    adb shell ip route | awk '{print $9}'
    ```

3. 启用设备的网络 adb 功能：`adb tcpip 5555`。
4. 断开设备的 USB 连接。
5. 连接到您的设备：`adb connect DEVICE_IP:5555` _(将 `DEVICE_IP` 替换为设备 IP)_。
6. 正常运行 `scrcpy`。

降低比特率和分辨率可能很有用：

```bash
scrcpy --bit-rate 2M --max-size 800
scrcpy -b2M -m800  # 简写
```

[连接]: https://developer.android.com/studio/command-line/adb.html#wireless


#### 多设备

如果 `adb devices` 列出了多个设备，您必须指定设备的 _序列号_ ：

```bash
scrcpy --serial 0123456789abcdef
scrcpy -s 0123456789abcdef  # 简写
```

如果设备通过 TCP/IP 连接：

```bash
scrcpy --serial 192.168.0.1:5555
scrcpy -s 192.168.0.1:5555  # 简写
```

您可以同时启动多个 _scrcpy_ 实例以同时显示多个设备的画面。

#### 在设备连接时自动启动

您可以使用 [AutoAdb]:

```bash
autoadb scrcpy -s '{}'
```

[AutoAdb]: https://github.com/rom1v/autoadb

#### 隧道

要远程连接到设备，可以将本地的 adb 客户端连接到远程的 adb 服务端 (需要两端的 _adb_ 协议版本相同)。

##### 远程ADB服务器

要连接到一个远程ADB服务器，让服务器在所有接口上监听：

```bash
adb kill-server
adb -a nodaemon server start
# 保持该窗口开启
```

**警告：所有客户端与ADB服务器的交流都是未加密的。**

假设此服务器可在 192.168.1.2 访问。 然后，从另一个终端，运行 scrcpy：

```bash
export ADB_SERVER_SOCKET=tcp:192.168.1.2:5037
scrcpy --tunnel-host=192.168.1.2
```

默认情况下，scrcpy使用用于 `adb forward` 隧道建立的本地端口（通常是 `27183`，见 `--port` ）。它也可以强制使用一个不同的隧道端口（当涉及更多的重定向时，这在更复杂的情况下可能很有用）:

```
scrcpy --tunnel-port=1234
```


##### SSH 隧道

为了安全地与远程ADB服务器通信，最好使用SSH隧道。

首先，确保ADB服务器正在远程计算机上运行：

```bash
adb start-server
```

然后，建立一个SSH隧道：

```bash
# 本地  5038 --> 远程  5037
# 本地 27183 <-- 远程 27183
ssh -CN -L5038:localhost:5037 -R27183:localhost:27183 your_remote_computer
# 保持该窗口开启
```

在另一个终端上，运行scrcpy：

```bash
export ADB_SERVER_SOCKET=tcp:localhost:5038
scrcpy
```

若要不使用远程端口转发，可以强制使用正向连接（注意是 `-L` 而不是 `-R` ）：

```bash
# 本地  5038 --> 远程  5037
# 本地 27183 <-- 远程 27183
ssh -CN -L5038:localhost:5037 -L27183:localhost:27183 your_remote_computer
# 保持该窗口开启
```

在另一个终端上，运行scrcpy：

```bash
export ADB_SERVER_SOCKET=tcp:localhost:5038
scrcpy --force-adb-forward
```


类似地，对于无线连接，可能需要降低画面质量：

```
scrcpy -b2M -m800 --max-fps 15
```

### 窗口设置

#### 标题

窗口的标题默认为设备型号。可以通过如下命令修改：

```bash
scrcpy --window-title "我的设备"
```

#### 位置和大小

您可以指定初始的窗口位置和大小：

```bash
scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
```

#### 无边框

禁用窗口边框：

```bash
scrcpy --window-borderless
```

#### 保持窗口在最前

您可以通过如下命令保持窗口在最前面：

```bash
scrcpy --always-on-top
```

#### 全屏

您可以通过如下命令直接全屏启动 scrcpy：

```bash
scrcpy --fullscreen
scrcpy -f  # 简写
```

全屏状态可以通过 <kbd>MOD</kbd>+<kbd>f</kbd> 随时切换。

#### 旋转

可以通过以下命令旋转窗口：

```bash
scrcpy --rotation 1
```

可选的值有：
 - `0`: 无旋转
 - `1`: 逆时针旋转 90°
 - `2`: 旋转 180°
 - `3`: 顺时针旋转 90°

也可以使用 <kbd>MOD</kbd>+<kbd>←</kbd> _(左箭头)_ 和 <kbd>MOD</kbd>+<kbd>→</kbd> _(右箭头)_ 随时更改。

需要注意的是， _scrcpy_ 中有三类旋转方向：
 - <kbd>MOD</kbd>+<kbd>r</kbd> 请求设备在竖屏和横屏之间切换 (如果前台应用程序不支持请求的朝向，可能会拒绝该请求)。
 - [`--lock-video-orientation`](#锁定屏幕方向) 改变镜像的朝向 (设备传输到电脑的画面的朝向)。这会影响录制。
 - `--rotation` (或 <kbd>MOD</kbd>+<kbd>←</kbd>/<kbd>MOD</kbd>+<kbd>→</kbd>) 只旋转窗口的内容。这只影响显示，不影响录制。


### 其他镜像设置

#### 只读

禁用电脑对设备的控制 (任何可与设备交互的方式：如键盘输入、鼠标事件和文件拖放)：

```bash
scrcpy --no-control
scrcpy -n
```

#### 显示屏

如果设备有多个显示屏，可以选择要镜像的显示屏：

```bash
scrcpy --display 1
```

可以通过如下命令列出所有显示屏的 id：

```
adb shell dumpsys display   # 在输出中搜索 “mDisplayId=”
```

控制第二显示屏需要设备运行 Android 10 或更高版本 (否则将在只读状态下镜像)。


#### 保持常亮

阻止设备在连接时一段时间后休眠：

```bash
scrcpy --stay-awake
scrcpy -w
```

scrcpy 关闭时会恢复设备原来的设置。


#### 关闭设备屏幕

可以通过以下的命令行参数在关闭设备屏幕的状态下进行镜像：

```bash
scrcpy --turn-screen-off
scrcpy -S
```

或者在任何时候按 <kbd>MOD</kbd>+<kbd>o</kbd>。

要重新打开屏幕，按下 <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>o</kbd>。

在Android上，`电源` 按钮始终能把屏幕打开。为了方便，对于在 _scrcpy_ 中发出的 `电源` 事件 (通过鼠标右键或 <kbd>MOD</kbd>+<kbd>p</kbd>)，会 (尽最大的努力) 在短暂的延迟后将屏幕关闭。设备上的 `电源` 按钮仍然能打开设备屏幕。

还可以同时阻止设备休眠：

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

#### 退出时息屏

scrcpy 退出时关闭设备屏幕：

```bash
scrcpy --power-off-on-close
```

#### 显示触摸

在演示时，可能会需要显示 (在物理设备上的) 物理触摸点。

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

_Scrcpy_ 提供一个选项可以在启动时开启这项功能并在退出时恢复初始设置：

```bash
scrcpy --show-touches
scrcpy -t
```

请注意这项功能只能显示 _物理_ 触摸 (用手指在屏幕上的触摸)。


#### 关闭屏保

_Scrcpy_ 默认不会阻止电脑上开启的屏幕保护。

关闭屏幕保护：

```bash
scrcpy --disable-screensaver
```


### 输入控制

#### 旋转设备屏幕

使用 <kbd>MOD</kbd>+<kbd>r</kbd> 在竖屏和横屏模式之间切换。

需要注意的是，只有在前台应用程序支持所要求的模式时，才会进行切换。

#### 复制粘贴

每次安卓的剪贴板变化时，其内容都会被自动同步到电脑的剪贴板上。

所有的 <kbd>Ctrl</kbd> 快捷键都会被转发至设备。其中：
 - <kbd>Ctrl</kbd>+<kbd>c</kbd> 通常执行复制
 - <kbd>Ctrl</kbd>+<kbd>x</kbd> 通常执行剪切
 - <kbd>Ctrl</kbd>+<kbd>v</kbd> 通常执行粘贴 (在电脑到设备的剪贴板同步完成之后)

大多数时候这些按键都会执行以上的功能。

但实际的行为取决于设备上的前台程序。例如，_Termux_ 会在按下 <kbd>Ctrl</kbd>+<kbd>c</kbd> 时发送 SIGINT，又如 _K-9 Mail_ 会新建一封邮件。

要在这种情况下进行剪切，复制和粘贴 (仅支持 Android >= 7)：
 - <kbd>MOD</kbd>+<kbd>c</kbd> 注入 `COPY` (复制)
 - <kbd>MOD</kbd>+<kbd>x</kbd> 注入 `CUT` (剪切)
 - <kbd>MOD</kbd>+<kbd>v</kbd> 注入 `PASTE` (粘贴) (在电脑到设备的剪贴板同步完成之后)

另外，<kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd> 会将电脑的剪贴板内容转换为一串按键事件输入到设备。在应用程序不接受粘贴时 (比如 _Termux_)，这项功能可以派上一定的用场。不过这项功能可能会导致非 ASCII 编码的内容出现错误。

**警告：** 将电脑剪贴板的内容粘贴至设备 (无论是通过 <kbd>Ctrl</kbd>+<kbd>v</kbd> 还是 <kbd>MOD</kbd>+<kbd>v</kbd>) 都会将内容复制到设备的剪贴板。如此，任何安卓应用程序都能读取到。您应避免将敏感内容 (如密码) 通过这种方式粘贴。

一些设备不支持通过程序设置剪贴板。通过 `--legacy-paste` 选项可以修改 <kbd>Ctrl</kbd>+<kbd>v</kbd> 和 <kbd>MOD</kbd>+<kbd>v</kbd> 的工作方式，使它们通过按键事件 (同 <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd>) 来注入电脑剪贴板内容。

要禁用自动剪贴板同步功能，使用`--no-clipboard-autosync`。

#### 双指缩放

模拟“双指缩放”：<kbd>Ctrl</kbd>+_按下并拖动鼠标_。

在按住 <kbd>Ctrl</kbd> 时按下鼠标左键，直到松开鼠标左键前，移动鼠标会使屏幕内容相对于屏幕中心进行缩放或旋转 (如果应用支持)。

具体来说，_scrcpy_ 会在鼠标位置，以及鼠标以屏幕中心镜像的位置分别生成触摸事件。

#### 物理键盘模拟 (HID)

默认情况下，scrcpy 使用安卓按键或文本注入，这在任何情况都可以使用，但仅限于ASCII字符。

在 Linux 上，scrcpy 可以模拟为 Android 上的物理 USB 键盘，以提供更好地输入体验 (使用 [USB HID over AOAv2][hid-aoav2])：禁用虚拟键盘，并适用于任何字符和输入法。

[hid-aoav2]: https://source.android.com/devices/accessories/aoa2#hid-support

不过，这种方法仅支持 USB 连接以及 Linux平台。

启用 HID 模式：

```bash
scrcpy --hid-keyboard
scrcpy -K  # 简写
```

如果失败了 (如设备未通过 USB 连接)，则自动回退至默认模式 (终端中会输出日志)。这即允许通过 USB 和 TCP/IP 连接时使用相同的命令行参数。

在这种模式下，原始按键事件 (扫描码) 被发送给设备，而与宿主机按键映射无关。因此，若键盘布局不匹配，需要在 Android 设备上进行配置，具体为 设置 → 系统 → 语言和输入法 → [实体键盘]。

[实体键盘]: https://github.com/Genymobile/scrcpy/pull/2632#issuecomment-923756915

#### 物理鼠标模拟 (HID)

与物理键盘模拟类似，可以模拟一个物理鼠标。 同样，它仅在设备通过 USB 连接时才有效，并且目前仅在 Linux 上受支持。

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

启用此模式:

```bash
scrcpy --hid-mouse
scrcpy -M  # 简写
```

您还可以将 `--forward-all-clicks` 添加到 [转发所有点击][forward_all_clicks].

[forward_all_clicks]: #右键和中键

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

特殊的捕获键，<kbd>Alt</kbd> 或 <kbd>Super</kbd>，切换（禁用或启用）鼠标捕获。 使用其中之一将鼠标的控制权交还给计算机。


#### OTG

可以仅使用物理键盘和鼠标模拟 (HID) 运行 _scrcpy_，就好像计算机键盘和鼠标通过 OTG 线直接插入设备一样。

在这个模式下，_adb_ (USB 调试)是不必要的，且镜像被禁用。

启用 OTG 模式:

```bash
scrcpy --otg
# 如果有多个 USB 设备可用，则通过序列号选择
scrcpy --otg -s 0123456789abcdef
```

只开启 HID 键盘 或 HID 鼠标 是可行的：

```bash
scrcpy --otg --hid-keyboard              # 只开启 HID 键盘
scrcpy --otg --hid-mouse                 # 只开启 HID 鼠标
scrcpy --otg --hid-keyboard --hid-mouse  # 开启 HID 键盘 和 HID 鼠标
# 为了方便，默认两者都开启
scrcpy --otg                             # 开启 HID 键盘 和 HID 鼠标
```

像 `--hid-keyboard` 和 `--hid-mouse` 一样，它只在设备通过 USB 连接时才有效，且目前仅在 Linux 上支持。


#### 文本注入偏好

输入文字的时候，系统会产生两种[事件][textevents]：
 - _按键事件_ ，代表一个按键被按下或松开。
 - _文本事件_ ，代表一个字符被输入。

程序默认使用按键事件来输入字母。只有这样，键盘才会在游戏中正常运作 (例如 WASD 键)。

但这也有可能[造成一些问题][prefertext]。如果您遇到了问题，可以通过以下方式避免：

```bash
scrcpy --prefer-text
```

(但这会导致键盘在游戏中工作不正常)

相反，您可以强制始终注入原始按键事件：

```bash
scrcpy --raw-key-events
```

该选项不影响 HID 键盘 (该模式下，所有按键都发送为扫描码)。

[textevents]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-text-input
[prefertext]: https://github.com/Genymobile/scrcpy/issues/650#issuecomment-512945343


#### 按键重复

默认状态下，按住一个按键不放会生成多个重复按键事件。在某些游戏中这通常没有实际用途，且可能会导致性能问题。

避免转发重复按键事件：

```bash
scrcpy --no-key-repeat
```

该选项不影响 HID 键盘 (该模式下，按键重复由 Android 直接管理)。

#### 右键和中键

默认状态下，右键会触发返回键 (或电源键开启)，中键会触发 HOME 键。要禁用这些快捷键并把所有点击转发到设备：

```bash
scrcpy --forward-all-clicks
```


### 文件拖放

#### 安装APK

将 APK 文件 (文件名以 `.apk` 结尾) 拖放到 _scrcpy_ 窗口来安装。

不会有视觉反馈，终端会输出一条日志。


#### 将文件推送至设备

要推送文件到设备的 `/sdcard/Download/`，将 (非 APK) 文件拖放至 _scrcpy_ 窗口。

不会有视觉反馈，终端会输出一条日志。

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

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


### 音频转发

_Scrcpy_ 不支持音频。请使用 [sndcpy]。

另见 [issue #14]。

[sndcpy]: https://github.com/rom1v/sndcpy
[issue #14]: https://github.com/Genymobile/scrcpy/issues/14


## 快捷键

在以下列表中, <kbd>MOD</kbd> 是快捷键的修饰键。
默认是 (左) <kbd>Alt</kbd> 或 (左) <kbd>Super</kbd>。

您可以使用 `--shortcut-mod` 来修改。可选的按键有 `lctrl`、`rctrl`、`lalt`、`ralt`、`lsuper` 和 `rsuper`。例如：

```bash
# 使用右 Ctrl 键
scrcpy --shortcut-mod=rctrl

# 使用左 Ctrl 键 + 左 Alt 键，或 Super 键
scrcpy --shortcut-mod=lctrl+lalt,lsuper
```

_<kbd>[Super]</kbd> 键通常是指 <kbd>Windows</kbd> 或 <kbd>Cmd</kbd> 键。_

[Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button)

 | 操作                              | 快捷键
 | --------------------------------- | :-------------------------------------------
 | 全屏                              | <kbd>MOD</kbd>+<kbd>f</kbd>
 | 向左旋转屏幕                      | <kbd>MOD</kbd>+<kbd>←</kbd> _(左箭头)_
 | 向右旋转屏幕                      | <kbd>MOD</kbd>+<kbd>→</kbd> _(右箭头)_
 | 将窗口大小重置为1:1 (匹配像素)    | <kbd>MOD</kbd>+<kbd>g</kbd>
 | 将窗口大小重置为消除黑边          | <kbd>MOD</kbd>+<kbd>w</kbd> \| _双击左键¹_
 | 点按 `主屏幕`                     | <kbd>MOD</kbd>+<kbd>h</kbd> \| _中键_
 | 点按 `返回`                       | <kbd>MOD</kbd>+<kbd>b</kbd> \| _右键²_
 | 点按 `切换应用`                   | <kbd>MOD</kbd>+<kbd>s</kbd> \| _第4键³_
 | 点按 `菜单` (解锁屏幕)⁴           | <kbd>MOD</kbd>+<kbd>m</kbd>
 | 点按 `音量+`                      | <kbd>MOD</kbd>+<kbd>↑</kbd> _(上箭头)_
 | 点按 `音量-`                      | <kbd>MOD</kbd>+<kbd>↓</kbd> _(下箭头)_
 | 点按 `电源`                       | <kbd>MOD</kbd>+<kbd>p</kbd>
 | 打开屏幕                          | _鼠标右键²_
 | 关闭设备屏幕 (但继续在电脑上显示) | <kbd>MOD</kbd>+<kbd>o</kbd>
 | 打开设备屏幕                      | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>o</kbd>
 | 旋转设备屏幕                      | <kbd>MOD</kbd>+<kbd>r</kbd>
 | 展开通知面板                      | <kbd>MOD</kbd>+<kbd>n</kbd> \| _第5键³_
 | 展开设置面板                      | <kbd>MOD</kbd>+<kbd>n</kbd>+<kbd>n</kbd> \| _双击第5键³_
 | 收起通知面板                      | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>n</kbd>
 | 复制到剪贴板⁵                     | <kbd>MOD</kbd>+<kbd>c</kbd>
 | 剪切到剪贴板⁵                     | <kbd>MOD</kbd>+<kbd>x</kbd>
 | 同步剪贴板并粘贴⁵                 | <kbd>MOD</kbd>+<kbd>v</kbd>
 | 注入电脑剪贴板文本                | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd>
 | 打开/关闭FPS显示 (至标准输出)     | <kbd>MOD</kbd>+<kbd>i</kbd>
 | 捏拉缩放                          | <kbd>Ctrl</kbd>+_按住并移动鼠标_
 | 拖放 APK 文件                     | 从电脑安装 APK 文件
 | 拖放非 APK 文件                   | [将文件推送至设备](#push-file-to-device)

_¹双击黑边可以去除黑边。_  
_²点击鼠标右键将在屏幕熄灭时点亮屏幕，其余情况则视为按下返回键 。_  
_³鼠标的第4键和第5键。_  
_⁴对于开发中的 react-native 应用程序，`MENU` 触发开发菜单。_  
_⁵需要安卓版本 Android >= 7。_

有重复按键的快捷键通过松开再按下一个按键来进行，如“展开设置面板”：

 1. 按下 <kbd>MOD</kbd> 不放。
 2. 双击 <kbd>n</kbd>。
 3. 松开 <kbd>MOD</kbd>。

所有的 <kbd>Ctrl</kbd>+_按键_ 的快捷键都会被转发到设备，所以会由当前应用程序进行处理。


## 自定义路径

要使用指定的 _adb_ 二进制文件，可以设置环境变量 `ADB`：

```bash
ADB=/path/to/adb scrcpy
```

要覆盖 `scrcpy-server` 的路径，可以设置 `SCRCPY_SERVER_PATH`。

要覆盖图标，可以设置其路径至 `SCRCPY_ICON_PATH`。


## 为什么叫 _scrcpy_ ？

一个同事让我找出一个和 [gnirehtet] 一样难以发音的名字。

[`strcpy`] 源于 **str**ing （字符串）； `scrcpy` 源于 **scr**een （屏幕）。

[gnirehtet]: https://github.com/Genymobile/gnirehtet
[`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html


## 如何构建？

请查看 [BUILD]。


## 常见问题

请查看 [FAQ](FAQ.md)。


## 开发者

请查看[开发者页面]。

[开发者页面]: DEVELOP.md


## 许可协议

    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.

## 相关文章

- [Introducing scrcpy][article-intro]
- [Scrcpy now works wirelessly][article-tcpip]

[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/