Identity characteristics that can match one or more beacons.


class CLBeaconIdentityConstraint : NSObject


A constraint specifies beacon identity characteristics. Use constraints to check for matching beacons by comparing the beacon’s identity characteristics (uuid, major, and minor ) to those in the constraint.

Constraints always specify a UUID value, but the major and minor values are optional. A beacon is said to satisfy the constraint if all three identity characteristics of the beacon match the same characteristic of the constraint. Major and minor characteristics are wildcards if they have no value. A major or minor wildcard value matches any value in the beacon’s corresponding characteristic.


Initializing a Beacon Identity Constraint

init(uuid: UUID)

Create a beacon identity constraint containing the UUID characteristic only, with wildcard values for the major and minor characteristics.

init(uuid: UUID, major: CLBeaconMajorValue)

Create a beacon identity constraint containing the UUID and major characteristics, with a wildcard for the minor characteristic.

init(uuid: UUID, major: CLBeaconMajorValue, minor: CLBeaconMinorValue)

Create a beacon identity constraint containing the UUID, major, and minor characteristics.

Getting Constraint Characteristics

var uuid: UUID

The UUID necessary to satisfy the constraint.

var major: UInt16?

The constraint's value for the major identity characteristic.

var minor: UInt16?

The constraint's value for the minor identity characteristic.


Inherits From

See Also


Ranging for Beacons

Configure a device to act as a beacon and to detect surrounding beacons.

Determining the Proximity to an iBeacon Device

Detect beacons and determine the relative distance to them.

Turning an iOS Device into an iBeacon Device

Broadcast iBeacon signals from an iOS device.

class CLBeacon

Information about an observed iBeacon device and its relative distance to the user’s device.

class CLBeaconRegion

A region used to detect the presence of iBeacon devices.