CHHapticPattern
An object representing a haptic waveform.
Declaration
class CHHapticPatternMentioned in
Overview
A haptic pattern represents the waveform of a haptic through a hierarchical set of key-value pairs, starting at the topmost level with a CHHapticPattern.Key. This key marks the beginning of an array of events and parameterID definitions. Each event has an associated time that indicates when the system delivers the event to the haptic engine.
[Image]
These key-value pairs represent not only events constituting the pattern, but also individual parameters of each event, which are characteristics of the haptic, such as sharpness and intensity. More complicated patterns also contain key-value pairs for parameter curves, which you can use to modulate parameters over time.
Haptic Patterns
To add haptics to your app, you create an instance of CHHapticEngine, load a pattern, and use the engine to create a player to play that pattern. You create a pattern in one of three ways:
Dictionaries. Each entry in the dictionary defines a single characteristic of the haptic, like its intensity, start time, or duration. See Playing a single-tap haptic pattern to learn more about creating a dictionary inline.
Arrays of events and parameters. The CHHapticEvent class represents a haptic event as an object in code. The key-value pairs in a dictionary correspond to the properties and parameters associated with a CHHapticEvent. Haptic event objects are just another representation of the haptics dictionary.
AHAP files. This JSON-compliant file format specifies a haptic pattern through key-value pairs, analogous to a dictionary literal, except in a text file. Add this file to your Xcode project bundle.
You can produce the same kind of content with all forms of pattern creation.
Haptic Intensity and Sharpness
Regardless of the building block you choose to generate a custom haptic, you can control its intensity and sharpness. Intensity varies the haptic’s amplitude or strength. Sharpness lets you determine the character of the haptic experience. For example, you can use sharpness values to convey an experience that’s crisp, precise, and mechanical, or one that’s soft, rounded, and organic.
Topics
Creating a Haptic Pattern
init(contentsOf:)init(events:parameterCurves:)init(events:parameters:)init(dictionary:)CHHapticPattern.Key