mirrors/scrcpy
0
0
Fork 0
mirror of https://github.com/Genymobile/scrcpy.git synced 2025-08-21 09:49:06 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated FAQ.zh Hans (markdown)

kmizmal 2025-01-21 20:13:58 +08:00
commit 3b047c5410
1 changed files with 132 additions and 225 deletions
Download patch file Download diff file Expand all files Collapse all files

357
FAQ.zh-Hans.md

@ -1,305 +1,212 @@
_Only the original [FAQ] is guaranteed to be up-to-date._
[FAQ]: https://github.com/Genymobile/scrcpy/blob/master/FAQ.md
_只有原版的 [FAQ.md](FAQ.md)是保证最新的。_ _只有原版的 [FAQ.md](FAQ.md)是保证最新的。_
Current version is based on [28054cd] 本文根据 https://github.com/Genymobile/scrcpy/blob/master/FAQ.md 进行翻译。
本文根据[28054cd]进行翻译。
[28054cd]: https://github.com/Genymobile/scrcpy/blob/28054cd471f848733e11372c9d745cd5d71e6ce7/FAQ.md
# 常见问题 # 常见问题
这里是一些常见的问题以及他们的状态。 [用另一种语言阅读](#翻译)
- [常见问题](#常见问题) 以下是常见的报告问题及其状态。
- [`adb` 相关问题](#adb-相关问题)
- [找不到`adb`](#找不到adb)
- [设备未授权](#设备未授权)
- [未检测到设备](#未检测到设备)
- [已连接多个设备](#已连接多个设备)
- [adb版本之间冲突](#adb版本之间冲突)
- [设备断开连接](#设备断开连接)
- [控制相关问题](#控制相关问题)
- [鼠标和键盘不起作用](#鼠标和键盘不起作用)
- [特殊字符不起作用](#特殊字符不起作用)
- [客户端相关问题](#客户端相关问题)
- [效果很差](#效果很差)
- [Wayland相关的问题](#wayland相关的问题)
- [KWin compositor 崩溃](#kwin-compositor-崩溃)
- [崩溃](#崩溃)
- [异常](#异常)
- [Windows命令行](#windows命令行)
## `adb` 相关问题 如果遇到任何错误，第一步是升级到最新版本。
`scrcpy` 执行 `adb` 命令来初始化和设备之间的连接。如果 `adb` 执行失败了， scrcpy 就无法工作。 ## `adb` 和 USB 问题
在这种情况中，将会输出这个错误: `scrcpy` 执行 `adb` 命令来初始化与设备的连接。如果
`adb` 失败，则 scrcpy 将无法工作。
> ERROR: "adb get-serialno" returned with value 1 这通常不是 _scrcpy_ 中的错误，而是您环境中的问题。
这通常不是 _scrcpy_ 的bug，而是你的环境的问题。 ### `adb` not found
要找出原因，请执行以下操作： 您需要从您的 `PATH` 访问 `adb`。
```bash 在 Windows 上，当前目录在您的 `PATH` 中，并且 `adb.exe` 包含在版本中，因此它应该可以开箱即用。
### Device not detected
> ERROR: Could not find any ADB device
检查您是否正确启用了 [adb 调试](enable-adb)。
您的设备必须通过 `adb` 检测：
```
adb devices adb devices
``` ```
### 找不到`adb` 如果未检测到您的设备，您可能需要一些 [驱动程序]（在 Windows 上）。有一个单独的 [Google 设备 USB 驱动程序][google-usb-driver]。
[enable-adb]：https://developer.android.com/studio/command-line/adb.html#Enabling
[驱动程序]：https://developer.android.com/studio/run/oem-usb.html
[google-usb-driver]：https://developer.android.com/studio/run/win-usb
你的`PATH`中需要能访问到`adb`。 ### Device unauthorized
```
ERROR: Device is unauthorized:
ERROR: --> (usb) 0123456789abcdef unauthorized
ERROR: A popup should open on the device to request authorization.
```
连接时，设备上应打开一个弹出窗口。您必须授权 USB 调试。
在Windows上，当前目录会包含在`PATH`中，并且`adb.exe`也包含在发行版中，因此它应该是开箱即用（直接解压就可以）的。 如果打不开，请检查[stackoverflow] [device-unauthorized](https://stackoverflow.com/questions/23081263/adb-android-device-unauthorized)
### Several devices connected
### 设备未授权 如果已连接多台设备，您将遇到此错误：
```
ERROR: Multiple (2) ADB devices:
> error: device unauthorized. ERROR: --> (usb) 0123456789abcdef device Nexus_5
> This adb server's $ADB_VENDOR_KEYS is not set ERROR: --> (tcpip) 192.168.1.5:5555 device GM1913
> Try 'adb kill-server' if that seems wrong. ERROR: Select a device via -s (--serial), -d (--select-usb) or -e (--select-tcpip)
> Otherwise check for a confirmation dialog on your device. ```
在这种情况下，您可以提供要镜像的设备的标识符：
连接时，在设备上应该会打开一个弹出窗口。 您必须授权 USB 调试。
如果没有打开，参见[stackoverflow][device-unauthorized].
[device-unauthorized]: https://stackoverflow.com/questions/23081263/adb-android-device-unauthorized
### 未检测到设备
> error: no devices/emulators found
确认已经正确启用 [adb debugging][enable-adb].
如果你的设备没有被检测到，你可能需要一些[驱动][drivers] (在 Windows上)。这里有一个单独的 [适用于Google设备的USB驱动][google-usb-driver].
[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling
[drivers]: https://developer.android.com/studio/run/oem-usb.html
[google-usb-driver]: https://developer.android.com/studio/run/win-usb
### 已连接多个设备
如果连接了多个设备，您将遇到以下错误：
> error: more than one device/emulator
必须提供要镜像的设备的标识符：
```bash ```bash
scrcpy -s 01234567890abcdef scrcpy -s 0123456789abcdef
``` ```
注意，如果你的设备是通过 TCP/IP 连接的， 你将会收到以下消息： 或者请求单个 USB（或TCP/IP) 设备：
> adb: error: more than one device/emulator
> ERROR: "adb reverse" returned with value 1
> WARN: 'adb reverse' failed, fallback to 'adb forward'
这是意料之中的 (由于旧版安卓的一个bug, 请参见 [#5])，但是在这种情况下，scrcpy会退回到另一种方法，这种方法应该可以起作用。
[#5]: https://github.com/Genymobile/scrcpy/issues/5
### adb版本之间冲突
> adb server version (41) doesn't match this client (39); killing...
同时使用多个版本的`adb`时会发生此错误。你必须查找使用不同`adb`版本的程序，并在所有地方使用相同版本的`adb`。
你可以覆盖另一个程序中的`adb`二进制文件，或者通过设置`ADB`环境变量来让 _scrcpy_ 使用特定的`adb`二进制文件。
```bash ```bash
set ADB=/path/to/your/adb scrcpy -d # USB 设备
scrcpy -e # TCP/IP 设备
```
请注意，如果您的设备通过 TCP/IP 连接，您可能会收到以下消息：
```
adb: error: more than one device/emulator
ERROR: "adb reverse" returned with value 1
WARN: 'adb reverse' failed, fallback to 'adb forward'
```
这是预期的（由于旧 Android 版本上的错误，请参阅 [#5](https://github.com/Genymobile/scrcpy/issues/5)，但在这种情况下，scrcpy 会回退到另一种方法，这应该可以工作。
### Conflicts between adb versions
> adb server version (41) doesn't match this client (39); killing...
当您同时使用多个 `adb` 版本时，会发生此错误。您必须使用不同的 `adb` 版本找到该程序，并在所有地方使用相同的 `adb` 版本。
您可以通过设置 `ADB` 环境变量覆盖其他程序中的 `adb` 二进制文件，或要求 _scrcpy_
使用特定的 `adb` 二进制文件：
```bash
# in bash
export ADB=/path/to/your/adb
scrcpy scrcpy
``` ```
```cmd
:: in cmd
set ADB=C:\path\to\your\adb.exe
scrcpy
```
### 设备断开连接 ```powershell
# in PowerShell
$env:ADB = 'C:\path\to\your\adb.exe'
scrcpy
```
如果 _scrcpy_ 在警告“设备连接断开”的情况下自动中止，那就意味着`adb`连接已经断开了。 ### Device disconnected
请尝试使用另一条USB线或者电脑上的另一个USB接口。请参看 [#281] 和 [#283]。 如果 _scrcpy_ 自行停止并显示“设备已断开连接”警告，则 `adb` 连接已关闭。
[#281]: https://github.com/Genymobile/scrcpy/issues/281 尝试使用另一根 USB 电缆或将其插入另一个 USB 端口。请参阅 [#281](https://github.com/Genymobile/scrcpy/issues/281) 和
[#283]: https://github.com/Genymobile/scrcpy/issues/283 [#283](https://github.com/Genymobile/scrcpy/issues/283)。
## Windows 上的 OTG 问题
## 控制相关问题 在 Windows 上，如果 `scrcpy --otg`（或 `--keyboard=aoa`/`--mouse=aoa`）导致：
> ERROR: Could not find any USB device
（或者如果只检测到不相关的 USB 设备），则可能存在驱动程序问题。
请阅读 [#3654]，特别是 [此评论](#3654-comment1)和 [下一个](#3654-comment2)。
[#3654]: https://github.com/Genymobile/scrcpy/issues/3654
[#3654-comment1]: https://github.com/Genymobile/scrcpy/issues/3654#issuecomment-1369278232
[#3654-comment2]: https://github.com/Genymobile/scrcpy/issues/3654#issuecomment-1369295011
## 控制问题
### 鼠标和键盘不起作用 ### 鼠标和键盘不起作用
在某些设备上，您可能需要启用一个选项以允许 [模拟输入]。
在某些设备上，您可能需要启用一个选项以允许 [模拟输入][simulating input]。 在开发者选项中，启用：
在开发者选项中，打开：
> **USB调试 (安全设置)** > **USB 调试（安全设置）**
> _允许通过USB调试修改权限或模拟点击_ > _允许授予权限并通过 USB 调试模拟输入_
[simulating input]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323 设置此选项后，可能需要重启设备。
[模拟输入]：https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
### 特殊字符不起作用 ### 特殊字符不起作用
可输入的文本[被限制为ASCII字符][text-input]。也可以用一些小技巧输入一些[带重音符号的字符][accented-characters]，但是仅此而已。参见[#37]。 默认的文本注入方法是 [仅限于 ASCII 字符][text-input]。
自 Linux 上的 scrcpy v1.20 之后，可以模拟[物理键盘][hid] (HID)。 一个技巧允许注入一些 [重音字符][accented-characters]，
但仅此而已。请参阅 [#37]。
为了避免这个问题，[更改键盘模式以模拟物理键盘][hid]。
[text-input]: https://github.com/Genymobile/scrcpy/issues?q=is%3Aopen+is%3Aissue+label%3Aunicode [text-input]: https://github.com/Genymobile/scrcpy/issues?q=is%3Aopen+is%3Aissue+label%3Aunicode
[accented-characters]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-accented-characters [accented-characters]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-accented-characters
[#37]: https://github.com/Genymobile/scrcpy/issues/37 [#37]: https://github.com/Genymobile/scrcpy/issues/37
[hid]: README.md#physical-keyboard-simulation-hid [hid]: doc/keyboard.md#physical-keyboard-simulation
## 客户端问题
## 客户端相关问题 ### Wayland 问题
### 效果很差 默认情况下，SDL 在 Linux 上使用 x11。 [视频驱动程序] 可以通过
`SDL_VIDEODRIVER` 环境变量进行更改：
如果你的客户端窗口分辨率比你的设备屏幕小，则可能出现效果差的问题，尤其是在文本上（参见 [#40]）。 [视频驱动程序]：https://wiki.libsdl.org/FAQUsingSDL#how_do_i_choose_a_specific_video_driver
[#40]: https://github.com/Genymobile/scrcpy/issues/40
为了提升降尺度的质量，如果渲染器是OpenGL并且支持mip映射，就会自动开启三线性过滤。
在Windows上，你可能希望强制使用OpenGL：
```
scrcpy --render-driver=opengl
```
你可能还需要配置[缩放行为][scaling behavior]：
> `scrcpy.exe` > Properties > Compatibility > Change high DPI settings >
> Override high DPI scaling behavior > Scaling performed by: _Application_.
[scaling behavior]: https://github.com/Genymobile/scrcpy/issues/40#issuecomment-424466723
### Wayland相关的问题
在Linux上，SDL默认使用x11。可以通过`SDL_VIDEODRIVER`环境变量来更改[视频驱动][video driver]：
[video driver]: https://wiki.libsdl.org/FAQUsingSDL#how_do_i_choose_a_specific_video_driver
```bash ```bash
export SDL_VIDEODRIVER=wayland export SDL_VIDEODRIVER=wayland
scrcpy scrcpy
``` ```
在一些发行版上 (至少包括 Fedora)， `libdecor` 包必须手动安装。 在某些发行版（至少是 Fedora）上，必须手动安装包 `libdecor`。
参见 [#2554] 和 [#2559]。 请参阅问题 [#2554] 和 [#2559]。
[#2554]: https://github.com/Genymobile/scrcpy/issues/2554 [#2554]：https://github.com/Genymobile/scrcpy/issues/2554
[#2559]: https://github.com/Genymobile/scrcpy/issues/2559 [#2559]：https://github.com/Genymobile/scrcpy/issues/2559
### KWin 合成器崩溃
### KWin compositor 崩溃 在 Plasma Desktop 上，_scrcpy_ 运行时合成器被禁用。
在Plasma桌面中，当 _scrcpy_ 运行时，会禁用compositor。 解决方法是[禁用“块合成”][kwin]。
一种解决方法是， [禁用 "Block compositing"][kwin].
[kwin]: https://github.com/Genymobile/scrcpy/issues/114#issuecomment-378778613
[kwin]：https://github.com/Genymobile/scrcpy/issues/114#issuecomment-378778613
## 崩溃 ## 崩溃
### 异常 ### 异常
可能有很多原因。一个常见的原因是您的设备无法按给定清晰度进行编码： 如果您收到与 `MediaCodec` 相关的任何异常：
> ```
> ERROR: Exception on thread Thread[main,5,main]
> android.media.MediaCodec$CodecException: Error 0xfffffc0e
> ...
> Exit due to uncaughtException in main thread:
> ERROR: Could not open video stream
> INFO: Initial texture: 1080x2336
> ```
或者
> ```
> ERROR: Exception on thread Thread[main,5,main]
> java.lang.IllegalStateException
> at android.media.MediaCodec.native_dequeueOutputBuffer(Native Method)
> ```
请尝试使用更低的清晰度：
``` ```
scrcpy -m 1920 ERROR: Exception on thread Thread[main,5,main]
scrcpy -m 1024 java.lang.IllegalStateException
scrcpy -m 800 at android.media.MediaCodec.native_dequeueOutputBuffer(Native Method)
``` ```
自 scrcpy v1.22以来，scrcpy 会自动在失败前以更低的分辨率重试。这种行为可以用`--no-downsize-on-error`关闭。 然后尝试使用另一个 [编码器](doc/video.md#encoder)。
你也可以尝试另一种 [编码器](README.md#encoder)。 ## 翻译
此常见问题解答的其他语言翻译可在 [wiki](wiki) 中找到。
如果您在 Android 12 上遇到此异常，则只需升级到 scrcpy >= 1.18 (见 [#2129])： [wiki]：https://github.com/Genymobile/scrcpy/wiki
``` 只有此常见问题解答文件保证是最新的。
> ERROR: Exception on thread Thread[main,5,main]
java.lang.AssertionError: java.lang.reflect.InvocationTargetException
at com.genymobile.scrcpy.wrappers.SurfaceControl.setDisplaySurface(SurfaceControl.java:75)
...
Caused by: java.lang.reflect.InvocationTargetException
at java.lang.reflect.Method.invoke(Native Method)
at com.genymobile.scrcpy.wrappers.SurfaceControl.setDisplaySurface(SurfaceControl.java:73)
... 7 more
Caused by: java.lang.IllegalArgumentException: displayToken must not be null
at android.view.SurfaceControl$Transaction.setDisplaySurface(SurfaceControl.java:3067)
at android.view.SurfaceControl.setDisplaySurface(SurfaceControl.java:2147)
... 9 more
```
[#2129]: https://github.com/Genymobile/scrcpy/issues/2129
## Windows命令行
从 v1.22 开始，增加了一个“快捷方式”，可以直接在 scrcpy 目录打开一个终端。双击`open_a_terminal_here.bat`，然后输入你的命令。 例如：
```
scrcpy --record file.mkv
```
您也可以打开终端并手动转到 scrcpy 文件夹：
1. 按下 <kbd>Windows</kbd>+<kbd>r</kbd>，打开一个对话框。
2. 输入 `cmd` 并按 <kbd>Enter</kbd>，这样就打开了一个终端。
3. 通过输入以下命令，切换到你的 _scrcpy_ 所在的目录 （根据你的实际位置修改路径）:
```bat
cd C:\Users\user\Downloads\scrcpy-win64-xxx
```
然后按 <kbd>Enter</kbd>
4. 输入你的命令。比如:
```bat
scrcpy --record file.mkv
```
如果你打算总是使用相同的参数，在`scrcpy`目录创建一个文件 `myscrcpy.bat`
（启用 [显示文件拓展名][show file extensions] 避免混淆），文件中包含你的命令。例如：
```bat
scrcpy --prefer-text --turn-screen-off --stay-awake
```
然后只需双击刚刚创建的文件。
你也可以编辑 `scrcpy-console.bat` 或者 `scrcpy-noconsole.vbs`（的副本）来添加参数。
[show file extensions]: https://www.howtogeek.com/205086/beginner-how-to-make-windows-show-file-extensions/