ポータブルscrcpyでWindows上のAndroid端末をミラーリング・操作する方法

このプロジェクトの概要

シームレスなAndroidミラーリングおよび操作ワークフローは、WindowsデスクトップをAndroidデバイスのライブインターフェースに変えます。デバイス画面をサイズ変更可能なウィンドウに表示し、マウス、キーボード、ナビゲーション操作をリアルタイムでAndroidへ送信します。

このプロジェクトは、デスクトップコンソール、必要な依存関係、スマートフォン側のコンパニオンコンポーネントをポータブルな構成にまとめています。各依存関係を個別に探してインストールする必要はなく、Androidコンパニオンもアプリストアから手動でインストールする必要がありません。

初回接続時、デスクトップツールはデバイスに小さなエージェントを転送し、映像と入力の各チャンネルを確立して、ミラーリングされた画面を開きます。同じ接続で、映像ストリームとともにクリップボードデータ、音声、ファイル転送も扱えます。

主な機能

• ライブ画面ミラーリング：Androidのアニメーション、スクロール、アプリ、動画を低遅延のデスクトップウィンドウで表示します。
• キーボードとマウスによる操作：クリックをタップに、ドラッグをスワイプに変換し、物理キーボードからの入力をAndroidのテキスト入力に反映します。
• ポータブルなセットアップ：ツールキット全体を1つのフォルダーに保存し、互換性のあるWindowsコンピューター間で移動できます。
• 有線・無線での動作：セットアップと安定性のためにUSBで開始し、信頼関係を確立した後はローカルネットワークでケーブルなしのミラーリングを利用できます。
• 柔軟な表示：ウィンドウのサイズ変更、縦向き・横向きの切り替え、画面の回転、フルスクリーンモードに対応します。
• キャプチャーと共有ツール：スクリーンショットの撮影、セッションの録画、クリップボード内容の共有、ファイル転送ができます。
• 複数デバイス対応：接続されたデバイスごとに別のミラーウィンドウを開けます。
• 確実な終了処理：ミラーを閉じるかケーブルを抜くと、手動でインストールしたAndroidアプリを残さずに、スマートフォン側のコンパニオンを停止します。

必要条件

開始前に次のものを準備してください。

• Windows 10またはWindows 11
• PowerShell 5.1以降
• 有効なネットワーク接続
• Androidスマートフォンまたはタブレット
• 初回接続用のデータ通信対応USBケーブル

管理者権限は必要ありません。PowerShell 5.1は、サポート対象のWindowsバージョンにすでに含まれています。

ツールキットのインストールと準備

1. プロジェクトのセットアップページを開く

リポジトリのPowerShellコマンドボタンページを使用して、セットアップワークフローにアクセスします。ミラーリングコンポーネントを個別に組み立てるのではなく、ページに表示されるコマンドまたはダウンロード手順に従ってください。

2. パッケージをまとめて保管する

ダウンロードまたは準備したフォルダーがインストール先として機能します。コンソールが依存関係とAndroid側のエージェントを見つけられるよう、同梱ファイルをまとめて保管してください。セットアップはポータブルなので、フォルダーをリムーバブルストレージにコピーし、別の互換性のあるWindowsコンピューターで起動することもできます。

3. セキュリティの確認を慎重に行う

セキュリティ製品が、ローカルデバイス接続を作成する見慣れないビルド済みツールを検査または警告する場合があります。許可する前に、ファイルがプロジェクトページから取得されたものか確認してください。READMEには、このパッケージは説明されているミラーリングワークフローのみを提供する目的であると記載されていますが、それでも組織のセキュリティポリシーに従ってください。

AndroidでUSBデバッグを有効にする

デスクトップツールは、初回のペアリングと一時的なコンパニオンコンポーネントの起動に、Androidのデバッグインターフェースを必要とします。

1. Androidデバイスの設定を開きます。
2. 開発者向けオプションを有効にします。正確な場所はデバイスとAndroidのバージョンによって異なります。
3. 開発者向けオプションを開き、USBデバッグを有効にします。
4. 初回接続時は、デバイスの画面をオンにしてロックを解除した状態にします。
5. データ通信対応USBケーブルで、デバイスをコンピューターに直接接続します。

