A value that you send to a haptic pattern player to alter a property value during playback.


@interface CHHapticDynamicParameter : NSObject


Dynamic parameters change their associated event parameters at specific times. When you send a dynamic parameter to a haptic pattern player, the value associated with the parameter changes abruptly at the specified time, across all events in the pattern. To precipitate a gradual change, use a CHHapticParameterCurve object.

For haptic intensity and audio volume, the final property value is equal to the original event parameter value multiplied by the dynamic parameter value. For all other parameters, the final property value is equal to the dynamic parameter value added to the original event parameter value. In both cases, the resulting value is limited to the range with minimum and maximum values corresponding to the specified event parameter.


Creating a Dynamic Parameter

- initWithParameterID:value:relativeTime:

Creates a dynamic parameter from its ID, value, and start time.


The identifier that reveals the type of property associated with a dynamic parameter.

Specifying a Dynamic Parameter's Value


The dynamic parameter ID defining the type of parameter being modified.


The time at which this dynamic parameter is applied, relative to the start time of the pattern.


The value of the dynamic parameter.


Inherits From

See Also

Programmatic Haptics

Playing Collision-Based Haptic Patterns

Play a custom haptic pattern whose strength depends on an object’s collision speed.

Updating Continuous and Transient Haptic Parameters in Real Time

Generate continuous and transient haptic patterns in response to user touch.


An object that describes a single haptic or audio event.


A static parameter value that represents a single property of the haptic pattern.


A curve that you send to a haptic pattern player to alter a property value gradually during playback.