diff --git a/README.md b/README.md index c38ac2cf..759e7920 100644 --- a/README.md +++ b/README.md @@ -801,7 +801,7 @@ This README is available in other languages: - [Indonesian (Indonesia, `id`) - v1.16](README.id.md) - [한국어 (Korean, `ko`) - v1.11](README.ko.md) - [português brasileiro (Brazilian Portuguese, `pt-BR`) - v1.17](README.pt-br.md) -- [简体中文 (Simplified Chinese, `zh-Hans`) - v1.16](README.zh-Hans.md) +- [简体中文 (Simplified Chinese, `zh-Hans`) - v1.17](README.zh-Hans.md) - [繁體中文 (Traditional Chinese, `zh-Hant`) - v1.15](README.zh-Hant.md) Only this README file is guaranteed to be up-to-date. diff --git a/README.zh-Hans.md b/README.zh-Hans.md index 3774c5d9..e758c18d 100644 --- a/README.zh-Hans.md +++ b/README.zh-Hans.md @@ -2,115 +2,111 @@ _Only the original [README](README.md) is guaranteed to be up-to-date._ 只有原版的[README](README.md)会保持最新。 -本文根据[479d10d]进行翻译。 +本文根据[ed130e05]进行翻译。 -[479d10d]: https://github.com/Genymobile/scrcpy/commit/479d10dc22b70272187e0963c6ad24d754a669a2#diff-04c6e90faac2675aa89e2176d2eec7d8 +[ed130e05]: https://github.com/Genymobile/scrcpy/blob/ed130e05d55615d6014d93f15cfcb92ad62b01d8/README.md +# scrcpy (v1.17) - -# scrcpy (v1.16) - -本应用程序可以通过USB（或 [TCP/IP][article-tcpip] ）连接用于显示或控制安卓设备。这不需要获取 _root_ 权限。 - -该应用程序可以在 _GNU/Linux_, _Windows_ 和 _macOS_ 环境下运行。 - -[article-tcpip]:https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/ +本应用程序可以显示并控制通过 USB (或 [TCP/IP][article-tcpip]) 连接的安卓设备，且不需要任何 _root_ 权限。本程序支持 _GNU/Linux_, _Windows_ 和 _macOS_。 ![screenshot](assets/screenshot-debian-600.jpg) 它专注于： - - **轻量** （原生，仅显示设备屏幕） - - **性能** （30~60fps） - - **质量** （分辨率可达1920x1080或更高） - - **低延迟** (35-70ms) - - **快速启动** （数秒内即能开始显示） - - **无侵入性** （不需要在安卓设备上安装任何程序） + - **轻量** (原生，仅显示设备屏幕) + - **性能** (30~60fps) + - **质量** (分辨率可达 1920×1080 或更高) + - **低延迟** ([35~70ms][lowlatency]) + - **快速启动** (最快 1 秒内即可显示第一帧) + - **无侵入性** (不会在设备上遗留任何程序) + +[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646 -## 使用要求 +## 系统要求 -安卓设备系统版本需要在Android 5.0（API 21)或以上。 +安卓设备最低需要支持 API 21 (Android 5.0)。 -确保您在设备上开启了[adb调试]。 +确保设备已[开启 adb 调试][enable-adb]。 -[adb调试]: https://developer.android.com/studio/command-line/adb.html#Enabling +[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling -在某些设备上，你还需要开启[额外的选项]以用鼠标和键盘进行控制。 +在某些设备上，还需要开启[额外的选项][control]以使用鼠标和键盘进行控制。 -[额外的选项]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323 +[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323 -## 获取scrcpy +## 获取本程序 Packaging status ### Linux -在Debian（目前仅测试版和不稳定版，即 _testing_ 和 _sid_ 版本）和Ubuntu （20.04）上： +在 Debian (目前仅支持 _testing_ 和 _sid_ 分支) 和Ubuntu (20.04) 上： ``` apt install scrcpy ``` -[Snap]包也是可用的： [`scrcpy`][snap-link]. +我们也提供 [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]. +对 Fedora 我们提供 [COPR] 包： [`scrcpy`][copr-link]。 [COPR]: https://fedoraproject.org/wiki/Category:Copr [copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/ -对于Arch Linux用户，我们提供[AUR]包： [`scrcpy`][aur-link]. +对 Arch Linux 我们提供 [AUR] 包： [`scrcpy`][aur-link]。 [AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository [aur-link]: https://aur.archlinux.org/packages/scrcpy/ -对于Gentoo用户，我们提供[Ebuild]包：[`scrcpy/`][ebuild-link]. +对 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] (不必担心，这并不困难)。 ### Windows -在Windows上，简便起见，我们准备了包含所有依赖项（包括adb）的程序包。 +在 Windows 上，简便起见，我们提供包含了所有依赖 (包括 `adb`) 的预编译包。 - - [`scrcpy-win64-v1.16.zip`][direct-win64] - _(SHA-256: 3f30dc5db1a2f95c2b40a0f5de91ec1642d9f53799250a8c529bc882bc0918f0)_ + - [`scrcpy-win64-v1.17.zip`][direct-win64] + _(SHA-256: 8b9e57993c707367ed10ebfe0e1ef563c7a29d9af4a355cd8b6a52a317c73eea)_ -[direct-win64]: https://github.com/Genymobile/scrcpy/releases/download/v1.16/scrcpy-win64-v1.16.zip +[direct-win64]: https://github.com/Genymobile/scrcpy/releases/download/v1.17/scrcpy-win64-v1.17.zip -您也可以在[Chocolatey]下载： +也可以使用 [Chocolatey]： [Chocolatey]: https://chocolatey.org/ ```bash choco install scrcpy -choco install adb # 如果你没有adb +choco install adb # 如果还没有 adb ``` -也可以使用 [Scoop]: +或者 [Scoop]: ```bash scoop install scrcpy -scoop install adb # 如果你没有adb +scoop install adb # 如果还没有 adb ``` [Scoop]: https://scoop.sh -您也可以[自行编译][编译]。 +您也可以[自行构建][BUILD]。 ### macOS -您可以使用[Homebrew]下载scrcpy。直接安装就可以了： +本程序已发布到 [Homebrew]。直接安装即可： [Homebrew]: https://brew.sh/ @@ -118,24 +114,28 @@ scoop install adb # 如果你没有adb brew install scrcpy ``` -您需要 `adb`以使用scrcpy，并且它需要可以通过 `PATH`被访问。如果您没有： +你还需要在 `PATH` 内有 `adb`。如果还没有： ```bash +# Homebrew >= 2.6.0 +brew install --cask android-platform-tools + +# Homebrew < 2.6.0 brew cask install android-platform-tools ``` -您也可以[自行编译][编译]。 +您也可以[自行构建][BUILD]。 -## 运行scrcpy +## 运行 -用USB链接电脑和安卓设备，并执行： +连接安卓设备，然后执行： ```bash scrcpy ``` -支持带命令行参数执行，查看参数列表： +本程序支持命令行参数，查看参数列表： ```bash scrcpy --help @@ -143,111 +143,129 @@ scrcpy --help ## 功能介绍 -### 画面设置 +### 捕获设置 -#### 缩小分辨率 +#### 降低分辨率 -有时候，将设备屏幕镜像分辨率降低可以有效地提升性能。 +有时候，可以通过降低镜像的分辨率来提高性能。 -我们可以将高度和宽度都限制在一定大小内（如 1024）： +要同时限制宽度和高度到某个值 (例如 1024)： ```bash scrcpy --max-size 1024 -scrcpy -m 1024 # short version +scrcpy -m 1024 # 简写 ``` -较短的一边会被按比例缩小以保持设备的显示比例。 -这样，1920x1080 的设备会以 1024x576 的分辨率显示。 +另一边会被按比例缩小以保持设备的显示比例。这样，1920×1080 分辨率的设备会以 1024×576 的分辨率进行镜像。 -#### 修改画面比特率 +#### 修改码率 -默认的比特率是8Mbps。如果要改变画面的比特率 (比如说改成2Mbps)： +默认码率是 8Mbps。要改变视频的码率 (例如改为 2Mbps)： ```bash scrcpy --bit-rate 2M -scrcpy -b 2M # short version +scrcpy -b 2M # 简写 ``` -#### 限制画面帧率 +#### 限制帧率 -画面的帧率可以通过下面的命令被限制： +要限制捕获的帧率： ```bash scrcpy --max-fps 15 ``` -这个功能仅在Android 10和以后的版本被Android官方支持，但也有可能在更早的版本可用。 +本功能从 Android 10 开始才被官方支持，但在一些旧版本中也能生效。 #### 画面裁剪 -设备画面可在裁切后进行镜像，以显示部分屏幕。 +可以对设备屏幕进行裁剪，只镜像屏幕的一部分。 -这项功能可以用于，例如，只显示Oculus Go的一只眼睛。 +例如可以只镜像 Oculus Go 的一只眼睛。 ```bash -scrcpy --crop 1224:1440:0:0 # 1224x1440 at offset (0,0) +scrcpy --crop 1224:1440:0:0 # 以 (0,0) 为原点的 1224x1440 像素 ``` -如果`--max-size`在同时被指定，分辨率的改变将在画面裁切后进行。 +如果同时指定了 `--max-size`，会先进行裁剪，再进行缩放。 -#### 锁定屏幕朝向 +#### 锁定屏幕方向 -可以使用如下命令锁定屏幕朝向： +要锁定镜像画面的方向： ```bash -scrcpy --lock-video-orientation 0 # 自然朝向 -scrcpy --lock-video-orientation 1 # 90° 逆时针旋转 +scrcpy --lock-video-orientation 0 # 自然方向 +scrcpy --lock-video-orientation 1 # 逆时针旋转 90° scrcpy --lock-video-orientation 2 # 180° -scrcpy --lock-video-orientation 3 # 90° 顺时针旋转 +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以停止录制 +# 按 Ctrl+C 停止录制 ``` -在显示中“被跳过的帧”会被录制，虽然它们由于性能原因没有实时显示。 -在传输中每一帧都有 _时间戳_ ，所以 [包时延变化] 并不影响录制的文件。 +录制时会包含“被跳过的帧”，即使它们由于性能原因没有实时显示。设备会为每一帧打上 _时间戳_ ，所以 [包时延抖动][packet delay variation] 不会影响录制的文件。 -[包时延变化]: https://en.wikipedia.org/wiki/Packet_delay_variation +[packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation -### 连接方式 +### 连接 #### 无线 -_Scrcpy_ 使用`adb`来与安卓设备连接。同时，`adb`能够通过TCP/IP[连接]到安卓设备: +_Scrcpy_ 使用 `adb` 与设备通信，并且 `adb` 支持通过 TCP/IP [连接]到设备: -1. 将您的安卓设备和电脑连接至同一Wi-Fi。 -2. 获取安卓设备的IP地址（在设置-关于手机-状态信息）。 -3. 打开安卓设备的网络adb功能`adb tcpip 5555`。 -4. 将您的设备与电脑断开连接。 -5. 连接到您的设备：`adb connect DEVICE_IP:5555` _(用设备IP替换 `DEVICE_IP`)_. -6. 运行`scrcpy`。 +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 # short version +scrcpy -b2M -m800 # 简写 ``` [连接]: https://developer.android.com/studio/command-line/adb.html#wireless @@ -255,18 +273,18 @@ scrcpy -b2M -m800 # short version #### 多设备 -如果多个设备在执行`adb devices`后被列出，您必须指定设备的 _序列号_ ： +如果 `adb devices` 列出了多个设备，您必须指定设备的 _序列号_ ： ```bash scrcpy --serial 0123456789abcdef -scrcpy -s 0123456789abcdef # short version +scrcpy -s 0123456789abcdef # 简写 ``` -如果设备是通过TCP/IP方式连接到电脑的： +如果设备通过 TCP/IP 连接： ```bash scrcpy --serial 192.168.0.1:5555 -scrcpy -s 192.168.0.1:5555 # short version +scrcpy -s 192.168.0.1:5555 # 简写 ``` 您可以同时启动多个 _scrcpy_ 实例以同时显示多个设备的画面。 @@ -281,38 +299,38 @@ autoadb scrcpy -s '{}' [AutoAdb]: https://github.com/rom1v/autoadb -#### SSH 连接 +#### SSH 隧道 -本地的 adb 可以远程连接到另一个 adb 服务器（假设两者的adb版本相同），来远程连接到设备： +要远程连接到设备，可以将本地的 adb 客户端连接到远程的 adb 服务端 (需要两端的 _adb_ 协议版本相同)： ```bash -adb kill-server # 关闭本地5037端口上的adb服务器 +adb kill-server # 关闭本地 5037 端口上的 adb 服务端 ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer # 保持该窗口开启 ``` -从另一个终端： +在另一个终端： ```bash scrcpy ``` -为了避免启动远程端口转发，你可以强制启动一个转发连接（注意`-L`和`-R`的区别： +若要不使用远程端口转发，可以强制使用正向连接 (注意 `-L` 和 `-R` 的区别)： ```bash -adb kill-server # kill the local adb server on 5037 +adb kill-server # 关闭本地 5037 端口上的 adb 服务端 ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer # 保持该窗口开启 ``` -从另一个终端: +在另一个终端: ```bash scrcpy --force-adb-forward ``` -和无线网络连接类似，下列设置可能对改善性能有帮助： +类似无线网络连接，可能需要降低画面质量： ``` scrcpy -b2M -m800 --max-fps 15 @@ -322,7 +340,7 @@ scrcpy -b2M -m800 --max-fps 15 #### 标题 -窗口的标题默认为设备型号。您可以通过如下命令修改它： +窗口的标题默认为设备型号。可以通过如下命令修改： ```bash scrcpy --window-title 'My device' @@ -358,14 +376,14 @@ scrcpy --always-on-top ```bash scrcpy --fullscreen -scrcpy -f # short version +scrcpy -f # 简写 ``` -全屏状态可以通过MOD+f实时改变。 +全屏状态可以通过 MOD+f 随时切换。 #### 旋转 -通过如下命令，窗口可以旋转： +可以通过以下命令旋转窗口： ```bash scrcpy --rotation 1 @@ -373,27 +391,23 @@ scrcpy --rotation 1 可选的值有： - `0`: 无旋转 - - `1`: 逆时针旋转90° - - `2`: 旋转180° - - `3`: 顺时针旋转90° + - `1`: 逆时针旋转 90° + - `2`: 旋转 180° + - `3`: 顺时针旋转 90° -这同样可以使用MOD+← -_(左)_ 和 MOD+→ _(右)_ 的快捷键实时更改。 +也可以使用 MOD+← _(左箭头)_ 和 MOD+→ _(右箭头)_ 随时更改。 -需要注意的是， _scrcpy_ 控制三个不同的朝向： - - MOD+r 请求设备在竖屏和横屏之间切换（如果前台应用程序不支持所请求的朝向，可能会拒绝该请求）。 - - - `--lock-video-orientation` 改变镜像的朝向（设备镜像到电脑的画面朝向）。这会影响录制。 - - - `--rotation` （或MOD+←/MOD+→） - 只旋转窗口的画面。这只影响显示，不影响录制。 +需要注意的是， _scrcpy_ 有三个不同的方向： + - MOD+r 请求设备在竖屏和横屏之间切换 (如果前台应用程序不支持请求的朝向，可能会拒绝该请求)。 + - [`--lock-video-orientation`](#锁定屏幕方向) 改变镜像的朝向 (设备传输到电脑的画面的朝向)。这会影响录制。 + - `--rotation` (或 MOD+←/MOD+→) 只旋转窗口的内容。这只影响显示，不影响录制。 ### 其他镜像设置 #### 只读 -关闭电脑对设备的控制（如键盘输入、鼠标移动和文件传输）： +禁用电脑对设备的控制 (如键盘输入、鼠标事件和文件拖放)： ```bash scrcpy --no-control @@ -402,53 +416,49 @@ scrcpy -n #### 显示屏 -如果有多个显示屏可用，您可以选择特定显示屏进行镜像： +如果设备有多个显示屏，可以选择要镜像的显示屏： ```bash scrcpy --display 1 ``` -您可以通过如下命令找到显示屏的id： +可以通过如下命令列出所有显示屏的 id： ``` -adb shell dumpsys display # 在回显中搜索“mDisplayId=” +adb shell dumpsys display # 在输出中搜索 “mDisplayId=” ``` -第二显示屏可能只能在设备运行Android 10或以上的情况下被控制（它可能会在电脑上显示，但无法通过电脑操作）。 +控制第二显示屏需要设备运行 Android 10 或更高版本 (否则将在只读状态下镜像)。 #### 保持常亮 -防止设备在已连接的状态下休眠： +阻止设备在连接时休眠： ```bash scrcpy --stay-awake scrcpy -w ``` -程序关闭后，设备设置会恢复原样。 +程序关闭时会恢复设备原来的设置。 #### 关闭设备屏幕 -在启动屏幕镜像时，可以通过如下命令关闭设备的屏幕： +可以通过以下的命令行参数在关闭设备屏幕的状态下进行镜像： ```bash scrcpy --turn-screen-off scrcpy -S ``` -或者在需要的时候按MOD+o。 +或者在任何时候按 MOD+o。 -要重新打开屏幕的话，需要按MOD+Shift+o. +要重新打开屏幕，按下 MOD+Shift+o. -在Android上,`电源`按钮始终能把屏幕打开。 +在Android上，`电源` 按钮始终能把屏幕打开。为了方便，对于在 _scrcpy_ 中发出的 `电源` 事件 (通过鼠标右键或 MOD+p)，会 (尽最大的努力) 在短暂的延迟后将屏幕关闭。设备上的 `电源` 按钮仍然能打开设备屏幕。 -为了方便，如果按下`电源`按钮的事件是通过 _scrcpy_ 发出的（通过点按鼠标右键或MOD+p），它会在短暂的延迟后将屏幕关闭。 - -物理的`电源`按钮仍然能打开设备屏幕。 - -同时，这项功能还能被用于防止设备休眠： +还可以同时阻止设备休眠： ```bash scrcpy --turn-screen-off --stay-awake @@ -456,11 +466,11 @@ scrcpy -Sw ``` -#### 渲染超时帧 +#### 渲染过期帧 -为了降低延迟， _scrcpy_ 默认渲染解码成功的最近一帧，并跳过前面任意帧。 +默认状态下，为了降低延迟， _scrcpy_ 永远渲染解码成功的最近一帧，并跳过前面任意帧。 -强制渲染所有帧（可能导致延迟变高）： +强制渲染所有帧 (可能导致延迟变高)： ```bash scrcpy --render-expired-frames @@ -468,9 +478,9 @@ scrcpy --render-expired-frames #### 显示触摸 -在展示时，有些时候可能会用到显示触摸点这项功能（在设备上显示）。 +在演示时，可能会需要显示物理触摸点 (在物理设备上的触摸点)。 -Android在 _开发者设置_ 中提供了这项功能。 +Android 在 _开发者选项_ 中提供了这项功能。 _Scrcpy_ 提供一个选项可以在启动时开启这项功能并在退出时恢复初始设置： @@ -479,12 +489,12 @@ scrcpy --show-touches scrcpy -t ``` -请注意这项功能只能显示 _物理_ 触摸（要用手在屏幕上触摸）。 +请注意这项功能只能显示 _物理_ 触摸 (用手指在屏幕上的触摸)。 #### 关闭屏保 -_Scrcpy_ 不会默认关闭屏幕保护。 +_Scrcpy_ 默认不会阻止电脑上开启的屏幕保护。 关闭屏幕保护： @@ -497,64 +507,58 @@ scrcpy --disable-screensaver #### 旋转设备屏幕 -使用MOD+r以在竖屏和横屏模式之间切换。 +使用 MOD+r 在竖屏和横屏模式之间切换。 需要注意的是，只有在前台应用程序支持所要求的模式时，才会进行切换。 -#### 复制黏贴 +#### 复制粘贴 -每次Android的剪贴板变化的时候，它都会被自动同步到电脑的剪贴板上。 +每次安卓的剪贴板变化时，其内容都会被自动同步到电脑的剪贴板上。 所有的 Ctrl 快捷键都会被转发至设备。其中： - - Ctrl+c 复制 - - Ctrl+x 剪切 - - Ctrl+v 黏贴 （在电脑到设备的剪贴板同步完成之后） + - Ctrl+c 通常执行复制 + - Ctrl+x 通常执行剪切 + - Ctrl+v 通常执行粘贴 (在电脑到设备的剪贴板同步完成之后) -这通常如您所期望的那样运作。 +大多数时候这些按键都会执行以上的功能。 -但实际的行为取决于设备上的前台程序。 -例如 _Termux_ 在Ctrl+c被按下时发送 SIGINT， -又如 _K-9 Mail_ 会新建一封新邮件。 +但实际的行为取决于设备上的前台程序。例如，_Termux_ 会在按下 Ctrl+c 时发送 SIGINT，又如 _K-9 Mail_ 会新建一封邮件。 -在这种情况下剪切复制黏贴（仅在Android >= 7时可用）： - - MOD+c 注入 `COPY`（复制） - - MOD+x 注入 `CUT`（剪切） - - MOD+v 注入 `PASTE`（黏贴）（在电脑到设备的剪贴板同步完成之后） +要在这种情况下进行剪切，复制和粘贴 (仅支持 Android >= 7)： + - MOD+c 注入 `COPY` (复制) + - MOD+x 注入 `CUT` (剪切) + - MOD+v 注入 `PASTE` (粘贴) (在电脑到设备的剪贴板同步完成之后) -另外，MOD+Shift+v可以将电脑的剪贴板内容转换为一串按键事件输入到设备。 -在应用程序不接受黏贴时（比如 _Termux_ ），这项功能可以排上一定的用场。 -需要注意的是，这项功能可能会导致非ASCII编码的内容出现错误。 +另外，MOD+Shift+v 会将电脑的剪贴板内容转换为一串按键事件输入到设备。在应用程序不接受粘贴时 (比如 _Termux_)，这项功能可以派上一定的用场。不过这项功能可能会导致非 ASCII 编码的内容出现错误。 -**警告：** 将电脑剪贴板的内容黏贴至设备（无论是通过Ctrl+v还是MOD+v） -都需要将内容保存至设备的剪贴板。如此，任何一个应用程序都可以读取它。 -您应当避免将敏感内容通过这种方式传输（如密码）。 +**警告：** 将电脑剪贴板的内容粘贴至设备 (无论是通过 Ctrl+v 还是 MOD+v) 都会将内容复制到设备的剪贴板。如此，任何安卓应用程序都能读取到。您应避免将敏感内容 (如密码) 通过这种方式粘贴。 +一些设备不支持通过程序设置剪贴板。通过 `--legacy-paste` 选项可以修改 Ctrl+v 和 MOD+v 的工作方式，使它们通过按键事件 (同 MOD+Shift+v) 来注入电脑剪贴板内容。 -#### 捏拉缩放 +#### 双指缩放 -模拟 “捏拉缩放”：Ctrl+_按住并移动鼠标_。 +模拟“双指缩放”：Ctrl+_按住并移动鼠标_。 -更准确的说，您需要在按住Ctrl的同时按住并移动鼠标。 -在鼠标左键松开之后，光标的任何操作都会相对于屏幕的中央进行。 +更准确的说，在按住鼠标左键时按住 Ctrl。直到松开鼠标左键，所有鼠标移动将以屏幕中心为原点，缩放或旋转内容 (如果应用支持)。 -具体来说， _scrcpy_ 使用“虚拟手指”以在相对于屏幕中央相反的位置产生触摸事件。 +实际上，_scrcpy_ 会在以屏幕中心对称的位置上生成由“虚拟手指”发出的额外触摸事件。 #### 文字注入偏好 打字的时候，系统会产生两种[事件][textevents]： - - _按键事件_ ，代表一个按键被按下/松开。 - - _文本事件_ ，代表一个文本被输入。 + - _按键事件_ ，代表一个按键被按下或松开。 + - _文本事件_ ，代表一个字符被输入。 -程序默认使用按键事件来输入字母。只有这样，键盘才会在游戏中正常运作（尤其WASD键）。 +程序默认使用按键事件来输入字母。只有这样，键盘才会在游戏中正常运作 (例如 WASD 键)。 -但这也有可能[造成问题][prefertext]。如果您遇到了这样的问题，您可以通过下列操作避免它： +但这也有可能[造成一些问题][prefertext]。如果您遇到了问题，可以通过以下方式避免： ```bash scrcpy --prefer-text ``` -（这会导致键盘在游戏中工作不正常） +(这会导致键盘在游戏中工作不正常) [textevents]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-text-input [prefertext]: https://github.com/Genymobile/scrcpy/issues/650#issuecomment-512945343 @@ -562,8 +566,7 @@ scrcpy --prefer-text #### 按键重复 -当你一直按着一个按键不放时，程序默认产生多个按键事件。 -在某些游戏中这可能会导致性能问题。 +默认状态下，按住一个按键不放会生成多个重复按键事件。在某些游戏中这可能会导致性能问题。 避免转发重复按键事件： @@ -572,18 +575,27 @@ scrcpy --no-key-repeat ``` -### 文件传输 +#### 右键和中键 + +默认状态下，右键会触发返回键 (或电源键)，中键会触发 HOME 键。要禁用这些快捷键并把所有点击转发到设备： + +```bash +scrcpy --forward-all-clicks +``` + + +### 文件拖放 #### 安装APK -如果您要要安装APK，请拖放APK文件（文件名以`.apk`结尾）到 _scrcpy_ 窗口。 +将 APK 文件 (文件名以 `.apk` 结尾) 拖放到 _scrcpy_ 窗口来安装。 该操作在屏幕上不会出现任何变化，而会在控制台输出一条日志。 #### 将文件推送至设备 -如果您要推送文件到设备的 `/sdcard/`，请拖放文件至（不能是APK文件）_scrcpy_ 窗口。 +要推送文件到设备的 `/sdcard/`，将 (非 APK) 文件拖放至 _scrcpy_ 窗口。 该操作没有可见的响应，只会在控制台输出日志。 @@ -596,7 +608,7 @@ scrcpy --push-target /sdcard/foo/bar/ ### 音频转发 -_scrcpy_ 不支持音频。请使用 [sndcpy]. +_Scrcpy_ 不支持音频。请使用 [sndcpy]. 另外请阅读 [issue #14]。 @@ -604,93 +616,90 @@ _scrcpy_ 不支持音频。请使用 [sndcpy]. [issue #14]: https://github.com/Genymobile/scrcpy/issues/14 -## 热键 +## 快捷键 -在下列表格中, MOD 是热键的修饰键。 -默认是（左）Alt或者（左）Super。 +在以下列表中, MOD 是快捷键的修饰键。 +默认是 (左) Alt 或 (左) Super。 -您可以使用 `--shortcut-mod`后缀来修改它。可选的按键有`lctrl`、`rctrl`、 -`lalt`、`ralt`、`lsuper`和`rsuper`。如下例： +您可以使用 `--shortcut-mod` 来修改。可选的按键有 `lctrl`、`rctrl`、`lalt`、`ralt`、`lsuper` 和 `rsuper`。例如： ```bash -# 使用右侧的Ctrl键 +# 使用右 Ctrl 键 scrcpy --shortcut-mod=rctrl -# 使用左侧的Ctrl键、Alt键或Super键 +# 使用左 Ctrl 键 + 左 Alt 键，或 Super 键 scrcpy --shortcut-mod=lctrl+lalt,lsuper ``` -_一般来说，[Super]就是Windows或者Cmd。_ +_[Super] 键通常是指 Windows 或 Cmd 键。_ [Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button) - | 操作 | 快捷键 - | ------------------------------------------- |:----------------------------- - | 全屏 | MOD+f - | 向左旋转屏幕 | MOD+← _(左)_ - | 向右旋转屏幕 | MOD+→ _(右)_ - | 将窗口大小重置为1:1 (像素优先) | MOD+g - | 将窗口大小重置为消除黑边 | MOD+w \| _双击¹_ - | 点按 `主屏幕` | MOD+h \| _点击鼠标中键_ - | 点按 `返回` | MOD+b \| _点击鼠标右键²_ - | 点按 `切换应用` | MOD+s - | 点按 `菜单` （解锁屏幕） | MOD+m - | 点按 `音量+` | MOD+↑ _(up)_ - | 点按 `音量-` | MOD+↓ _(down)_ - | 点按 `电源` | MOD+p - | 打开屏幕 | _点击鼠标右键²_ - | 关闭设备屏幕（但继续在电脑上显示） | MOD+o - | 打开设备屏幕 | MOD+Shift+o - | 旋转设备屏幕 | MOD+r - | 展开通知面板 | MOD+n - | 展开快捷操作 | MOD+Shift+n - | 复制到剪贴板³ | MOD+c - | 剪切到剪贴板³ | MOD+x - | 同步剪贴板并黏贴³ | MOD+v - | 导入电脑剪贴板文本 | MOD+Shift+v - | 打开/关闭FPS显示（在 stdout) | MOD+i - | 捏拉缩放 | Ctrl+_点按并移动鼠标_ + | 操作 | 快捷键 | + | --------------------------------- | :------------------------------------------- | + | 全屏 | MOD+f | + | 向左旋转屏幕 | MOD+← _(左箭头)_ | + | 向右旋转屏幕 | MOD+→ _(右箭头)_ | + | 将窗口大小重置为1:1 (匹配像素) | MOD+g | + | 将窗口大小重置为消除黑边 | MOD+w \| _双击¹_ | + | 点按 `主屏幕` | MOD+h \| _鼠标中键_ | + | 点按 `返回` | MOD+b \| _鼠标右键²_ | + | 点按 `切换应用` | MOD+s | + | 点按 `菜单` (解锁屏幕) | MOD+m | + | 点按 `音量+` | MOD+↑ _(上箭头)_ | + | 点按 `音量-` | MOD+↓ _(下箭头)_ | + | 点按 `电源` | MOD+p | + | 打开屏幕 | _鼠标右键²_ | + | 关闭设备屏幕 (但继续在电脑上显示) | MOD+o | + | 打开设备屏幕 | MOD+Shift+o | + | 旋转设备屏幕 | MOD+r | + | 展开通知面板 | MOD+n | + | 收起通知面板 | MOD+Shift+n | + | 复制到剪贴板³ | MOD+c | + | 剪切到剪贴板³ | MOD+x | + | 同步剪贴板并粘贴³ | MOD+v | + | 注入电脑剪贴板文本 | MOD+Shift+v | + | 打开/关闭FPS显示 (在 stdout) | MOD+i | + | 捏拉缩放 | Ctrl+_按住并移动鼠标_ | -_¹双击黑色边界以关闭黑色边界_ -_²点击鼠标右键将在屏幕熄灭时点亮屏幕，其余情况则视为按下 返回键 。_ +_¹双击黑边可以去除黑边_ +_²点击鼠标右键将在屏幕熄灭时点亮屏幕，其余情况则视为按下返回键 。_ _³需要安卓版本 Android >= 7。_ -所有的 Ctrl+_按键_ 的热键都是被转发到设备进行处理的，所以实际上会由当前应用程序对其做出响应。 +所有的 Ctrl+_按键_ 的快捷键都会被转发到设备，所以会由当前应用程序进行处理。 ## 自定义路径 -为了使用您想使用的 _adb_ ，您可以在环境变量 -`ADB`中设置它的路径： +要使用指定的 _adb_ 二进制文件，可以设置环境变量 `ADB`： ADB=/path/to/adb scrcpy -如果需要覆盖`scrcpy-server`的路径，您可以在 -`SCRCPY_SERVER_PATH`中设置它。 +要覆盖 `scrcpy-server` 的路径，可以设置 `SCRCPY_SERVER_PATH`。 [useful]: https://github.com/Genymobile/scrcpy/issues/278#issuecomment-429330345 ## 为什么叫 _scrcpy_ ？ -一个同事让我找出一个和[gnirehtet]一样难以发音的名字。 +一个同事让我找出一个和 [gnirehtet] 一样难以发音的名字。 -[`strcpy`] 可以复制**str**ing； `scrcpy` 可以复制**scr**een。 +[`strcpy`] 复制一个 **str**ing； `scrcpy` 复制一个 **scr**een。 [gnirehtet]: https://github.com/Genymobile/gnirehtet [`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html -## 如何编译？ +## 如何构建？ -请查看[编译]。 +请查看[BUILD]。 -[编译]: BUILD.md +[BUILD]: BUILD.md ## 常见问题 -请查看[FAQ](FAQ.md). +请查看[FAQ](FAQ.md)。 ## 开发者