screenrecord

唯讀

把螢幕錄成裝置上的一個 MP4 檔。

指令: adb shell screenrecord
指令: 畫面與擷取
風險: 唯讀

語法

screenrecord [--size <width>x<height>] [--bit-rate <bps>] [--time-limit <seconds>] <device path>

旗標與參數

token	意義
--time-limit <s>	到這麼多秒就停。這個執行檔自己的說明寫著預設與最大都是 180。
--bit-rate <bps>	每秒位元數。說明寫著預設是 20 Mbps。
--size <w>x<h>	這是一個「要求」而不是保證。說明寫著支援的話預設就是顯示器解析度、不支援則是 1280x720，並建議使用編碼器支援的尺寸。

範例

screenrecord --time-limit 30 /sdcard/demo.mp4

錄 30 秒，然後把檔案拉回來。

screenrecord --bit-rate 8000000 --size 720x1560 /sdcard/small.mp4

給錯誤報告用的較小、較省的錄影。

```
kill -INT $(pidof screenrecord)
```
提早「正確地」停下來——原因見注意事項。

輸出怎麼讀

執行中什麼都不會印，結束時檔案就出現了。被拒絕（編碼器不接受的尺寸、寫不進去的路徑）是這個執行檔自己印出來的，那段文字就是答案，不是這一頁能預先講出來的東西。

輸出欄位

欄位	意義
(no output)	正在錄。檔案會邊錄邊寫。
(an error line)	裝置自己的拒絕訊息。照原文讀。

版本與廠商注意事項

要用中斷訊號停止，不要用切斷連線的方式。一個 MP4 只有在索引被寫入之後才能播放，而這個執行檔是在收到中斷訊號時的收尾流程裡寫索引的——直接把 socket 拆掉會留下一個被截斷的檔案，有些播放器會完全放不出來。
沒有聲音。這個執行檔只錄影像，也沒有聲音的旗標。
受 DRM 保護的畫面會錄成全黑，和截圖是全黑的原因相同。
影格尺寸在開始錄的時候就固定了，所以錄到一半旋轉手機，後面就會變成加黑邊。
180 秒的上限是這個執行檔的性質而不是纜線的限制。哪個版本和它不一致時，相信裝置自己的拒絕訊息，而不是任何文件。

這個我們有 UI

Android Screen Mirror 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。

開啟 Android Screen Mirror

指令	做什麼
screencap	擷取螢幕畫面，可以寫進手機裡的檔案，也可以把 PNG 送到標準輸出。
wm size	回報顯示器的解析度，或覆寫它，讓手機假裝自己是另一塊螢幕。
rm	刪除裝置上的一個檔案，或一棵目錄樹。

其他畫面與擷取指令

指令	做什麼
wm density	回報顯示密度，或覆寫它——真正會讓版面斷點移動的是這一個。

這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。

常見問題

adb shell 指令要怎麼執行？

在手機上打開開發者選項與 USB 除錯、接上線，然後從裝了 platform-tools 的機器執行 `adb shell <指令>`——或者只執行 `adb shell` 取得互動提示字元，再直接打指令、不用前綴。如果指令會輸出二進位資料（例如截圖），請改用 `adb exec-out` 而不是 `adb shell`：單純的 shell 服務會配一個終端機，而它會改寫換行位元組並毀掉資料。

adb shell 指令需要 root 嗎？

這份參考裡的都不用。它們以 `shell` 使用者身分執行，可以針對自己的 Android 使用者管理套件、讀取大多數 `dumpsys` 服務、寫入設定提供者、注入輸入，以及讀取共用儲存空間。需要 root 的是這份參考刻意避開的事：讀取其他 app 的私有資料（除了對可除錯版本使用 `run-as`）、寫入系統分割區，或直接讀 `/data/anr`。

為什麼在我的手機上輸出看起來不一樣？

不是 Android 版本就是廠商。有些旗標與欄位是從特定版本才有的，那些都在各指令頁註明了。其餘是廠商改動，而受影響最深的是 `dumpsys`：一份 dump 是除錯輸出，它的文字就是那個服務的作者最後印了什麼，而廠商既會改它也會把改動往回移植。請用名稱而不是位置來讀欄位，並把沒見過的格式當成差異而不是失敗。

可以用瀏覽器而不是終端機來跑嗎？

很多指令可以——本站的 Web ADB 工具從 Chromium 系桌面瀏覽器透過 WebUSB 和手機對話，不必安裝 SDK，也不會上傳任何東西。每一頁在有對應工具時都會連過去。有兩個限制值得知道：同一時間只有一個程式能持有 ADB 介面，所以桌面的 `adb server` 要先停掉；而 `adb forward` 與 `adb reverse` 在瀏覽器裡完全無法運作。

比較想按而不是打字？Web ADB Toolkit 會從瀏覽器透過 USB 執行這類指令。或者瀏覽全部指令。

語法