Display and control your Android device
Update README.zh-Hans to v1.17
Simon Chance43fad645d4
diff --git a/README.md b/README.mdindex 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.mdindex 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_。它专注于:- - **轻量** (原生,仅显示设备屏幕)- - **性能** (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)或以上。+## 系统要求-确保您在设备上开启了[adb调试]。+安卓设备最低需要支持 API 21 (Android 5.0)。-[adb调试]: https://developer.android.com/studio/command-line/adb.html#Enabling+确保设备已[开启 adb 调试][enable-adb]。-在某些设备上,你还需要开启[额外的选项]以用鼠标和键盘进行控制。+[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling-[额外的选项]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323+在某些设备上,还需要开启[额外的选项][control]以使用鼠标和键盘进行控制。+[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323-## 获取scrcpy++## 获取本程序<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-在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/```bashchoco install scrcpy-choco install adb # 如果你没有adb+choco install adb # 如果还没有 adb```-也可以使用 [Scoop]:+或者 [Scoop]:```bashscoop 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 # 如果你没有adbbrew install scrcpy```-您需要 `adb`以使用scrcpy,并且它需要可以通过 `PATH`被访问。如果您没有:+你还需要在 `PATH` 内有 `adb`。如果还没有:```bash+# Homebrew >= 2.6.0+brew install --cask android-platform-tools++# Homebrew < 2.6.0brew cask install android-platform-tools```-您也可以[自行编译][编译]。+您也可以[自行构建][BUILD]。-## 运行scrcpy+## 运行-用USB链接电脑和安卓设备,并执行:+连接安卓设备,然后执行:```bashscrcpy```-支持带命令行参数执行,查看参数列表:+本程序支持命令行参数,查看参数列表:```bashscrcpy --help@@ -143,111 +143,129 @@ scrcpy --help## 功能介绍-### 画面设置+### 捕获设置-#### 缩小分辨率+#### 降低分辨率-有时候,将设备屏幕镜像分辨率降低可以有效地提升性能。+有时候,可以通过降低镜像的分辨率来提高性能。-我们可以将高度和宽度都限制在一定大小内(如 1024):+要同时限制宽度和高度到某个值 (例如 1024):```bashscrcpy --max-size 1024-scrcpy -m 1024 # short version+scrcpy -m 1024 # 简写```-较短的一边会被按比例缩小以保持设备的显示比例。-这样,1920x1080 的设备会以 1024x576 的分辨率显示。+另一边会被按比例缩小以保持设备的显示比例。这样,1920×1080 分辨率的设备会以 1024×576 的分辨率进行镜像。-#### 修改画面比特率+#### 修改码率-默认的比特率是8Mbps。如果要改变画面的比特率 (比如说改成2Mbps):+默认码率是 8Mbps。要改变视频的码率 (例如改为 2Mbps):```bashscrcpy --bit-rate 2M-scrcpy -b 2M # short version+scrcpy -b 2M # 简写```-#### 限制画面帧率+#### 限制帧率-画面的帧率可以通过下面的命令被限制:+要限制捕获的帧率:```bashscrcpy --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 _+```+### 屏幕录制-可以在屏幕镜像的同时录制视频:+可以在镜像的同时录制视频:```bashscrcpy --record file.mp4scrcpy -r file.mkv```-在不开启屏幕镜像的同时录制:+仅录制,不显示镜像:```bashscrcpy --no-display --record file.mp4scrcpy -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`。++可能需要降低码率和分辨率:```bashscrcpy --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` 列出了多个设备,您必须指定设备的 _序列号_ :```bashscrcpy --serial 0123456789abcdef-scrcpy -s 0123456789abcdef # short version+scrcpy -s 0123456789abcdef # 简写```-如果设备是通过TCP/IP方式连接到电脑的:+如果设备通过 TCP/IP 连接:```bashscrcpy --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# 保持该窗口开启```-从另一个终端:+在另一个终端:```bashscrcpy```-为了避免启动远程端口转发,你可以强制启动一个转发连接(注意`-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# 保持该窗口开启```-从另一个终端:+在另一个终端:```bashscrcpy --force-adb-forward```-和无线网络连接类似,下列设置可能对改善性能有帮助:+类似无线网络连接,可能需要降低画面质量:```scrcpy -b2M -m800 --max-fps 15@@ -322,7 +340,7 @@ scrcpy -b2M -m800 --max-fps 15#### 标题-窗口的标题默认为设备型号。您可以通过如下命令修改它:+窗口的标题默认为设备型号。可以通过如下命令修改:```bashscrcpy --window-title 'My device'@@ -358,14 +376,14 @@ scrcpy --always-on-top```bashscrcpy --fullscreen-scrcpy -f # short version+scrcpy -f # 简写```-全屏状态可以通过<kbd>MOD</kbd>+<kbd>f</kbd>实时改变。+全屏状态可以通过 <kbd>MOD</kbd>+<kbd>f</kbd> 随时切换。#### 旋转-通过如下命令,窗口可以旋转:+可以通过以下命令旋转窗口:```bashscrcpy --rotation 1@@ -373,27 +391,23 @@ scrcpy --rotation 1可选的值有:- `0`: 无旋转- - `1`: 逆时针旋转90°- - `2`: 旋转180°- - `3`: 顺时针旋转90°--这同样可以使用<kbd>MOD</kbd>+<kbd>←</kbd>-_(左)_ 和 <kbd>MOD</kbd>+<kbd>→</kbd> _(右)_ 的快捷键实时更改。+ - `1`: 逆时针旋转 90°+ - `2`: 旋转 180°+ - `3`: 顺时针旋转 90°-需要注意的是, _scrcpy_ 控制三个不同的朝向:- - <kbd>MOD</kbd>+<kbd>r</kbd> 请求设备在竖屏和横屏之间切换(如果前台应用程序不支持所请求的朝向,可能会拒绝该请求)。+也可以使用 <kbd>MOD</kbd>+<kbd>←</kbd> _(左箭头)_ 和 <kbd>MOD</kbd>+<kbd>→</kbd> _(右箭头)_ 随时更改。- - `--lock-video-orientation` 改变镜像的朝向(设备镜像到电脑的画面朝向)。这会影响录制。-- - `--rotation` (或<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>) 只旋转窗口的内容。这只影响显示,不影响录制。### 其他镜像设置#### 只读-关闭电脑对设备的控制(如键盘输入、鼠标移动和文件传输):+禁用电脑对设备的控制 (如键盘输入、鼠标事件和文件拖放):```bashscrcpy --no-control@@ -402,53 +416,49 @@ scrcpy -n#### 显示屏-如果有多个显示屏可用,您可以选择特定显示屏进行镜像:+如果设备有多个显示屏,可以选择要镜像的显示屏:```bashscrcpy --display 1```-您可以通过如下命令找到显示屏的id:+可以通过如下命令列出所有显示屏的 id:```-adb shell dumpsys display # 在回显中搜索“mDisplayId=”+adb shell dumpsys display # 在输出中搜索 “mDisplayId=”```-第二显示屏可能只能在设备运行Android 10或以上的情况下被控制(它可能会在电脑上显示,但无法通过电脑操作)。+控制第二显示屏需要设备运行 Android 10 或更高版本 (否则将在只读状态下镜像)。#### 保持常亮-防止设备在已连接的状态下休眠:+阻止设备在连接时休眠:```bashscrcpy --stay-awakescrcpy -w```-程序关闭后,设备设置会恢复原样。+程序关闭时会恢复设备原来的设置。#### 关闭设备屏幕-在启动屏幕镜像时,可以通过如下命令关闭设备的屏幕:+可以通过以下的命令行参数在关闭设备屏幕的状态下进行镜像:```bashscrcpy --turn-screen-offscrcpy -S```-或者在需要的时候按<kbd>MOD</kbd>+<kbd>o</kbd>。--要重新打开屏幕的话,需要按<kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>o</kbd>.--在Android上,`电源`按钮始终能把屏幕打开。+或者在任何时候按 <kbd>MOD</kbd>+<kbd>o</kbd>。-为了方便,如果按下`电源`按钮的事件是通过 _scrcpy_ 发出的(通过点按鼠标右键或<kbd>MOD</kbd>+<kbd>p</kbd>),它会在短暂的延迟后将屏幕关闭。+要重新打开屏幕,按下 <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>o</kbd>.-物理的`电源`按钮仍然能打开设备屏幕。+在Android上,`电源` 按钮始终能把屏幕打开。为了方便,对于在 _scrcpy_ 中发出的 `电源` 事件 (通过鼠标右键或 <kbd>MOD</kbd>+<kbd>p</kbd>),会 (尽最大的努力) 在短暂的延迟后将屏幕关闭。设备上的 `电源` 按钮仍然能打开设备屏幕。-同时,这项功能还能被用于防止设备休眠:+还可以同时阻止设备休眠:```bashscrcpy --turn-screen-off --stay-awake@@ -456,11 +466,11 @@ scrcpy -Sw```-#### 渲染超时帧+#### 渲染过期帧-为了降低延迟, _scrcpy_ 默认渲染解码成功的最近一帧,并跳过前面任意帧。+默认状态下,为了降低延迟, _scrcpy_ 永远渲染解码成功的最近一帧,并跳过前面任意帧。-强制渲染所有帧(可能导致延迟变高):+强制渲染所有帧 (可能导致延迟变高):```bashscrcpy --render-expired-frames@@ -468,9 +478,9 @@ scrcpy --render-expired-frames#### 显示触摸-在展示时,有些时候可能会用到显示触摸点这项功能(在设备上显示)。+在演示时,可能会需要显示物理触摸点 (在物理设备上的触摸点)。-Android在 _开发者设置_ 中提供了这项功能。+Android 在 _开发者选项_ 中提供了这项功能。_Scrcpy_ 提供一个选项可以在启动时开启这项功能并在退出时恢复初始设置:@@ -479,12 +489,12 @@ scrcpy --show-touchesscrcpy -t```-请注意这项功能只能显示 _物理_ 触摸(要用手在屏幕上触摸)。+请注意这项功能只能显示 _物理_ 触摸 (用手指在屏幕上的触摸)。#### 关闭屏保-_Scrcpy_ 不会默认关闭屏幕保护。+_Scrcpy_ 默认不会阻止电脑上开启的屏幕保护。关闭屏幕保护:@@ -497,64 +507,58 @@ scrcpy --disable-screensaver#### 旋转设备屏幕-使用<kbd>MOD</kbd>+<kbd>r</kbd>以在竖屏和横屏模式之间切换。+使用 <kbd>MOD</kbd>+<kbd>r</kbd> 在竖屏和横屏模式之间切换。需要注意的是,只有在前台应用程序支持所要求的模式时,才会进行切换。-#### 复制黏贴+#### 复制粘贴-每次Android的剪贴板变化的时候,它都会被自动同步到电脑的剪贴板上。+每次安卓的剪贴板变化时,其内容都会被自动同步到电脑的剪贴板上。所有的 <kbd>Ctrl</kbd> 快捷键都会被转发至设备。其中:- - <kbd>Ctrl</kbd>+<kbd>c</kbd> 复制- - <kbd>Ctrl</kbd>+<kbd>x</kbd> 剪切- - <kbd>Ctrl</kbd>+<kbd>v</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_ 会新建一封新邮件。+但实际的行为取决于设备上的前台程序。例如,_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`(黏贴)(在电脑到设备的剪贴板同步完成之后)+要在这种情况下进行剪切,复制和粘贴 (仅支持 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>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd> 会将电脑的剪贴板内容转换为一串按键事件输入到设备。在应用程序不接受粘贴时 (比如 _Termux_),这项功能可以派上一定的用场。不过这项功能可能会导致非 ASCII 编码的内容出现错误。-**警告:** 将电脑剪贴板的内容黏贴至设备(无论是通过<kbd>Ctrl</kbd>+<kbd>v</kbd>还是<kbd>MOD</kbd>+<kbd>v</kbd>)-都需要将内容保存至设备的剪贴板。如此,任何一个应用程序都可以读取它。-您应当避免将敏感内容通过这种方式传输(如密码)。+**警告:** 将电脑剪贴板的内容粘贴至设备 (无论是通过 <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>) 来注入电脑剪贴板内容。-#### 捏拉缩放+#### 双指缩放-模拟 “捏拉缩放”:<kbd>Ctrl</kbd>+_按住并移动鼠标_。+模拟“双指缩放”:<kbd>Ctrl</kbd>+_按住并移动鼠标_。-更准确的说,您需要在按住<kbd>Ctrl</kbd>的同时按住并移动鼠标。-在鼠标左键松开之后,光标的任何操作都会相对于屏幕的中央进行。+更准确的说,在按住鼠标左键时按住 <kbd>Ctrl</kbd>。直到松开鼠标左键,所有鼠标移动将以屏幕中心为原点,缩放或旋转内容 (如果应用支持)。-具体来说, _scrcpy_ 使用“虚拟手指”以在相对于屏幕中央相反的位置产生触摸事件。+实际上,_scrcpy_ 会在以屏幕中心对称的位置上生成由“虚拟手指”发出的额外触摸事件。#### 文字注入偏好打字的时候,系统会产生两种[事件][textevents]:- - _按键事件_ ,代表一个按键被按下/松开。- - _文本事件_ ,代表一个文本被输入。+ - _按键事件_ ,代表一个按键被按下或松开。+ - _文本事件_ ,代表一个字符被输入。-程序默认使用按键事件来输入字母。只有这样,键盘才会在游戏中正常运作(尤其WASD键)。+程序默认使用按键事件来输入字母。只有这样,键盘才会在游戏中正常运作 (例如 WASD 键)。-但这也有可能[造成问题][prefertext]。如果您遇到了这样的问题,您可以通过下列操作避免它:+但这也有可能[造成一些问题][prefertext]。如果您遇到了问题,可以通过以下方式避免:```bashscrcpy --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-## 热键+## 快捷键-在下列表格中, <kbd>MOD</kbd> 是热键的修饰键。-默认是(左)<kbd>Alt</kbd>或者(左)<kbd>Super</kbd>。+在以下列表中, <kbd>MOD</kbd> 是快捷键的修饰键。+默认是 (左) <kbd>Alt</kbd> 或 (左) <kbd>Super</kbd>。-您可以使用 `--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```-_一般来说,<kbd>[Super]</kbd>就是<kbd>Windows</kbd>或者<kbd>Cmd</kbd>。_+_<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>- | 点按 `菜单` (解锁屏幕) | <kbd>MOD</kbd>+<kbd>m</kbd>- | 点按 `音量+` | <kbd>MOD</kbd>+<kbd>↑</kbd> _(up)_- | 点按 `音量-` | <kbd>MOD</kbd>+<kbd>↓</kbd> _(down)_- | 点按 `电源` | <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>- | 展开快捷操作 | <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显示(在 stdout) | <kbd>MOD</kbd>+<kbd>i</kbd>- | 捏拉缩放 | <kbd>Ctrl</kbd>+_点按并移动鼠标_--_¹双击黑色边界以关闭黑色边界_-_²点击鼠标右键将在屏幕熄灭时点亮屏幕,其余情况则视为按下 返回键 。_+ | 操作 | 快捷键 |+ | --------------------------------- | :------------------------------------------- |+ | 全屏 | <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> |+ | 点按 `菜单` (解锁屏幕) | <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> |+ | 收起通知面板 | <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显示 (在 stdout) | <kbd>MOD</kbd>+<kbd>i</kbd> |+ | 捏拉缩放 | <kbd>Ctrl</kbd>+_按住并移动鼠标_ |++_¹双击黑边可以去除黑边_+_²点击鼠标右键将在屏幕熄灭时点亮屏幕,其余情况则视为按下返回键 。__³需要安卓版本 Android >= 7。_-所有的 <kbd>Ctrl</kbd>+_按键_ 的热键都是被转发到设备进行处理的,所以实际上会由当前应用程序对其做出响应。+所有的 <kbd>Ctrl</kbd>+_按键_ 的快捷键都会被转发到设备,所以会由当前应用程序进行处理。## 自定义路径-为了使用您想使用的 _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)。## 开发者