Device Simulator

Overview

Device Simulator is an alternative to the traditional Unity editor Game window. By simulating Screen and SystemInfo class behavior, Device Simulator aims to give an accurate picture of how an app will look on a device.

Requirements

  • Compatible with Unity 2019.3 or above.

Supported Features

  • Screen class simulation.
  • SystemInfo class simulation.
  • Show precise screen shape, with notch and rounded corners.

Installing Device Simulator Package

To install Device Simulator package, follow the instructions in the Package Manager documentation.

You can access Device Simulator window in Unity Editor via

  • Menu: Window > General > Device Simulator
  • Menu: Simulator menu in Game view toolbar to switch to Device Simulator view.

Using Device Simulator

Device Simulator window

1. Game view mode

Switch between Game view and Simulator view.

2. Device selection

Select from the available devices.

3. Reload

Initialise simulation of Screen and SystemInfo classes using Player Settings without causing a domain reload.

4. Scale

Controls how big the device appears inside the simulator window.

5. Fit to Screen

Automatically scale device to fit snugly inside the window.

6. Rotate

Physically rotate the device. Depending on whether auto rotation is enabled or disabled, the actual picture may or may not rotate together with the device.

Highlight Safe Area

7. Highlight Safe Area

Draw a border around the current Screen.safeArea

Highlight Safe Area

8. Device Specifications

Shows the most important data of the currently simulated device:

  • Device OS
  • Device CPU/GPU
  • Device Resolution

9. Screen Settings

Allow viewing and changing the values of the Screen class.

10. Preferences

You can access Device Simulator preferences by menu Edit > Preferences > Device Simulator, where you can

  • Set the customised device directory, please make sure your device json files end with ".device.json".
  • Set color and width of the safe area highlight line. Please reopen the Device Simulator window after setting the customised device directory.

Document revision history

Date Reason
Nov 15, 2019 Document Updated. Matches package version 1.3.0-preview
Oct 11, 2019 Document Updated. Matches package version 1.2.0-preview
Sep 26, 2019 Document Updated. Matches package version 1.1.0-preview
Sep 23, 2019 Document Updated. Matches package version 1.0.0-preview