Develop

Set CPU and GPU Levels

Updated: Apr 17, 2026

Overview

Sets performance level suggestions for the CPU and GPU clock rates on mobile devices, as described in Plugin Settings.
These performance levels are only suggestions. Dynamic Clock Throttling treats the suggested CPU and GPU levels as a baseline target, but the system can increase or decrease the CPU and GPU performance as necessary to keep power consumption and heat within device tolerances. The goal of this system is to retain the advantages of a Fixed Clock Policy while mitigating some of its drawbacks.
The performance levels are:
Performance LevelDescription
PowerSavings
Most power efficient. Lowest clock rate. Recommended for non-XR sections such as head-locked or static screens where power savings are the priority.
SustainedLow
Less power efficient. Low clock rate. Suitable for sections with low and stable complexity where reducing power is more important than occasional late frames.
SustainedHigh
High performance. Supports consistent XR compositing and frame rendering within a thermally sustainable range.
Boost
Highest clock rate. Allows the runtime to step beyond the thermally sustainable range for short periods. Currently equivalent to SustainedHigh on Meta Quest and not recommended.
The Boost performance level is currently equivalent to SustainedHigh on Meta Quest and is not recommended for use in Quest apps. If used, it should only be suggested for short periods as its power consumption and heat generation can quickly trigger dynamic clock throttling.
The default performance levels at startup are SustainedLow for the CPU and SustainedHigh for the GPU. You can configure these defaults in Edit > Project Settings > Plugins > Meta XR > Mobile, and change them at runtime using the Blueprint nodes described below.

Set Suggested CPU and GPU Performance Levels Blueprint

To set a suggested performance level, use the Set Suggested CPU and GPU Performance Levels Blueprint.
Set Suggested CPU and GPU Performance Levels Blueprint

Inputs

  • Cpu Perf Level: The suggested performance level for the CPU clock rate. Options are:
    • PowerSavings: Most power efficient. Lowest clock rate.
    • SustainedLow: Less power efficient. Low clock rate.
    • SustainedHigh: High performance. Suitable for consistent XR compositing and frame rendering within a thermally sustainable range.
    • Boost: Highest clock rate. Currently equivalent to SustainedHigh on Meta Quest and not recommended for use in Quest apps.
  • Gpu Perf Level: The suggested performance level for the GPU clock rate. Options are:
    • PowerSavings: Most power efficient. Lowest clock rate.
    • SustainedLow: Less power efficient. Low clock rate.
    • SustainedHigh: High performance. Suitable for consistent XR compositing and frame rendering within a thermally sustainable range.
    • Boost: Highest clock rate. Currently equivalent to SustainedHigh on Meta Quest and not recommended for use in Quest apps.

Outputs

None.

Get Suggested CPU and GPU Performance Levels Blueprint

To get the current suggested performance levels, use the Get Suggested CPU and GPU Performance Levels Blueprint.
Get Suggested CPU and GPU Performance Levels Blueprint

Inputs

None.

Outputs

  • Cpu Perf Level: The suggested performance level for the CPU clock rate. Options are:
    • PowerSavings: Most power efficient. Lowest clock rate.
    • SustainedLow: Less power efficient. Low clock rate.
    • SustainedHigh: High performance. Suitable for consistent XR compositing and frame rendering within a thermally sustainable range.
    • Boost: Highest clock rate. Currently equivalent to SustainedHigh on Meta Quest and not recommended for use in Quest apps.
  • Gpu Perf Level: The suggested performance level for the GPU clock rate. Options are:
    • PowerSavings: Most power efficient. Lowest clock rate.
    • SustainedLow: Less power efficient. Low clock rate.
    • SustainedHigh: High performance. Suitable for consistent XR compositing and frame rendering within a thermally sustainable range.
    • Boost: Highest clock rate. Currently equivalent to SustainedHigh on Meta Quest and not recommended for use in Quest apps.
Nav Logo
Virtual reality / Meta Horizon
Virtual reality / Meta Horizon
Virtual reality / Meta Horizon
English (US)
© 2026 Meta