Hit

Hit

A hit object is a musical event that can be added by a user and is either Metered or Unmetered: A metered hit occurs on a beat. It must be placed in a metered span. An unmetered hit occurs at an absolute time and can exist during either a metered or unmetered span.

The only difference between the two types of hits is whether the object has a time or beat attribute.

Data Item Type Required/ Optional Description
hit text required The name of the hit. See below for valid values
beat number required The beat, relative to the span, at which the metered hit occurs
time number required The second at which the unmetered hit occurs

Example Metered Hit:

{
    "hit": "cymbal_swell_2s",
    "beat": 42
}

Example Unmetered Hit:

{
    "hit": "cymbal_swell_2s",
    "time": 13.37
}