Add Traditional Chinese translation for README
Reviewed-by: Yu-Chen Lin <npes87184@gmail.com> Signed-off-by: Romain Vimont <rom@rom1v.com>
This commit is contained in:
parent
a59a15777d
commit
b87a0df99a
2 changed files with 706 additions and 1 deletions
|
@ -733,4 +733,4 @@ Read the [developers page].
|
||||||
- [Scrcpy now works wirelessly][article-tcpip]
|
- [Scrcpy now works wirelessly][article-tcpip]
|
||||||
|
|
||||||
[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
|
[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
|
||||||
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
|
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
|
705
README.zh-Hant.md
Normal file
705
README.zh-Hant.md
Normal file
|
@ -0,0 +1,705 @@
|
||||||
|
_Only the original [README](README.md) is guaranteed to be up-to-date._
|
||||||
|
|
||||||
|
_只有原版的 [README](README.md)是保證最新的。_
|
||||||
|
|
||||||
|
|
||||||
|
本文件翻譯時點: [521f2fe](https://github.com/Genymobile/scrcpy/commit/521f2fe994019065e938aa1a54b56b4f10a4ac4a#diff-04c6e90faac2675aa89e2176d2eec7d8)
|
||||||
|
|
||||||
|
|
||||||
|
# scrcpy (v1.15)
|
||||||
|
|
||||||
|
Scrcpy 可以透過 USB、或是 [TCP/IP][article-tcpip] 來顯示或控制 Android 裝置。且 scrcpy 不需要 _root_ 權限。
|
||||||
|
|
||||||
|
Scrcpy 目前支援 _GNU/Linux_、_Windows_ 和 _macOS_。
|
||||||
|
|
||||||
|
![screenshot](assets/screenshot-debian-600.jpg)
|
||||||
|
|
||||||
|
特色:
|
||||||
|
|
||||||
|
- **輕量** (只顯示裝置螢幕)
|
||||||
|
- **效能** (30~60fps)
|
||||||
|
- **品質** (1920×1080 或更高)
|
||||||
|
- **低延遲** ([35~70ms][lowlatency])
|
||||||
|
- **快速啟動** (~1 秒就可以顯示第一個畫面)
|
||||||
|
- **非侵入性** (不安裝、留下任何東西在裝置上)
|
||||||
|
|
||||||
|
[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
|
||||||
|
|
||||||
|
|
||||||
|
## 需求
|
||||||
|
|
||||||
|
Android 裝置必須是 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
|
||||||
|
|
||||||
|
|
||||||
|
## 下載/獲取軟體
|
||||||
|
|
||||||
|
|
||||||
|
### Linux
|
||||||
|
|
||||||
|
Debian (目前支援 _testing_ 和 _sid_) 和 Ubuntu (20.04):
|
||||||
|
|
||||||
|
```
|
||||||
|
apt install 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/
|
||||||
|
|
||||||
|
在 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].
|
||||||
|
|
||||||
|
[Ebuild]: https://wiki.gentoo.org/wiki/Ebuild
|
||||||
|
[ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy
|
||||||
|
|
||||||
|
你也可以自己[編譯 _Scrcpy_][BUILD]。別擔心,並沒有想像中的難。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### Windows
|
||||||
|
|
||||||
|
為了保持簡單,Windows 用戶可以下載一個包含所有必需軟體 (包含 `adb`) 的壓縮包:
|
||||||
|
|
||||||
|
- [`scrcpy-win64-v1.15.zip`][direct-win64]
|
||||||
|
_(SHA-256: dd514bb591e63ef4cd52a53c30f1153a28f59722d64690eb07bd017849edcba2)_
|
||||||
|
|
||||||
|
[direct-win64]: https://github.com/Genymobile/scrcpy/releases/download/v1.15/scrcpy-win64-v1.15.zip
|
||||||
|
|
||||||
|
[Chocolatey] 上也可以下載:
|
||||||
|
|
||||||
|
[Chocolatey]: https://chocolatey.org/
|
||||||
|
|
||||||
|
```bash
|
||||||
|
choco install scrcpy
|
||||||
|
choco install adb # 如果你還沒有安裝的話
|
||||||
|
```
|
||||||
|
|
||||||
|
[Scoop] 上也可以下載:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scoop install scrcpy
|
||||||
|
scoop install adb # 如果你還沒有安裝的話
|
||||||
|
```
|
||||||
|
|
||||||
|
[Scoop]: https://scoop.sh
|
||||||
|
|
||||||
|
你也可以自己[編譯 _Scrcpy_][BUILD]。
|
||||||
|
|
||||||
|
|
||||||
|
### macOS
|
||||||
|
|
||||||
|
_Scrcpy_ 可以在 [Homebrew] 上直接安裝:
|
||||||
|
|
||||||
|
[Homebrew]: https://brew.sh/
|
||||||
|
|
||||||
|
```bash
|
||||||
|
brew install scrcpy
|
||||||
|
```
|
||||||
|
|
||||||
|
由於執行期間需要可以藉由 `PATH` 存取 `adb` 。如果還沒有安裝 `adb` 可以使用下列方式安裝:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
brew cask install android-platform-tools
|
||||||
|
```
|
||||||
|
|
||||||
|
你也可以自己[編譯 _Scrcpy_][BUILD]。
|
||||||
|
|
||||||
|
|
||||||
|
## 執行
|
||||||
|
|
||||||
|
將電腦和你的 Android 裝置連線,然後執行:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy
|
||||||
|
```
|
||||||
|
|
||||||
|
_Scrcpy_ 可以接受命令列參數。輸入下列指令就可以瀏覽可以使用的命令列參數:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --help
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## 功能
|
||||||
|
|
||||||
|
> 以下說明中,有關快捷鍵的說明可能會出現 <kbd>MOD</kbd> 按鈕。相關說明請參見[快捷鍵]內的說明。
|
||||||
|
|
||||||
|
[快捷鍵]: #快捷鍵
|
||||||
|
|
||||||
|
### 畫面擷取
|
||||||
|
|
||||||
|
#### 縮小尺寸
|
||||||
|
|
||||||
|
使用比較低的解析度來投放 Android 裝置在某些情況可以提升效能。
|
||||||
|
|
||||||
|
限制寬和高的最大值(例如: 1024):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --max-size 1024
|
||||||
|
scrcpy -m 1024 # 縮短版本
|
||||||
|
```
|
||||||
|
|
||||||
|
比較小的參數會根據螢幕比例重新計算。
|
||||||
|
根據上面的範例,1920x1080 會被縮小成 1024x576。
|
||||||
|
|
||||||
|
|
||||||
|
#### 更改 bit-rate
|
||||||
|
|
||||||
|
預設的 bit-rate 是 8 Mbps。如果要更改 bit-rate (例如: 2 Mbps):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --bit-rate 2M
|
||||||
|
scrcpy -b 2M # 縮短版本
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 限制 FPS
|
||||||
|
|
||||||
|
限制畫面最高的 FPS:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --max-fps 15
|
||||||
|
```
|
||||||
|
|
||||||
|
僅在 Android 10 後正式支援,不過也有可能可以在 Android 10 以前的版本使用。
|
||||||
|
|
||||||
|
#### 裁切
|
||||||
|
|
||||||
|
裝置的螢幕可以裁切。如此一來,鏡像出來的螢幕就只會是原本的一部份。
|
||||||
|
|
||||||
|
假如只要鏡像 Oculus Go 的其中一隻眼睛:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --crop 1224:1440:0:0 # 位於 (0,0),大小1224x1440
|
||||||
|
```
|
||||||
|
|
||||||
|
如果 `--max-size` 也有指定的話,裁切後才會縮放。
|
||||||
|
|
||||||
|
|
||||||
|
#### 鎖定影像方向
|
||||||
|
|
||||||
|
|
||||||
|
如果要鎖定鏡像影像方向:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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 --record file.mp4
|
||||||
|
scrcpy -r file.mkv
|
||||||
|
```
|
||||||
|
|
||||||
|
如果只要錄影,不要投放螢幕鏡像的話:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --no-display --record file.mp4
|
||||||
|
scrcpy -Nr file.mkv
|
||||||
|
# 用 Ctrl+C 停止錄影
|
||||||
|
```
|
||||||
|
|
||||||
|
就算有些幀為了效能而被跳過,它們還是一樣會被錄製。
|
||||||
|
|
||||||
|
裝置上的每一幀都有時間戳記,所以 [封包延遲 (Packet Delay Variation, PDV)][packet delay variation] 並不會影響錄影的檔案。
|
||||||
|
|
||||||
|
[packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation
|
||||||
|
|
||||||
|
|
||||||
|
### 連線
|
||||||
|
|
||||||
|
#### 無線
|
||||||
|
|
||||||
|
_Scrcpy_ 利用 `adb` 和裝置通訊,而 `adb` 可以[透過 TCP/IP 連結][connect]:
|
||||||
|
|
||||||
|
1. 讓電腦和裝置連到同一個 Wi-Fi。
|
||||||
|
2. 獲取手機的 IP 位址(設定 → 關於手機 → 狀態).
|
||||||
|
3. 啟用裝置上的 `adb over TCP/IP`: `adb tcpip 5555`.
|
||||||
|
4. 拔掉裝置上的線。
|
||||||
|
5. 透過 TCP/IP 連接裝置: `adb connect DEVICE_IP:5555` _(把 `DEVICE_IP` 換成裝置的IP位址)_.
|
||||||
|
6. 和平常一樣執行 `scrcpy`。
|
||||||
|
|
||||||
|
如果效能太差,可以降低 bit-rate 和解析度:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --bit-rate 2M --max-size 800
|
||||||
|
scrcpy -b2M -m800 # 縮短版本
|
||||||
|
```
|
||||||
|
|
||||||
|
[connect]: https://developer.android.com/studio/command-line/adb.html#wireless
|
||||||
|
|
||||||
|
|
||||||
|
#### 多裝置
|
||||||
|
|
||||||
|
如果 `adb devices` 內有多個裝置,則必須附上 _serial_:
|
||||||
|
|
||||||
|
```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
|
||||||
|
|
||||||
|
#### SSH tunnel
|
||||||
|
|
||||||
|
本地的 `adb` 可以連接到遠端的 `adb` 伺服器(假設兩者使用相同版本的 _adb_ 通訊協定),以連接到遠端裝置:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
adb kill-server # 停止在 Port 5037 的本地 adb 伺服
|
||||||
|
ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer
|
||||||
|
# 保持開啟
|
||||||
|
```
|
||||||
|
|
||||||
|
從另外一個終端機:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy
|
||||||
|
```
|
||||||
|
|
||||||
|
如果要避免啟用 remote port forwarding,你可以強制它使用 forward connection (注意 `-L` 和 `-R` 的差別):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
adb kill-server # 停止在 Port 5037 的本地 adb 伺服
|
||||||
|
ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer
|
||||||
|
# 保持開啟
|
||||||
|
```
|
||||||
|
|
||||||
|
從另外一個終端機:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --force-adb-forward
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
和無線連接一樣,有時候降低品質會比較好:
|
||||||
|
|
||||||
|
```
|
||||||
|
scrcpy -b2M -m800 --max-fps 15
|
||||||
|
```
|
||||||
|
|
||||||
|
### 視窗調整
|
||||||
|
|
||||||
|
#### 標題
|
||||||
|
|
||||||
|
預設標題是裝置的型號,不過可以透過以下方式修改:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --window-title 'My device'
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 位置 & 大小
|
||||||
|
|
||||||
|
初始的視窗位置和大小也可以指定:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 無邊框
|
||||||
|
|
||||||
|
如果要停用視窗裝飾:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --window-borderless
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 保持最上層
|
||||||
|
|
||||||
|
如果要保持 `scrcpy` 的視窗在最上層:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --always-on-top
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 全螢幕
|
||||||
|
|
||||||
|
這個軟體可以直接在全螢幕模式下起動:
|
||||||
|
|
||||||
|
```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_ 有 3 種不同的旋轉:
|
||||||
|
- <kbd>MOD</kbd>+<kbd>r</kbd> 要求裝置在垂直、水平之間旋轉 (目前運行中的 App 有可能會因為不支援而拒絕)。
|
||||||
|
- `--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+ 時可以控制。如果不是 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 上,`POWER` 按鈕總是開啟螢幕。
|
||||||
|
|
||||||
|
為了方便,如果 `POWER` 是透過 scrcpy 轉送 (右鍵 或 <kbd>MOD</kbd>+<kbd>p</kbd>)的話,螢幕將會在短暫的延遲後關閉。
|
||||||
|
|
||||||
|
實際在手機上的 `POWER` 還是會開啟螢幕。
|
||||||
|
|
||||||
|
防止裝置進入睡眠狀態:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --turn-screen-off --stay-awake
|
||||||
|
scrcpy -Sw
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
#### 顯示過期的幀
|
||||||
|
|
||||||
|
為了降低延遲, _scrcpy_ 預設只會顯示最後解碼的幀,並且拋棄所有在這之前的幀。
|
||||||
|
|
||||||
|
如果要強制顯示所有的幀 (有可能會拉高延遲),輸入:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --render-expired-frames
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 顯示觸控點
|
||||||
|
|
||||||
|
對於要報告的人來說,顯示裝置上的實際觸控點有時候是有幫助的。
|
||||||
|
|
||||||
|
Android 在_開發者選項_中有提供這個功能。
|
||||||
|
|
||||||
|
_Scrcpy_ 可以在啟動時啟用這個功能,並且在停止後恢復成原本的設定:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --show-touches
|
||||||
|
scrcpy -t
|
||||||
|
```
|
||||||
|
|
||||||
|
這個選項只會顯示**實際觸碰在裝置上的觸碰點**。
|
||||||
|
|
||||||
|
|
||||||
|
### 輸入控制
|
||||||
|
|
||||||
|
|
||||||
|
#### 旋轉裝置螢幕
|
||||||
|
|
||||||
|
輸入 <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> 通常是貼上 (在電腦的剪貼簿與裝置上的剪貼簿同步之後)
|
||||||
|
|
||||||
|
這些跟你通常預期的行為一樣。
|
||||||
|
|
||||||
|
但是,實際上的行為是根據目前運行中的應用程式而定。
|
||||||
|
|
||||||
|
舉例來說, _Termux_ 在收到 <kbd>Ctrl</kbd>+<kbd>c</kbd> 後,會傳送 SIGINT;而 _K-9 Mail_ 則是建立新訊息。
|
||||||
|
|
||||||
|
如果在這情況下,要剪下、複製或貼上 (只有在Android 7+時才支援):
|
||||||
|
- <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> 則是以一連串的按鍵事件貼上電腦剪貼簿中的內容。當元件不允許文字貼上 (例如 _Termux_) 時,這就很有用。不過,這在非 ASCII 內容上就無法使用。
|
||||||
|
|
||||||
|
**警告:** 貼上電腦的剪貼簿內容 (無論是從 <kbd>Ctrl</kbd>+<kbd>v</kbd> 或 <kbd>MOD</kbd>+<kbd>v</kbd>) 時,會複製剪貼簿中的內容至裝置的剪貼簿上。這會讓所有 Android 程式讀取剪貼簿的內容。請避免貼上任何敏感內容 (像是密碼)。
|
||||||
|
|
||||||
|
|
||||||
|
#### 文字輸入偏好
|
||||||
|
|
||||||
|
輸入文字時,有兩種[事件][textevents]會被觸發:
|
||||||
|
- _鍵盤事件 (key events)_,代表有一個按鍵被按下或放開
|
||||||
|
- _文字事件 (text events)_,代表有一個文字被輸入
|
||||||
|
|
||||||
|
預設上,文字是被以鍵盤事件 (key events) 輸入的,所以鍵盤和遊戲內所預期的一樣 (通常是指 WASD)。
|
||||||
|
|
||||||
|
但是這可能造成[一些問題][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
|
||||||
|
|
||||||
|
|
||||||
|
#### 重複輸入
|
||||||
|
|
||||||
|
通常來說,長時間按住一個按鍵會重複觸發按鍵事件。這會在一些遊戲中造成效能問題,而且這個重複的按鍵事件是沒有意義的。
|
||||||
|
|
||||||
|
如果不要轉送這些重複的按鍵事件:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --no-key-repeat
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### 檔案
|
||||||
|
|
||||||
|
#### 安裝 APK
|
||||||
|
|
||||||
|
如果要安裝 APK ,拖放一個 APK 檔案 (以 `.apk` 為副檔名) 到 _scrcpy_ 的視窗上。
|
||||||
|
|
||||||
|
視窗上不會有任何反饋;結果會顯示在命令列中。
|
||||||
|
|
||||||
|
|
||||||
|
#### 推送檔案至裝置
|
||||||
|
|
||||||
|
如果要推送檔案到裝置上的 `/sdcard/` ,拖放一個非 APK 檔案 (**不**以 `.apk` 為副檔名) 到 _scrcpy_ 的視窗上。
|
||||||
|
|
||||||
|
視窗上不會有任何反饋;結果會顯示在命令列中。
|
||||||
|
|
||||||
|
推送檔案的目標路徑可以在啟動時指定:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scrcpy --push-target /sdcard/foo/bar/
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### 音訊轉送
|
||||||
|
|
||||||
|
_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`: 左邊的 <kbd>Ctrl</kbd>
|
||||||
|
- `rctrl`: 右邊的 <kbd>Ctrl</kbd>
|
||||||
|
- `lalt`: 左邊的 <kbd>Alt</kbd>
|
||||||
|
- `ralt`: 右邊的 <kbd>Alt</kbd>
|
||||||
|
- `lsuper`: 左邊的 <kbd>Super</kbd>
|
||||||
|
- `rsuper`: 右邊的 <kbd>Super</kbd>
|
||||||
|
|
||||||
|
```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)
|
||||||
|
|
||||||
|
| Action | Shortcut
|
||||||
|
| ------------------------------------------------- |:-----------------------------
|
||||||
|
| 切換至全螢幕 | <kbd>MOD</kbd>+<kbd>f</kbd>
|
||||||
|
| 左旋顯示螢幕 | <kbd>MOD</kbd>+<kbd>←</kbd> _(左)_
|
||||||
|
| 右旋顯示螢幕 | <kbd>MOD</kbd>+<kbd>→</kbd> _(右)_
|
||||||
|
| 縮放視窗成 1:1 (pixel-perfect) | <kbd>MOD</kbd>+<kbd>g</kbd>
|
||||||
|
| 縮放視窗到沒有黑邊框為止 | <kbd>MOD</kbd>+<kbd>w</kbd> \| _雙擊¹_
|
||||||
|
| 按下 `首頁` 鍵 | <kbd>MOD</kbd>+<kbd>h</kbd> \| _中鍵_
|
||||||
|
| 按下 `返回` 鍵 | <kbd>MOD</kbd>+<kbd>b</kbd> \| _右鍵²_
|
||||||
|
| 按下 `切換 APP` 鍵 | <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>
|
||||||
|
|
||||||
|
_¹在黑邊框上雙擊以移除它們。_
|
||||||
|
_²右鍵會返回。如果螢幕是關閉狀態,則會打開螢幕。_
|
||||||
|
_³只支援 Android 7+。_
|
||||||
|
|
||||||
|
所有 <kbd>Ctrl</kbd>+_按鍵_ 快捷鍵都會傳送到裝置上,所以它們是由目前運作的應用程式處理的。
|
||||||
|
|
||||||
|
|
||||||
|
## 自訂路徑
|
||||||
|
|
||||||
|
如果要使用特定的 _adb_ ,將它設定到環境變數中的 `ADB`:
|
||||||
|
|
||||||
|
ADB=/path/to/adb scrcpy
|
||||||
|
|
||||||
|
如果要覆寫 `scrcpy-server` 檔案的路徑,則將路徑設定到環境變數中的 `SCRCPY_SERVER_PATH`。
|
||||||
|
|
||||||
|
[相關連結][useful]
|
||||||
|
|
||||||
|
[useful]: https://github.com/Genymobile/scrcpy/issues/278#issuecomment-429330345
|
||||||
|
|
||||||
|
|
||||||
|
## 為何叫 _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]。
|
||||||
|
|
||||||
|
[BUILD]: BUILD.md
|
||||||
|
|
||||||
|
|
||||||
|
## 常見問題
|
||||||
|
|
||||||
|
請看[這份文件 (英文)][FAQ]。
|
||||||
|
|
||||||
|
[FAQ]: FAQ.md
|
||||||
|
|
||||||
|
|
||||||
|
## 開發者文件
|
||||||
|
|
||||||
|
請看[這個頁面 (英文)][developers page].
|
||||||
|
|
||||||
|
[developers page]: DEVELOP.md
|
||||||
|
|
||||||
|
|
||||||
|
## Licence
|
||||||
|
|
||||||
|
Copyright (C) 2018 Genymobile
|
||||||
|
Copyright (C) 2018-2020 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.
|
||||||
|
|
||||||
|
## 相關文章
|
||||||
|
|
||||||
|
- [Scrcpy 簡介 (英文)][article-intro]
|
||||||
|
- [Scrcpy 可以無線連線了 (英文)][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/
|
Loading…
Reference in a new issue