Applicable XR devices This guidance helps you build experiences for these types of XR devices. [Learn about XR device types →](https://developer.android.com/develop/xr/devices)  XR Headsets [](https://developer.android.com/develop/xr/devices#xr-headsets)  Wired XR Glasses [](https://developer.android.com/develop/xr/devices#xr-glasses) [Learn about XR device types →](https://developer.android.com/develop/xr/devices)
As you test your app, use the Android XR Emulator to extend your testing capacity beyond your physical test devices. You can use the emulator controls to help you test how your app behaves in common scenarios with XR headsets and XR glasses. See the following sections for details about running your [virtual Android XR devices](https://developer.android.com/develop/xr/jetpack-xr-sdk/run/create-avds/xr-headsets-glasses) in the emulator and the emulator controls you can use. > [!IMPORTANT] > **Important:** Check that you're [using the latest Canary build of Android Studio](https://developer.android.com/studio/preview) and that you've [configured > Studio for XR development](https://developer.android.com/develop/xr/jetpack-xr-sdk/get-studio) with the latest versions of all the required tools. [ See also If this your first time using an emulator with Android Studio, review the Android Emulator documentation.](https://developer.android.com/studio/run/emulator) ## Run your app on the emulator 1. To start the emulator, click **Run** for the AVD in the Device Manager.  The emulator opens in the side panel.  2. To launch your app in the emulator, click **Run** in the Android Studio main toolbar.  > [!CAUTION] > **Caution:** In rare cases for Windows users, using the Android XR Emulator with either an XR headset or XR glasses AVD might result in system freezes or crashes on some Windows configurations. Save all your data before running the emulator. As a workaround, [enable WHPX](https://developer.android.com/studio/run/emulator-acceleration#vm-windows-whpx). See [release notes](https://developer.android.com/studio/preview/features) for more known issues. ## Use emulator controls for XR headsets and XR glasses When the Android XR Emulator loads, look for the menu like the one shown in figure 1. Use the controls in this menu to interact with the emulator.  **Figure 1.** Use the controls in the emulator menu to interact with the emulator. ### Interact with apps The emulator supports multiple interaction modes. To interact with the system or an Android app, select one of the following modes from the emulator controls:  **Figure 2.** Select a mode to interact with app in the emulator. - **Hand tracking**: hands automatically direct their raycasts toward your mouse pointer position. Drag to perform pinch interactions to select, hold, or manipulate a panel or 3D object. > [!NOTE] > **Note:** The emulator currently supports single-handed (right hand only) pinch interactions. Left-hand controls and alternative gestures, such as grabbing and poking, aren't currently supported. - **Eye tracking**: the emulator simulates the user's eye-gaze focus using your mouse pointer's position in 3D space. Moving your mouse shifts the gaze focus across UI elements. Click your mouse to select the focused UI element. - **Connected mouse and keyboard**: move your mouse cursor over the emulator window to interact directly with elements within the virtual space.
### Look and move around in the virtual environment The Android XR Emulator renders apps and their content in a virtual 3D environment. Use the following controls to change the direction of your view: |---|---| |  | **Rotate**: Drag the mouse to pivot your view in that direction. | |  | **Pan** : Drag the mouse to move up, down, and side to side. This lets you view the emulator contents from different angles. | |  | **Dolly**: Drag the mouse to move closer or farther from the objects in view. | |  | **Reset**: Click this button to return the emulator to the default view. | You can also use the following keyboard shortcuts to move around in the virtual environment. To use these while using mouse and keyboard input, hold the `Option` key (macOS) or `Alt` key (Windows). - `W`: (or up arrow key): Move forward in your current view. - `A`: (or left arrow key): Side-step left. - `S`: (or down arrow key): Move backward. - `D`: (or right arrow key): Side-step right. - `Q`: Move vertically downward. - `E`: Move vertically upward. ### Enable passthrough mode The menu at the top of the emulator includes the Toggle Passthrough option to enable or disable a simulated passthrough environment.  **Figure 3.** Toggle passthrough to see a simulated passthrough environment. When enabled, passthrough mode displays a simulated indoor environment. Use this mode to test apps in mixed reality.  **Figure 4.** A simulated passthrough environment shows spatial UI elements anchored within a room. ### Adjust the environment dimming levels on XR glasses [XR Glasses](https://developer.android.com/design/ui/xr/guides/get-started#xr-glasses-wired) utilize additive displays on semi-transparent lenses and can also include dimming technology. By darkening the physical background, these lenses ensure that digital content remains crisp and legible, even in bright physical environments. Use the emulator's environment dimming controls to accurately preview immersive content on XR glasses. To adjust the dimming levels, click the **Environment Visibility** icon and use the environment dimming slider to pick a level between fully transparent and maximum opacity.  **Figure 5.** By adjusting the dimming levels, you can accurately preview how your digital content blends with or stands out against the physical world. ### Other emulator controls You can also use the following emulator controls: |---|---| |  | **Power**: Simulates powering the device on or off. | |   | **Volume**: Simulates volume control. | |   | **Screenshot**: Takes a screenshot or screen recording of the current state of the device. | | :back:   | **Android 3 button controls**: Simulates the Back, Home, and Overview buttons. |