このページは Cloud Translation API によって翻訳されました。

拡張コントロール、設定、ヘルプ

Android Emulator の拡張コントロールを使用して、データの送信、デバイスプロパティの変更、アプリの制御などができます。[Extended controls] ウィンドウを開くには、エミュレータパネルでその他アイコンをクリックします。なお、拡張コントロールオプションの一部は、Android Studio 外で別のウィンドウでエミュレータを実行する場合にのみ使用できます。

これらのタスクの多くは、キーボードショートカットで実行できます。エミュレータのショートカットを一覧表示するには、F1（macOS では Command+/）キーを押して [Help] ペインを開きます。

表 1. 拡張コントロールの詳細

機能	説明
ディスプレイ	エミュレータを使用すると、サイズをカスタマイズできる複数のディスプレイにアプリをデプロイして、マルチウィンドウやマルチディスプレイをサポートするアプリをテストできます。仮想デバイスの実行中、次のように、最大 2 つのディスプレイを追加できます。ディスプレイを 1 つ追加するには、[Add secondary display] をクリックします。 [Secondary displays] のメニューで、次のいずれかを行います。プリセットされているアスペクト比のいずれかを選択します。 [custom] を選択して、カスタムディスプレイの高さ、幅、dpi を設定します。（省略可）3 つ目のディスプレイを追加するには、[Add secondary display] をクリックします。 [Apply changes] をクリックして、指定したディスプレイを、実行中の仮想デバイスに追加します。
モバイル	エミュレータでは、さまざまなネットワークの状態をシミュレートできます。さまざまなネットワークプロトコルのネットワーク速度に近づけたり、[Full] を指定してコンピュータで実現できる最高速度でデータを転送したりできます。ネットワークプロトコルを指定すると必ず、[Full] にした場合よりも速度が低下します。さらにローミングなど、音声やデータネットワークの状態も指定できます。デフォルトでは AVD に設定されています。 [Network type] の値を選択します。 GSM: Global System for Mobile Communications HSCSD: High-Speed Circuit-Switched Data GPRS: Generic Packet Radio Service EDGE: Enhanced Data rates for GSM Evolution UMTS: Universal Mobile Telecommunications System HSPDA: High-Speed Downlink Packet Access LTE: Long-Term Evolution Full（デフォルト）: コンピュータによって提供されるネットワークを使用します [Signal strength] の値を選択します。 None Poor Moderate（デフォルト） Good Great [Voice status] と [Data status] の一方または両方の値を選択します。 Home（デフォルト） Roaming Searching Denied（緊急通報のみ） Unregistered（オフ）
電池	デバイスの電池プロパティをシミュレートすると、さまざまな条件下でアプリの動作を確認できます。[Charge level] を選択するには、スライダーコントロールを使用します。 [Charger connection] の値を選択します。 None AC charger [Battery health] の値を選択します。 Good（デフォルト） Failed Dead Overvoltage Overheated Unknown [Battery status] の値を選択します。 Unknown Charging（デフォルト） Discharging Not charging Full
Camera	エミュレータのカメラを開いたときにシミュレートされるシーンに画像を読み込むことができます。詳細については、ARCore ドキュメントのシーンに拡張画像を追加するをご覧ください。
場所	エミュレータでは「現在地」情報（エミュレートしているデバイスがある場所）をシミュレートできます。たとえば、Google マップで現在地をクリックして位置情報を送信すると、地図にその場所が表示されます。デバイスの位置情報に関するコントロールは、2 つのタブ（[Single points] と [Routes]）にまとめられています。 Single points [Single points] タブでは、Google マップの WebView を使用して、スマートフォンやブラウザで Google マップを使用しているときと同じようにスポットを検索できます。地図で場所を検索またはクリックすると、地図の下部で [Save point] を選択して保存できます。保存した場所はすべて [Extended controls] ウィンドウの右側の一覧に表示されます。エミュレータの場所を地図上で選択した場所に設定するには、[Extended controls] ウィンドウの右下にある [Set location] ボタンをクリックします。 Routes [Single points] タブと同様に、[Routes] タブには、Google マップ WebView が表示されるので、2 つ以上の場所の間に経路を作成できます。経路を作成して保存する手順は次のとおりです。地図表示で、テキストフィールドを使用して経路の最初の目的地を検索します。検索結果から場所を選択します。ナビゲーションボタンを選択します。地図から経路の出発地を選択します。（省略可）[Add destination] をクリックして、経由地をルートに追加します。地図表示で [Save route] をクリックして経路を保存します。ルートの名前を指定して、[Save] をクリックします。保存した経路に沿ってエミュレータでシミュレートするには、[Saved routes] リストから経路を選択し、[Extended controls] ウィンドウの右下にある [Play route] をクリックします。シミュレーションを停止するには、[Stop route] をクリックします。指定した経路に沿ってエミュレータで継続的にシミュレートするには、[Repeat playback] のスイッチを有効にします。エミュレータが指定された経路をたどる速度を変更するには、[Playback speed] メニューから速度を選択します。 GPX データと KML データをインポートする GPS データ交換フォーマット（GPX）やキーホールマークアップ言語（KML）ファイルの地理情報データを利用する方法は以下のとおりです。 [Load GPX/KML] をクリックします。ファイルダイアログでコンピュータ上にあるファイルを選択して [Open] をクリックします。任意で [Speed] を選択します。速度はデフォルトで [Delay]（Speed 1X）に設定されています。速度は 2 倍（Speed 2X）、3 倍（Speed 3X）のように増加させることができます。実行アイコンをクリックします。
電話	エミュレータで電話の着信やテキストメッセージの受信をシミュレートできます。エミュレータへの通話を開始する方法は次のとおりです。 [From] フィールドで電話番号の選択または入力を行います。 [Call Device] をクリックします。必要に応じて、[Hold Call] をクリックして通話を保留にします。 [End Call] をクリックして、通話を終了します。エミュレータにテキストメッセージを送信する方法は以下のとおりです。 [From] フィールドで電話番号の選択または入力を行います。 [SMS message] フィールドでメッセージを入力します。 [Send Message] をクリックします。
十字キー	AVD のハードウェアプロファイルで十字キーが有効になっている場合は、エミュレータで十字キーを利用できます。ただし、Android スマートウォッチなどの一部のデバイスは十字キーに対応していません。各ボタンがシミュレートする動作は以下のとおりです。
マイク	プライバシーとパフォーマンス上の理由から、Android Emulator ではデフォルトでマイク入力が無効になっています。マイク入力を有効にするには、[Virtual microphone uses host audio input] オプションを切り替えます。Android Emulator には、さまざまなヘッドフォンとマイクのシナリオをシミュレートするための切り替えボタンとキーイベントがあります。 Virtual microphone uses host audio input: 有効にすると、エミュレータはホストマイクからオーディオ入力を受け取ります。無効にすると、エミュレータは音声入力を受け取りません。なお、このオプションを初めて有効にしたときに、ホストオペレーティングシステム（Windows、macOS、Linux）からマイクへのアクセス権の許可を求められることがあります。 Virtual headset plug inserted: このオプションは、3.5 mm オーディオジャックにヘッドフォンとマイクを挿入することをシミュレートします。このオプションを切り替えると、`SW_HEADPHONE_INSERT` 入力イベントと `SW_MICROPHONE_INSERT` 入力イベントの両方がトリガーされ、シミュレートされたハードウェア接続が Android システムに通知されます。 Virtual headset has microphone: このオプションは、接続されたヘッドセットにマイクが存在することをシミュレートします。このオプションを切り替えると、`KEY_HEADSETHOOK` キーイベントがトリガーされます。この Android キーコードは、通話への応答、通話の終了、メディアの再生の制御などの操作によく使用されます。音声アシスタント: このオプションは、デバイスの音声アシスタントの起動をシミュレートします。このオプションを切り替えると、`KEYCODE_ASSIST` キーイベントがトリガーされます。この Android キーコードは、デバイスのアシスタントアプリ（Google アシスタントなど）を起動するために使用されます。
指紋	このコントロールでは 10 種の異なる指紋スキャンをシミュレートできます。この機能を使用して、アプリで指紋機能の統合をテストできます。この機能は、Android 5.1（API レベル 22）以前、および Wear OS では無効です。仮想デバイス上で指紋のスキャンをシミュレートする方法は次のとおりです。指紋データを受信するアプリを用意します。 [Fingerprint] の値を選択します。 [Touch Sensor] をクリックします。
Virtual sensors > Device Pose	このコントロールでは、デバイスの位置および / またはデバイスの向きの変化に対するアプリの反応をテストできます。たとえば、傾きや回転などのジェスチャーをシミュレートできます。加速度センサーは、デバイスの絶対位置を追跡することはありません。変更が発生したことを検出するだけです。このコントロールは、実際のデバイスを移動または回転させたときの加速度センサーと磁力計センサーの反応をシミュレートします。このコントロールを使用するには、AVD の加速度センサーを有効にする必要があります。このコントロールは、x、y、z 軸で `TYPE_ACCELEROMETER` イベントをレポートします。これらの値には重力が影響します。たとえば、デバイスが宇宙空間で吊り下げられている場合、加速度はゼロになります（x、y、z はすべて 0 になります）。デバイスが地球上にあり、テーブル上に画面を上にして置くと、重力のために加速度は 0、0、9.8 になります。このコントロールは `TYPE_MAGNETIC_FIELD` イベントもレポートします。このイベントでは、x、y、z 軸の周囲磁場をマイクロテスラ（μT）単位で測定します。 x、y、z 軸でデバイスを回転させるには、[Rotate] を選択して、次のいずれかを行います。 [Yaw]、[Pitch]、[Roll] スライダーを調整し、上部ペインで位置を確認します。上部ペインに表示されているデバイスを移動させ、[Yaw]、[Pitch]、[Roll] と、その結果生じる加速度計値の変化を確認します。 Yaw、Pitch、Roll の計算方法の詳細は、デバイスの向きの計算に関する説明をご覧ください。デバイスを水平（x）または垂直（y）に移動するには、[Move] を選択し、次のいずれかを行います。 [X] スライダーと [Y] スライダーを調整し、上部ペインで位置を確認します。上部ペインに表示されているデバイスを移動させ、[X]、[Y] のスライダー値と、その結果生じる加速度計値の変化を確認します。デバイスを 0、90、180、270 度に配置するには: [Device rotation] 領域で、回転を変更するボタンを選択します。デバイスを調整すると、それに応じて [Resulting values] フィールドが変わります。これらの値には、アプリからアクセスできます。上記のセンサーの詳細については、センサーの概要、モーションセンサー、位置センサーをご覧ください。
Virtual sensors > Additional sensors	エミュレータは、さまざまな位置および環境センサーをシミュレートできます。以下のセンサーを調整して、アプリでテストできます。 Ambient temperature: この環境センサーは周囲の気温を測定します。 Magnetic field: この位置センサーは、それぞれ X、Y、Z 軸の周囲磁場を測定します。値の単位はマイクロテスラ（μT）です。 Proximity: この位置センサーは、対象物からの距離を測定します。たとえば、電話をかけるために顔がスマートフォンに近づいたことを通知できます。このコントロールを使用するには、AVD で近接センサーを有効にする必要があります。 Light: この環境センサーは照度を測定します。値はルクス単位です。 Pressure: この環境センサーは、周囲の気圧を測定します。値はミリバール（hPa）単位です。 Relative Humidity: この環境センサーは、周囲の相対湿度を測定します。これらのセンサーの詳細については、センサーの概要、位置センサー、環境センサーをご覧ください。
バグレポート	エミュレータで問題が発生した場合は、バグレポートを作成して送信できます。エミュレータは、バグレポート用のスクリーンショットやログなどのデータを自動的に収集します。
Record and Playback	画面の録画をご覧ください。
Google Play	AVD システムイメージに Play ストアアプリが含まれている場合、Google Play 開発者サービスのバージョン情報が表示されます。
Settings > General	Emulator window theme: [Light] か [Dark] を選択します。 Send keyboard shortcuts to: デフォルトでは、いくつかのキーの組み合わせでエミュレータのコントロールショートカットがトリガーされます。キーボードショートカット機能に対応したアプリを開発している場合（Bluetooth キーボードを使うデバイスを対象とするアプリなど）、この設定を変更することで、エミュレータでショートカットとみなされる入力を含め、すべてのキーボード入力を仮想デバイスに送信できます。 Screenshot save location: フォルダアイコンをクリックして、エミュレータ画面のスクリーンショットを保存する場所を指定します。 Use detected ADB location: Android Studio からエミュレータを実行している場合は、この設定（デフォルト値）を選択します。Android Studio 以外からエミュレータを実行しており、特定の `adb` 実行ファイルを使用したい場合は、このオプションの選択を解除して SDK Tools の場所を指定してください。この設定が正しくない場合、スクリーンショットのキャプチャやドラッグ＆ドロップによるアプリのインストールなどの機能は動作しません。 When to send crash reports: [Always]、[Never]、[Ask] のいずれかを選択します。 Show window frame around device: デフォルトでは、デバイスのスキンファイルを含むエミュレータが周囲のウィンドウフレームなしで表示されます。
Settings > Proxy	エミュレータはデフォルトで Android Studio の HTTP プロキシ設定を使用します。この画面では、エミュレータの HTTP プロキシ設定を手動で定義できます。詳細については、エミュレータでプロキシを使用するをご覧ください。
Settings > Advanced	OpenGL ES renderer: グラフィックアクセラレーションタイプを選択します（これは `-gpu` コマンドラインオプションと同じです）。 Autodetect based on host: エミュレータがハードウェアかソフトウェアのどちらのグラフィックアクセラレーションを使用するかを、コンピュータのセットアップに基づいて選択します。既知の障害がある GPU ドライバのリストにコンピュータの GPU ドライバがあるかを確認し、ある場合、エミュレータはグラフィックハードウェアエミュレーションを無効にして、代わりに CPU を使用します。 ANGLE:（Windows のみ）ANGLE Direct3D を使用して、ソフトウェアでグラフィックをレンダリングします。 SwiftShader: SwiftShader を使用して、ソフトウェアでグラフィックをレンダリングします。 Desktop native OpenGL: ホストコンピュータの GPU を使用します。通常、このオプションは最速のパフォーマンスを提供します。ただし、一部のドライバには OpenGL グラフィックのレンダリングに問題があるため、信頼できるオプションではない場合があります。 OpenGL ES API level: エミュレータで使用する OpenGL ES の最大バージョンを選択します。 Autoselect: ホストおよびゲストのサポートに基づいて、エミュレータが使用する OpenGL ES のバージョンが選択されます。 Renderer maximum (up to OpenGL ES 3.1): OpenGL ES の最大バージョンの使用を試みます。 Compatibility (OpenGL ES 1.1/2.0): ほとんどの環境と互換性のあるバージョンの OpenGL ES を使用します。
Help > Keyboard Shortcuts	このペインには、エミュレータのキーボードショートカットの一覧が表示されます。エミュレータでの操作中にこのペインを開くには、`F1`（macOS では `Command`+`/`）キーを押します。ショートカットを有効にするには、[General] 設定ペインの [Send keyboard shortcuts] オプションを [Emulator controls (default)] に設定する必要があります。
Help > Emulator Help	エミュレータのオンラインドキュメントを参照するには、[Documentation] をクリックします。エミュレータのバグを報告するには、[Send feedback] をクリックします。詳細については、エミュレータのバグを報告する方法をご覧ください。
Help > About	エミュレータで使用している `adb` ポートや、Android とエミュレータのバージョン番号を確認できます。使用中のエミュレータのバージョンと最新バージョンを比較して、最新のソフトウェアをインストールしているか確認してください。エミュレータのシリアル番号は emulator-`adb_port` です。これは `adb` コマンドラインのオプションとして指定できます。