Core Equalizer Overview

Equalizer Overview

Use the device-provided equalizer settings to show available audio profiles and apply a selected setting. Equalizer support is optional, so first check that the connected device conforms to DeviceEqualizerAPI.

What You Can Do

• Read the settings currently available on the device through allEQSettings.
• Read the active setting through eqSetting.
• Apply an EQSettingModel using setEqualizer.

Important Behavior

The settings returned by allEQSettings are the authoritative list for the connected device. Show that list to the user and pass the selected model back to the SDK when possible.

For custom EQ, use a custom slot returned in allEQSettings and preserve that setting's band count. customSetting maps its zero-based slot to the public customModeStart, validates the transport gain range defined by minimumGain...maximumGain, and returns nil for invalid input. defaultBandCount applies to built-in presets; a connected device may report a different custom band count.

Available Guides

Browse the generated Wiki navigation for the pages in this section.