File: README.zh-Hant.md

package info (click to toggle)
scrcpy 1.17-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 1,372 kB
  • sloc: ansic: 7,675; java: 4,310; sh: 262; xml: 107; makefile: 65
file content (705 lines) | stat: -rw-r--r-- 19,776 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
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-2021 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/