充電専用ケーブルでは、必要なデバイスデータを転送できません。スマートフォンが充電されても検出されない場合は、別のケーブルまたはUSBポートを試してください。

初回ミラーリングセッションを開始する

1. ツールキットを起動する：ポータブルフォルダーからデスクトップコンソールを起動します。
2. デバイスを接続する：ロックを解除したAndroidデバイスをUSBで接続します。
3. コンピューターを承認する：AndroidにUSBデバッグの確認が表示されたら、内容を確認して許可をタップします。信頼できる場合は、コンピューターを記憶するよう選択できます。
4. ミラーが表示されるまで待つ：ツールが小さなコンパニオンエージェントを転送し、ストリームを確立して、デバイス画面をデスクトップウィンドウに表示します。
5. 入力をテストする：Androidのコントロールをクリックし、ウィンドウ上をドラッグして、テキストフィールドに入力し、デスクトップからの入力がデバイスに届くことを確認します。

初回のハンドシェイクには、実機の画面がオンでロック解除されている必要があります。ストリーミングが始まると、デスクトップからの入力が引き続き機能する一方で、スマートフォンの画面が暗くなる場合があります。ロックされたAndroidデバイスでは、ロックを解除するまで通常のタップは受け付けられません。

デスクトップの基本操作

ミラーは静的なスクリーンショットの連続ではなく、操作可能な第2画面のように動作します。一般的な操作は、Androidのアクションに自然に対応します。

• タップ: マウスで項目をクリックします。
• スワイプ: 移動したい方向へクリックしてドラッグします。
• スクロール: Androidのインターフェースがスクロールに対応している場所では、マウスホイールを使用します。
• 入力: Androidのテキストフィールドを選択し、Windowsキーボードを使用します。
• ナビゲーション: ツールに割り当てられたハードウェアキー操作を使ってAndroidを操作します。

例: メッセージに返信する

1. ミラーリングされたウィンドウでメッセージアプリをクリックします。
2. 会話を選択します。
3. メッセージ入力欄をクリックします。
4. デスクトップキーボードで入力します。
5. Androidの送信操作をクリックします。

例: アプリのインターフェースをテストする

1. ミラーリングされたデバイスからアプリを開きます。
2. 開発ツールやテストツールの横に収まるよう、ミラーのサイズを変更します。
3. クリックやドラッグを使ってタップやジェスチャーをテストします。
4. 縦向きと横向きのレイアウトを確認するときは表示を回転させます。
5. デモやバグレポート用にセッションを録画するか、スクリーンショットを撮影します。

表示とストリームを調整する

ミラーウィンドウのサイズを変更して作業スペースに合わせたり、仮想ディスプレイを回転させたり、プレゼンテーション用にフルスクリーンへ切り替えたりできます。接続状況に応じて画質と応答性のバランスを変える必要がある場合は、ビットレートと解像度も変更できます。

動きがぼやけたり、カクついたりする場合は、次の手順を試してください。

1. 電源供給のないハブではなく、直接USB接続を使用します。
2. 極端に長いUSB延長ケーブルは避けます。
3. 大容量転送や、帯域幅を大量に消費するほかの処理を終了します。
4. 接続の制約が続く場合は、ストリームの解像度またはビットレートを下げます。
5. ワイヤレスセッションが不安定な場合は、有線モードに戻します。

帯域幅が限られている場合、エンコーダーは一時的に画像の細部より応答性を優先することがあります。直接接続で安定した接続を使用すると、通常、最も鮮明で一貫した出力が得られます。

ワイヤレスミラーリングを使用する

ワイヤレスモードでは、ローカルネットワーク経由でミラーリングを継続できます。初回の有線セットアップで、まず信頼関係を確立してください。初回の認証にはケーブルが使用され、コンパニオンのセットアップにも最も信頼性の高い経路が提供されます。

1. USBミラーリングセッションを正常に完了します。
2. WindowsコンピューターとAndroidデバイスがローカルネットワーク経由で通信できることを確認します。
3. 信頼関係を確立した後、ツールキットのワイヤレスモードを使用します。
4. ネットワーク状況によって遅延やカクつきが発生した場合に備え、USBを予備の接続手段として利用できるようにします。

