Adaptive Performance Simulator extension

Adaptive Performance adds a section of controls to the Device Simulator window to let you simulate thermal and bottleneck events in the Editor. This should help you to test your Adaptive Performance implementations in the Editor without the need to deploy your app to a device. The extension uses the SimulatorAdaptivePerformanceSubsystem to simulate the events.

When you install the Adaptive Performance package, Unity automatically installs the Simulator provider. To enable the Simulator, you must:

  • Activate the Simulator provider for Desktop platforms in the Project Settings window
  • Install the Device Simulator package.

Adaptive Performance Device Simulator settings.

The simulator provider has several settings for development and runtime, which are available for each individual provider. For more information, see the Adaptive Performance user guide.

Adaptive Performance Device Simulator Settings.

Device Simulator window

Adaptive Performance Device Simulator settings.

After you install Adaptive Performance, the Device Simulator window will display the following additional settings to simulate various thermal and bottleneck conditions:

Thermal

  • Warning Level - Simulates a thermal warning level. The options are No Warning, Throttling Imminent, and Throttling.
  • Level - The temperature level simulates the skin temperature level of a device. Options range between nominal temperature (0) and critical throttling temperature (maximum level of 1.0).
  • Trend - Temperature trends with a value below 0 simulate a temperature drop. Values higher than 0 simulate a temperature increase.

Performance

  • Bottleneck - Simulate the device bottleneck, which can be CPU, GPU, or target frame rate bound. Target framerate is either VSync or the value set in Application.TargetFramerate.
  • Auto Control Mode - Sets CPU and GPU level automatically. If the system is throttling performance, the Control Mode is set to System and Auto Control Mode has no influence.
  • Target FPS - Simulates the application target framerate in frames per second.
  • CPU Level - Simulates the frequency cap of the CPU in discrete levels.
  • GPU Level - Simulates the frequency cap of the GPU in discrete levels.

Developer Options

  • Logging - Enable or disable logging from the Adaptive Performance subsystem.
  • Logging Frequency - Control Adaptive Performance logging frequency in frames.

Adaptive Performance also includes an API that you can use to script thermal and bottleneck changes.

Indexer and Scalers

Adaptive Performance Device Simulator Scaler settings.

Scalers may also be used with the Device Simulator. In this section you will find a list of all the available Scalers. Each one will have the following options.

  • A toggle to enable or disable the Scaler.
  • A slider to adjust the value of the Scaler.
  • A text field to enter a value or reflect the current value of the slider.