Adaptive Performance Android provider

The Adaptive Performance Android provider extends Adaptive Performance to Android devices. To do this, it sends device-specific information from Android devices to the Adaptive Performance package. This enables you to retrieve data about the thermal state and performance mode of Android devices.

This package integrates with the following Android frameworks and APIs:

• Android Dynamic Performance Framework (ADPF) (more info)

  • The following APIs are integrated into Adaptive Performance IThermalStatus to retrieve thermal information about the device.
    • getThermalHeadroom
    • getCurrentThermalStatus
    • ThermalStatusChangedListener
  • The following APIs are integrated into the game loop to retrieve and send performance related details to Android.
    • createHintSession
    • getPreferredUpdateRateNanos
    • reportActualWorkDuration

• GameMode API (more info)

  • The Android GetGameMode API is integrated into Adaptive Performance IPerformanceModeStatus
  • IAdaptivePerformanceSettings.automaticGameMode property controls whether to adjust the target frame rate according to the current device GameMode setting. You can change this property using the Adaptive Performance Android provider setting Auto Game Mode . When the Auto Game Mode is turned on, the following adjustments occur:
    • Battery saver mode lowers the target frame rate to 30 fps.
    • Performance mode raises the target frame rate to the highest supported by the display.
    • Standard mode sets the Application.targetFrameRate to -1, which instructs player to use the default frame rate. The default frame rate on mobile platforms is 30 fps.
  • Unity API also includes Android.AndroidGame.GameMode property.

• GameState API (more info)

  • Unity API includes Android.AndroidGame.SetGameState method to make manual calls to the Android GameManager.

• System Health power monitors (more info)

  • The SystemHealthManager power monitor APIs (getSupportedPowerMonitors and getPowerMonitorReadings) are integrated into Adaptive Performance IEnergyUsageControl and EnergyUsage to report the energy that each hardware component (such as the CPU and GPU) consumes. These readings require Android 15 (API level 35) or later, and the application's target API level must also be 35 or later. The hardware updates readings at its own cadence, which is typically every 20 to 30 seconds.

For information on what's new in the latest version of Adaptive Performance Android, see the Changelog.