Setting up and authorizing a Bluetooth accessory
Discover, select, and set up a specific Bluetooth accessory without requesting permission to use Bluetooth.
Overview
This sample project uses two app targets to demonstrate how to use AccessorySetupKit. ASKSampleAccessory simulates Bluetooth dice, while ASKSample highlights how to use AccessorySetupKit to onboard the accessory.
The ASKSample target uses AccessorySetupKit to authorize the use of a Bluetooth dice accessory and receive roll results. When you tap the “Add Dice” button, the app searches for dice and presents the set up AccessorySetupKit UI. AccessorySetupKit then authorizes and grants the app access to that accessory. After authorization, you can connect to the accessory and receive roll results until you decide to disconnect or remove authorization altogether.
Configure the sample code project
Because this sample app relies on using Bluetooth to connect with the accessory functionality, you can’t run this sample in Simulator — you’ll need to run it on a device. To run this sample, you’ll need the following:
An Apple Developer profile.
Two devices running iOS 18 or iPadOS 18 or later.
Using the applications
Run the two targets on separate devices.
In
ASKSampleAccessory, tap “Power On”.In
ASKSample, tap “Add Dice” and authorize the accessory using the AccessorySetupKit UI.
The accessory is now authorized for use in the app.