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


class 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

init(parameterID: CHHapticDynamicParameter.ID, value: Float, relativeTime: TimeInterval)

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

struct CHHapticDynamicParameter.ID

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

Specifying a Dynamic Parameter's Value

var parameterID: CHHapticDynamicParameter.ID

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

var relativeTime: TimeInterval

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

var value: Float

The value of the dynamic parameter.


Inherits From

Conforms To

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.

class CHHapticEvent

An object that describes a single haptic or audio event.

class CHHapticEventParameter

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

class CHHapticParameterCurve

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