screenrecord

読み取りのみ

端末上の MP4 ファイルに画面を録画します。

コマンド: adb shell screenrecord
コマンド: 画面と取り込み
リスク: 読み取りのみ

構文

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

フラグと引数

トークン	意味
--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 は索引が書かれて初めて再生でき、このバイナリは割り込みを受けたときの終了処理でそれを書きます。代わりにソケットを落とすと、切り詰められたファイルが残り、プレイヤーによっては何も表示されません。
音声はありません。このバイナリは映像だけを録り、音のフラグもありません。
DRM で保護された面は黒く録画されます。スクリーンショットが黒くなるのと同じ理由です。
フレームサイズは録画開始時に固定されるので、途中で端末を回すと以降が letterbox になります。
180 秒の上限はケーブルではなくこのバイナリの性質です。ビルドがそれと食い違うなら、どの文書よりも端末自身の拒否を信じてください。

これには UI があります

Android Screen Mirror はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。

Android Screen Mirror を開く

コマンド	何をするか
screencap	スクリーンショットを撮ります。端末上のファイルに書くか、PNG として標準出力に流します。
wm size	ディスプレイの解像度を報告します。上書きすれば、端末は別の画面のふりをします。
rm	端末上のファイル、またはディレクトリツリーを削除します。

他の画面と取り込みコマンド

コマンド	何をするか
wm density	ディスプレイの密度を報告、または上書きします。レイアウトのブレークポイントを実際に動かすのはこちらです。

Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。

よくある質問

adb shell のコマンドはどう実行しますか？

端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から `adb shell <コマンド>` を実行します。`adb shell` だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは `adb shell` ではなく `adb exec-out` を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。

adb shell のコマンドに root は必要ですか？

このリファレンスにあるものには不要です。すべて `shell` ユーザーとして動き、自分の Android ユーザー向けのパッケージ管理、ほとんどの `dumpsys` サービスの読み取り、設定プロバイダへの書き込み、入力の注入、共有ストレージの読み取りができます。root が必要なのはこのリファレンスがあえて避けていること、つまり他のアプリのプライベートデータの読み取り（debuggable なビルドに対する `run-as` を除く）、システムパーティションへの書き込み、`/data/anr` の直接読み取りです。

自分の端末では出力が違って見えるのはなぜ？

Android のバージョンか、メーカーのどちらかです。一部のフラグやフィールドは特定のリリースから入ったもので、それはコマンドごとに注記しています。残りはメーカーによる改変で、いちばん影響が大きいのは `dumpsys` です。ダンプはデバッグ出力で、そのテキストはサービスの作者が最後に印字した内容そのもの、しかもメーカーはそれを変えて自分の変更をバックポートします。フィールドは位置ではなく名前で読み、見慣れない形は失敗ではなく差分として扱ってください。

端末ではなくブラウザから実行できますか？

多くのコマンドは可能です。このサイトの Web ADB ツール群は、Chromium 系のデスクトップブラウザから WebUSB で端末と話し、SDK のインストールも不要、どこにもアップロードしません。各ページは、該当するツールがあればそこへリンクしています。知っておく価値のある制限が 2 つあります。ADB インターフェイスを保持できるプログラムは同時に 1 つだけなので、デスクトップの `adb server` は先に止める必要があります。そして `adb forward` と `adb reverse` はブラウザでは一切動きません。

打つより押したい場合は、Web ADB Toolkit がこの種のコマンドをブラウザから USB 経由で実行します。あるいは全コマンドを見る。

構文