Technologies›Device, Sensors & Hardware

AccessorySetupKit

iOSmacOStvOSwatchOSvisionOS

AccessorySetupKit lets your iOS app discover, authorize, and pair Bluetooth and Wi-Fi accessories through a system-provided UI flow, controlling per-accessory access and state. You drive discovery and pairing with an ASAccessorySession, describe the accessories you support using ASDiscoveryDescriptor and properties such as ASBluetoothCompanyIdentifier, and present them with ASPickerDisplayItem and ASPickerDisplaySettings. Discovered devices arrive as ASDiscoveredAccessory and, once paired, are represented by ASAccessory, while session changes are reported through ASAccessoryEvent and ASAccessoryEventType.

Essentials 2

The session object that drives accessory discovery, authorization, and pairing.

  • Cl
    ASAccessorySessioniOS 18.0+
    Manages accessories.
  • Cl
    ASAccessorySettingsiOS 18.0+
    An object that exposes configuration and state settings for an accessory session.

Accessories 2

Types that represent discovered and paired accessories.

  • Cl
    ASAccessoryiOS 18.0+
    An object that represents an accessory paired and authorized through the setup flow.
  • Cl
    ASDiscoveredAccessoryiOS 26.1+
    A discovered accessory, for use in creating a customized picker display item.

Describing Accessories to Discover 3

Descriptors and identifiers that declare the accessories your app supports.

  • Cl
    ASDiscoveryDescriptoriOS 18.0+
    An object that describes the Bluetooth and Wi-Fi accessories your app can discover.
  • St
    ASBluetoothCompanyIdentifier
    The type used to identify a Bluetooth accessory provider.
  • Cl
    ASPropertyCompareStringiOS 26.0+
    A type that specifies how to filter a property against a given string and comparison options.

Presenting the Picker 4

Display items and settings that configure the system pairing UI.

  • Cl
    ASPickerDisplayItemiOS 18.0+
    An object that describes how an accessory appears in the system pairing picker.
  • Cl
    ASDiscoveredDisplayItemiOS 26.1+
    A picker display item created from customizing a discovered accessory.
  • Cl
    ASMigrationDisplayItemiOS 18.0+
    An object that describes a previously paired accessory to migrate into the setup flow.
  • Cl
    ASPickerDisplaySettingsiOS 26.0+
    A type that contains settings to customize the display of the accessory picker

Responding to Events 2

Types that report changes in session and accessory state.

  • Cl
    ASAccessoryEventiOS 18.0+
    Event for status and other updates.
  • En
    ASAccessoryEventType
    Type of event.

Errors 1

Errors reported by accessory setup operations.

  • St
    ASErroriOS 18.0+
    A structure that describes errors produced by accessory setup operations.
← Device, Sensors & Hardware