<!--
{
  "availability" : [
    "iOS: 26.0.0 - 27.3.0",
    "iPadOS: 26.0.0 - 27.3.0",
    "macCatalyst: 26.0.0 - 27.0.0",
    "macOS: 26.0.0 - 27.3.0",
    "visionOS: 26.0.0 - 27.3.0"
  ],
  "documentType" : "symbol",
  "framework" : "MetricKit",
  "identifier" : "/documentation/MetricKit/MXAnimationMetric/hitchTimeRatio",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "MetricKit"
    ],
    "preciseIdentifier" : "c:objc(cs)MXAnimationMetric(py)hitchTimeRatio"
  },
  "title" : "hitchTimeRatio"
}
-->

# hitchTimeRatio

The ratio of time spent hitching during tracked animations.

```
var hitchTimeRatio: Measurement<Unit> { get }
```

## Discussion

Hitches are user-perceivable animation issues, such as pauses or jumps that occur during scrolling. This metric incorporates adjustments that optimize for quantifying human perception, and typically is the most accurate representation of hitches people experience during app usage.

Many animations are tracked by default. You can track additional animations using the <doc://com.apple.documentation/documentation/Foundation/ProcessInfo/beginActivity(options:reason:)> method with the <doc://com.apple.documentation/documentation/Foundation/ProcessInfo/ActivityOptions/animationTrackingEnabled> option.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)