The force of the touch, where a value of
1 represents the force of an average touch (predetermined by the system, not user-specific).
- iOS 9.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
This property is available on devices that support 3D Touch or Apple Pencil. To check at runtime if a device supports 3D Touch, read the value of the
force property on the trait collection for any object in your app with a trait environment.
The force reported by Apple Pencil is measured along the axis of the pencil. If you want a force perpendicular to the device, you need to calculate this value using the
The force reported by Apple Pencil is estimated at first, and may not always be updated. To determine if an update is expected, consult
estimated and look for a
force flag. In this scenario,
estimation contains a non-nil value, which you can correlate with the original touch when the update occurs. When there are no expected force updates, the entire touch sequence usually won't have updates, so it may be appropriate to apply a custom, tool-specific force curve to the touch sequence.