ワイヤレスミラーリングは、部屋の中を移動したり、ケーブルなしでプレゼンテーションを行ったりする場合に便利です。最大限の安定性や一貫した動画品質が必要な場合は、USBの使用が適しています。

ファイルを転送し、テキストを共有し、セッションをキャプチャする

このワークフローは、スマートフォンの画面を見るだけのものではありません。コンピューターとAndroidデバイスの間でクリップボードの内容やファイルを移動でき、スクリーンショットや録画機能を使ってセッションを記録できます。

• クリップボード共有: テキストを再入力せずに、AndroidとWindowsの間でコピーします。
• ファイル転送: 対応ファイルをデスクトップとデバイスの間でドラッグ＆ドロップします。
• スクリーンショット: ミラーリングされた画面を鮮明な画像として保存します。
• 録画: デモ、テスト、または再現可能なバグの動画を保存します。

正確な操作項目は、パッケージに含まれるインターフェースによって異なる場合があります。文書化されていないコマンドラインオプションを想定せず、ツールキットに表示される操作項目を使用してください。

複数のAndroidデバイスを操作する

このプロジェクトでは、複数の接続済みデバイスをミラーリングできます。各デバイスは個別のウィンドウで開くため、レイアウトを比較したり、複数のスマートフォンにまたがる操作手順を実演したりできます。

1. すべてのデバイスでUSBデバッグを有効にします。
2. 各デバイスを信頼できるデータケーブルで接続します。
3. 各Android画面で個別に認証プロンプトを承認します。
4. 表示されたミラーウィンドウを横に並べます。

この構成は、異なる画面サイズでインターフェースを確認したり、世代の異なるデバイス間で動作を比較したりする場合に便利です。

高度なヒント

重要な作業にはUSBを使用する

長時間の録画、デモ、または安定した遅延が重要なテストには、直接有線接続を使用します。ワイヤレスモードは柔軟性に優れていますが、性能はローカルネットワークの状況に左右されます。

ポータブルフォルダーを維持する

実行ファイルを同梱の依存ファイルから分離しないでください。セットアップを別のコンピューターやUSBドライブに移動する場合は、フォルダー全体をコピーします。

既知のコンピューターだけを信頼する

Androidのデバッグ認証により、コンピューターにデバイスへの大幅なアクセス権が与えられます。自分が管理するコンピューターだけを承認し、必要に応じてAndroidの開発者向け設定から保存済みのデバッグ認証を取り消してください。

セットアップ中はデバイスのロックを解除しておく

最初のハンドシェイクと認証には、実際のスマートフォン画面へのアクセスが必要です。後から入力が反応しなくなった場合は、Androidでデバイスがロックされていないか確認してください。

再現可能なテスト環境を構築する

サイズ変更可能なミラーをログ、ドキュメント、または開発ツールの横に配置します。繰り返し使用する場合は、以前に信頼したデバイスを再接続し、ワークフローに最適な表示配置を再利用します。

切断して後片付けする

セッションが完了したら、ミラーウィンドウを閉じるか、デバイスを取り外します。ツールキットは一時的なスマートフォン側のコンパニオンに終了信号を送り、Androidアプリをアンインストールすることなくセッションを終了します。

次回のセッションでは、信頼済みのデバイスを再接続して、ツールキットをもう一度起動します。READMEによると、このワークフローは設定を保持するため、セットアップの手間を減らして使い慣れたセッションを再開できます。

ライセンス

本プロジェクトはMITライセンスのもとで配布されています。元の著作権表示と許諾通知を含めることを条件に、内容の確認、変更、使用、再配布が可能です。別のワークフローの一部として利用することもできます。本ソフトウェアは無保証で提供されます。

まとめ

このポータブルワークフローを使えば、個別の依存関係を手動で収集することなく、WindowsからAndroid端末をミラーリングして操作するための統合された環境を利用できます。USBデバッグを有効にして初回接続を承認すると、キーボードとマウスでAndroidを操作し、表示を調整し、データを転送し、セッションを記録し、ワイヤレスモードを使用し、複数の端末ウィンドウを1台のデスクトップから管理できます。