---
title: AVExtendedNoteOnEvent
framework: avfaudio
role: symbol
role_heading: Class
path: avfaudio/avextendednoteonevent
---

# AVExtendedNoteOnEvent

An object that represents a custom extension of a MIDI note on event.

## Declaration

```swift
class AVExtendedNoteOnEvent
```

## Overview

Overview Use this to allow an app to trigger a custom note on event on one of several Apple audio units that support it. The floating point note and velocity numbers allow for optional fractional control of the note’s runtime properties that the system modulates by those inputs. This event supports the possibility of an audio unit with more than the standard 16 MIDI channels.

## Topics

### Creating a Note On Event

- [init(midiNote:velocity:groupID:duration:)](avfaudio/avextendednoteonevent/init(midinote:velocity:groupid:duration:)-60hve.md)
- [init(midiNote:velocity:instrumentID:groupID:duration:)](avfaudio/avextendednoteonevent/init(midinote:velocity:instrumentid:groupid:duration:)-rqr5.md)

### Configuring a Note On Event

- [midiNote](avfaudio/avextendednoteonevent/midinote.md)
- [velocity](avfaudio/avextendednoteonevent/velocity.md)
- [instrumentID](avfaudio/avextendednoteonevent/instrumentid.md)
- [groupID](avfaudio/avextendednoteonevent/groupid.md)
- [duration](avfaudio/avextendednoteonevent/duration.md)

### Getting the Default Instrument

- [defaultInstrument](avfaudio/avextendednoteonevent/defaultinstrument.md)

### Initializers

- [init(MIDINote:velocity:groupID:duration:)](avfaudio/avextendednoteonevent/init(midinote:velocity:groupid:duration:)-985j8.md)
- [init(MIDINote:velocity:instrumentID:groupID:duration:)](avfaudio/avextendednoteonevent/init(midinote:velocity:instrumentid:groupid:duration:)-3a40r.md)

## Relationships

### Inherits From

- [AVMusicEvent](avfaudio/avmusicevent.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Handling Music Events

- [AVMusicEvent](avfaudio/avmusicevent.md)
- [AVMusicUserEvent](avfaudio/avmusicuserevent.md)
- [AVParameterEvent](avfaudio/avparameterevent.md)
- [AVAUPresetEvent](avfaudio/avaupresetevent.md)
- [AVExtendedTempoEvent](avfaudio/avextendedtempoevent.md)