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

エミュレータを使用すると、サイズをカスタマイズできる複数のディスプレイにアプリをデプロイして、マルチウィンドウやマルチディスプレイをサポートするアプリをテストできます。仮想デバイスの実行中、次のように、最大 2 つのディスプレイを追加できます。

1. ディスプレイを 1 つ追加するには、[Add secondary display] をクリックします。
2. [Secondary displays] のメニューで、次のいずれかを行います。
   1. プリセットされているアスペクト比のいずれかを選択します。
   2. [custom] を選択して、カスタム ディスプレイの高さ、幅、dpi を設定します。
3. （省略可）3 つ目のディスプレイを追加するには、[Add secondary display] をクリックします。
4. [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

[バッテリー ヘルス] の値を選択します。

• Good（デフォルト）
• Failed
• Dead
• Overvoltage
• Overheated
• Unknown

[Battery status] の値を選択します。

• Unknown
• Charging（デフォルト）
• Discharging
• Not charging
• Full

エミュレータでは「現在地」情報（エミュレートしているデバイスがある場所）をシミュレートできます。たとえば、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 つ以上の場所の間に経路を作成できます。経路を作成して保存する手順は次のとおりです。

1. 地図表示で、テキスト フィールドを使用して経路の最初の目的地を検索します。
2. 検索結果から場所を選択します。
3. ナビゲーション ボタン を選択します。
4. 地図から経路の出発地を選択します。
5. （省略可）[Add destination] をクリックして、経由地をルートに追加します。
6. 地図表示で [Save route] をクリックして経路を保存します。
7. ルートの名前を指定して、[Save] をクリックします。

保存した経路に沿ってエミュレータでシミュレートするには、[Saved routes] リストから経路を選択し、[Extended controls] ウィンドウの右下にある [Play route] をクリックします。シミュレーションを停止するには、[Stop route] をクリックします。

指定した経路に沿ってエミュレータで継続的にシミュレートするには、[Repeat playback] のスイッチを有効にします。エミュレータが指定された経路をたどる速度を変更するには、[Playback speed] メニューから速度を選択します。

GPX データと KML データをインポートする

GPS データ交換フォーマット（GPX）やキーホール マークアップ言語（KML）ファイルの地理情報データを利用する方法は以下のとおりです。

1. [Load GPX/KML] をクリックします。
2. ファイル ダイアログでコンピュータ上にあるファイルを選択して [Open] をクリックします。
3. 任意で [Speed] を選択します。

速度はデフォルトで [Delay]（Speed 1X）に設定されています。速度は 2 倍（Speed 2X）、3 倍（Speed 3X）のように増加させることができます。

4. 実行アイコン をクリックします。

エミュレータで電話の着信やテキスト メッセージの受信をシミュレートできます。

エミュレータへの通話を開始する方法は次のとおりです。

1. [From] フィールドで電話番号の選択または入力を行います。
2. [Call Device] をクリックします。
3. 必要に応じて、[Hold Call] をクリックして通話を保留にします。
4. [End Call] をクリックして、通話を終了します。

エミュレータにテキスト メッセージを送信する方法は以下のとおりです。

1. [From] フィールドで電話番号の選択または入力を行います。
2. [SMS message] フィールドでメッセージを入力します。
3. [Send Message] をクリックします。

AVD のハードウェア プロファイルで十字キーが有効になっている場合は、エミュレータで十字キーを利用できます。ただし、Android スマートウォッチなどの一部のデバイスは十字キーに対応していません。各ボタンがシミュレートする動作は以下のとおりです。

プライバシーとパフォーマンス上の理由から、Android エミュレータではマイク入力はデフォルトで無効になっています。マイク入力を有効にするには、[Virtual microphone uses host audio input] オプションを切り替えます。Android エミュレータには、さまざまなヘッドフォンとマイクのシナリオをシミュレートするための切り替えとキーイベントが用意されています。

• 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 では無効です。

仮想デバイス上で指紋のスキャンをシミュレートする方法は次のとおりです。

1. 指紋データを受信するアプリを用意します。
2. [Fingerprint] の値を選択します。
3. [Touch Sensor] をクリックします。

このコントロールでは、デバイスの位置および / またはデバイスの向きの変化に対するアプリの反応をテストできます。たとえば、傾きや回転などのジェスチャーをシミュレートできます。加速度センサーは、デバイスの絶対位置を追跡することはありません。変更が発生したことを検出するだけです。このコントロールは、実際のデバイスを移動または回転させたときの加速度センサーと磁力計センサーの反応をシミュレートします。

このコントロールを使用するには、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] フィールドが変わります。これらの値には、アプリからアクセスできます。

上記のセンサーの詳細については、センサーの概要、モーション センサー、位置センサーをご覧ください。

エミュレータは、さまざまな位置および環境センサーをシミュレートできます。以下のセンサーを調整して、アプリでテストできます。

• Ambient temperature: この環境センサーは周囲の気温を測定します。
• Magnetic field: この位置センサーは、それぞれ X、Y、Z 軸の周囲磁場を測定します。値の単位はマイクロテスラ（μT）です。
• Proximity: この位置センサーは、対象物からの距離を測定します。たとえば、電話をかけるために顔がスマートフォンに近づいたことを通知できます。このコントロールを使用するには、AVD で近接センサーを有効にする必要があります。
• Light: この環境センサーは照度を測定します。値はルクス単位です。
• Pressure: この環境センサーは、周囲の気圧を測定します。 値はミリバール（hPa）単位です。
• Relative Humidity: この環境センサーは、周囲の相対湿度を測定します。

これらのセンサーの詳細については、センサーの概要、位置センサー、環境センサーをご覧ください。

• 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: デフォルトでは、デバイスのスキンファイルを含むエミュレータが周囲のウィンドウ フレームなしで表示されます。

エミュレータはデフォルトで Android Studio の HTTP プロキシ設定を使用します。この画面では、エミュレータの HTTP プロキシ設定を手動で定義できます。詳細については、エミュレータでプロキシを使用するをご覧ください。

• 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 を使用します。

このペインには、エミュレータのキーボード ショートカットの一覧が表示されます。エミュレータでの操作中にこのペインを開くには、F1（macOS では Command+/）キーを押します。

ショートカットを有効にするには、[General] 設定ペインの [Send keyboard shortcuts] オプションを [Emulator controls (default)] に設定する必要があります。

このメニュー オプションは、Android Studio でエミュレータが埋め込みモードで実行されている場合は使用できません。エミュレータを埋め込みモードで使用している場合は、[Running Devices] の [File]（macOS では [Android Studio]）> [Settings] > [Keymap] でキーボード ショートカットを確認できます。

エミュレータのオンライン ドキュメントを参照するには、[Documentation] をクリックします。

エミュレータのバグを報告するには、[Send feedback] をクリックします。詳細については、エミュレータのバグを報告する方法をご覧ください。

このメニュー オプションは、Android Studio でエミュレータが埋め込みモードで実行されている場合は使用できません。エミュレータを埋め込みモードで使用している場合は、[Help] > [Submit a Bug Report] をクリックしてバグ テンプレートを開き、Android Emulator のバグの詳細を手動で追加します。

エミュレータで使用している adb ポートや、Android とエミュレータのバージョン番号を確認できます。使用中のエミュレータのバージョンと最新バージョンを比較して、最新のソフトウェアをインストールしているか確認してください。

エミュレータのシリアル番号は emulator-adb_port です。これは adb コマンドラインのオプションとして指定できます。