Legacy Documentation: Version 4.6
Language: English
Tags and Layers
Network Group

Time Manager

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

The Time Manager
The Time Manager

Properties

Property: Function:
Fixed Timestep A framerate-independent interval that dictates when physics calculations and FixedUpdate() events are performed.
Maximum Allowed Timestep A framerate-independent interval that caps the worst case scenario when frame-rate is low. Physics calculations and FixedUpdate() events will not be performed for longer time than specified.
Time Scale The speed at which time progress. Change this value to simulate bullet-time effects. A value of 1 means real-time. A value of .5 means half speed; a value of 2 is double speed.

Details

Fixed Timestep

Fixed time stepping is very important for stable physics simulation. Not all computers are made equal, and different hardware configurations will run Unity games with varying performance. Therefore, physics must be calculated independently of the game’s frame rate. Physics calculations like collision detection and Rigidbody movement are performed in discrete fixed time steps that are not dependent on frame rate. This makes the simulation more consistent across different computers or when changes in the frame rate occur. For example, the frame rate can drop due to an appearance of many game onscreen, or because the user launched another application in the background.

Here’s how the fixed time step is calculated. Before every frame is drawn onscreen, Unity advances the fixed time by fixed delta time and performs physics calculations until it reaches the current time. This directly correlates to the Fixed Timestep property. The smaller the value of Fixed Timestep, the more frequently physics will be calculated. The number of Fixed frames per second can be calculated by dividing 1 by Fixed Timestep. Therefore, 1 / 0.02 = 50 fixed frames per second and 1 / 0.05 = 20 fixed frames per second.

Simply put, a smaller fixed update value leads to more accurate physics simulation but is heavier on the CPU.

Maximum Allowed Timestep

Fixed time stepping ensures stable physics simulation. However it can cause negative impact on performance if game is heavy on physics and is already running slow or occasionally dips to low frame rate. Longer the frame takes to process - more fixed update steps will have to be executed for the next frame. This results in performance degradation. To prevent such scenario Unity iOS introduced Maximum Allowed Timestep which ensures that physics calculations will not run longer than specified threshold.

If frame takes longer to process than time specified in Maximum Allowed Timestep, then physics will “pretend” that frame took only Maximum Allowed Timestep seconds. In other words if frame rate drops below some threshold, then rigid bodies will slow down a bit allowing CPU to catch up.

Maximum Allowed Timestep affects both physics calculation and FixedUpdate() events.

Maximum Allowed Timestep is specified in seconds as Fixed Timestep. Therefore setting 0.1 will make physics and FixedUpdate() events to slow down, if frame rate dips below 1 / 0.1 = 10 frames per second.

Typical scenario

  1. Let’s assume Fixed Timestep is 0.01, which means that PhysX, fixedUpdate and animations should be processed every 10 ms.
  2. When your frame time is about 33 ms then fixed loop is executed 3 times per visual frame on average.
  3. But frametime isn’t fixed constant and depends on many factors including your scene state, OS background taks, etc.
  4. Because of 3. reasons frametime sometimes can reach 40–50 ms, which means that fixed step loop will be executed 4–5 times.
  5. When your fixed timestep tasks are pretty heavy then time spent on PhysX, fixedUpdates and animations extend your frametime by another 10 ms, which means one more additional iteration of all these fixed timestep tasks.
  6. In some unlucky cases process described in 5. could extend to 10 and more times of processing fixed step loop.
  7. That’s why Maximum Allowed Timestep was introduced, it is the method to limit how much times PhysX, fixedUpdates and animations can be processed during single visual frame. If you have Maximum Allowed Timestep set to 100 ms and your Fixed Timestep is 10 ms, then for fixed step tasks will be executed up to 10 times per visual frame. So sometimes small performance hitch could trigger big performance hitch because of increased fixed timestep iteration count. By decreasing Maximum Allowed Timestep to 30 ms, you are limiting max fixed step iteration count to 3 and this means that your PhysX, fixedUpdate and animation won’t blow your frametime up very much, but there is some negative effect of this limiting. Your animations and physics will slow down a bit when performance hitch occurs.

Hints

  • Give the player control over time by changing Time Scale dynamically through scripting.
  • If your game is physics heavy or spends significant amount of time in FixedUpdate() events, then set Maximum Allowed Timestep to 0.1. This will prevent physics from driving your game below 10 frames per second.
Tags and Layers
Network Group