🔗 AccessorySetupKit 2

⭐ Difficulty: ⭐⭐⭐ ⏱️ Est. Time: 2h 📂 iOS 26

Bluetooth & Wi-Fi Accessory Easy Pairing

iOS 18+🆕 2024

✨ What is AccessorySetupKit 2?

AccessorySetupKit 2 is a greatly improved accessory setup framework in iOS 18 that lets you connect Bluetooth and Wi-Fi devices easily without complex configuration. QR code scanning, Matter protocol support, and HomeKit integration have been enhanced.

💡 Key Features: Easy Pairing · QR Code Authentication · Matter Support · Wi-Fi Provisioning · HomeKit Integration · Secure Connection · Auto Reconnect

🎯 1. Basic Setup

Create an AccessorySetupKit session and discover accessories.

AccessoryManager.swift — Basic Setup

import AccessorySetupKit
import SwiftUI

@Observable
class AccessorySetupManager {
    var discoveredAccessories: [ASKAccessory] = []
    var connectedAccessory: ASKAccessory?
    private var session: ASKSession?

    // 세션 시작
    func startSession() async {
        // 🆕 iOS 18+ 새로운 세션 생성 방식
        let configuration = ASKSessionConfiguration()
        configuration.supportedProtocols = [.bluetooth, .wifi]
        configuration.enableBackgroundRefresh = true

        session = ASKSession(configuration: configuration)

        // 액세서리 검색 시작
        do {
            for try await accessory in session!.discoverAccessories() {
                discoveredAccessories.append(accessory)
            }
        } catch {
            print("검색 실패: \(error)")
        }
    }

    // 액세서리 페어링
    func pair(accessory: ASKAccessory) async throws {
        guard let session else { return }

        // 시스템 페어링 UI 표시
        try await session.pair(accessory)
        connectedAccessory = accessory
    }

    // 연결 해제
    func disconnect() async {
        guard let accessory = connectedAccessory,
              let session else { return }

        await session.disconnect(accessory)
        connectedAccessory = nil
    }

    // 세션 종료
    func endSession() {
        session?.invalidate()
        session = nil
        discoveredAccessories.removeAll()
    }
}

📱 2. QR Code Pairing

Scan QR codes to quickly connect accessories.

QRPairing.swift — QR Code Pairing

import AccessorySetupKit
import AVFoundation

@Observable
class QRPairingManager: NSObject {
    var scannedAccessory: ASKAccessory?
    private var session: ASKSession?

    // QR 코드 스캔 및 페어링
    func scanAndPair() async throws {
        let configuration = ASKSessionConfiguration()
        configuration.pairingMethod = .qrCode // 🆕 QR 코드 모드

        session = ASKSession(configuration: configuration)

        // 시스템 QR 스캐너 표시
        if let accessory = try await session?.scanQRCode() {
            scannedAccessory = accessory
            try await session?.pair(accessory)
        }
    }

    // Matter 디바이스 QR 코드 페어링
    func pairMatterDevice(qrCode: String) async throws {
        let configuration = ASKSessionConfiguration()
        configuration.supportedProtocols = [.matter] // 🆕 Matter 지원

        session = ASKSession(configuration: configuration)

        // QR 코드에서 디바이스 정보 파싱
        let accessory = try await session?.parseQRCode(qrCode)
        try await session?.pair(accessory!)
    }
}

📡 3. Wi-Fi Provisioning

Deliver Wi-Fi credentials to accessories for network connection.

WiFiProvisioning.swift — Wi-Fi Setup

import AccessorySetupKit
import NetworkExtension

@Observable
class WiFiProvisioningManager {
    private var session: ASKSession?
    var provisioningStatus: String = ""

    // Wi-Fi 프로비저닝 시작
    func provisionWiFi(
        accessory: ASKAccessory,
        ssid: String,
        password: String
    ) async throws {
        let configuration = ASKSessionConfiguration()
        configuration.supportedProtocols = [.wifi]

        session = ASKSession(configuration: configuration)

        // 🆕 Wi-Fi 자격 증명 전달
        let credentials = ASKWiFiCredentials(
            ssid: ssid,
            password: password,
            securityType: .wpa2
        )

        provisioningStatus = "연결 중..."

        try await session?.provisionWiFi(
            for: accessory,
            credentials: credentials
        )

        provisioningStatus = "연결 완료"
    }

    // 현재 네트워크 정보 자동 전달
    func provisionCurrentNetwork(accessory: ASKAccessory) async throws {
        let configuration = ASKSessionConfiguration()
        configuration.supportedProtocols = [.wifi]
        configuration.autoProvisionCurrentNetwork = true // 🆕 자동 설정

        session = ASKSession(configuration: configuration)

        // 시스템이 자동으로 현재 Wi-Fi 정보 전달
        try await session?.pair(accessory)
    }

    // Wi-Fi 설정 상태 모니터링
    func monitorProvisioningStatus(
        accessory: ASKAccessory
    ) async {
        guard let session else { return }

        for await status in session.provisioningStatusUpdates(for: accessory) {
            switch status {
            case .connecting:
                provisioningStatus = "네트워크 연결 중"
            case .connected:
                provisioningStatus = "연결 완료"
            case .failed(let error):
                provisioningStatus = "연결 실패: \(error.localizedDescription)"
            }
        }
    }
}

🏠 4. HomeKit Integration

Set up smart home accessories with HomeKit integration.

HomeKitIntegration.swift — HomeKit Integration

import AccessorySetupKit
import HomeKit

@Observable
class HomeKitAccessoryManager: NSObject, HMHomeManagerDelegate {
    private let homeManager = HMHomeManager()
    private var session: ASKSession?
    var homes: [HMHome] = []

    override init() {
        super.init()
        homeManager.delegate = self
    }

    // HomeKit 액세서리 추가
    func addHomeKitAccessory(
        to home: HMHome,
        accessory: ASKAccessory
    ) async throws {
        let configuration = ASKSessionConfiguration()
        configuration.supportedProtocols = [.homeKit, .matter] // 🆕 HomeKit + Matter
        configuration.homeKitHome = home

        session = ASKSession(configuration: configuration)

        // 페어링 및 HomeKit 추가
        try await session?.pair(accessory)

        // HomeKit 설정 자동 완료
        try await session?.configureHomeKit(for: accessory, in: home)
    }

    // Matter 디바이스를 HomeKit에 추가
    func addMatterDevice(
        qrCode: String,
        to home: HMHome
    ) async throws {
        let configuration = ASKSessionConfiguration()
        configuration.supportedProtocols = [.matter]
        configuration.homeKitHome = home
        configuration.pairingMethod = .qrCode

        session = ASKSession(configuration: configuration)

        // QR 코드로 Matter 디바이스 페어링
        if let accessory = try await session?.parseQRCode(qrCode) {
            try await session?.pair(accessory)
            try await session?.configureHomeKit(for: accessory, in: home)
        }
    }

    // HomeManager 델리게이트
    func homeManagerDidUpdateHomes(_ manager: HMHomeManager) {
        homes = manager.homes
    }
}

🔐 5. Secure Pairing

Implement secure pairing and permission management.

SecurePairing.swift — Secure Pairing

import AccessorySetupKit
import CryptoKit

@Observable
class SecurePairingManager {
    private var session: ASKSession?
    var authenticationStatus: String = ""

    // 인증 코드 기반 페어링
    func pairWithAuthCode(
        accessory: ASKAccessory,
        code: String
    ) async throws {
        let configuration = ASKSessionConfiguration()
        configuration.requiresAuthentication = true // 🆕 인증 필수

        session = ASKSession(configuration: configuration)

        // 인증 코드 검증
        let isValid = try await session?.validateAuthCode(code, for: accessory)

        if isValid == true {
            authenticationStatus = "인증 성공"
            try await session?.pair(accessory)
        } else {
            authenticationStatus = "인증 실패"
            throw PairingError.authenticationFailed
        }
    }

    // PIN 기반 페어링
    func pairWithPIN(
        accessory: ASKAccessory,
        pin: String
    ) async throws {
        let configuration = ASKSessionConfiguration()
        configuration.pairingMethod = .pin // 🆕 PIN 모드

        session = ASKSession(configuration: configuration)

        // PIN 제공 및 페어링
        try await session?.pair(accessory, pin: pin)
    }

    // 암호화된 연결 확인
    func verifyEncryptedConnection(accessory: ASKAccessory) async -> Bool {
        guard let session else { return false }

        // 연결 보안 상태 확인
        let securityLevel = await session.securityLevel(for: accessory)
        return securityLevel == .encrypted
    }
}

enum PairingError: Error {
    case authenticationFailed
    case invalidPIN
    case connectionLost
}

📱 SwiftUI Integration

AccessorySetupView.swift — Complete Example

import SwiftUI
import AccessorySetupKit

struct AccessorySetupView: View {
    @State private var manager = AccessorySetupManager()
    @State private var qrManager = QRPairingManager()
    @State private var wifiManager = WiFiProvisioningManager()
    @State private var showQRScanner = false

    var body: some View {
        NavigationStack {
            List {
                Section("검색된 액세서리") {
                    if manager.discoveredAccessories.isEmpty {
                        ContentUnavailableView(
                            "액세서리 없음",
                            systemImage: "antenna.radiowaves.left.and.right.slash",
                            description: Text("검색을 시작하세요")
                        )
                    } else {
                        ForEach(manager.discoveredAccessories, id: \.self.identifier) { accessory in
                            HStack {
                                VStack(alignment: .leading) {
                                    Text(accessory.name)
                                        .font(.headline)
                                    Text(accessory.category.rawValue)
                                        .font(.caption)
                                        .foregroundStyle(.secondary)
                                }

                                Spacer()

                                Button("연결") {
                                    Task {
                                        try? await manager.pair(accessory: accessory)
                                    }
                                }
                                .buttonStyle(.bordered)
                            }
                        }
                    }
                }

                if let connected = manager.connectedAccessory {
                    Section("연결된 액세서리") {
                        HStack {
                            Image(systemName: "checkmark.circle.fill")
                                .foregroundStyle(.green)
                            Text(connected.name)
                            Spacer()
                            Button("연결 해제") {
                                Task {
                                    await manager.disconnect()
                                }
                            }
                        }
                    }
                }

                Section("설정 방법") {
                    Button {
                        Task {
                            await manager.startSession()
                        }
                    } label: {
                        Label("Bluetooth 검색", systemImage: "dot.radiowaves.left.and.right")
                    }

                    Button {
                        showQRScanner = true
                    } label: {
                        Label("QR 코드 스캔", systemImage: "qrcode.viewfinder")
                    }
                }

                if !wifiManager.provisioningStatus.isEmpty {
                    Section("Wi-Fi 상태") {
                        Text(wifiManager.provisioningStatus)
                            .foregroundStyle(.secondary)
                    }
                }
            }
            .navigationTitle("액세서리 설정")
            .sheet(isPresented: $showQRScanner) {
                QRScannerView { qrCode in
                    Task {
                        try? await qrManager.pairMatterDevice(qrCode: qrCode)
                        showQRScanner = false
                    }
                }
            }
        }
    }
}

struct QRScannerView: View {
    let onScan: (String) -> Void
    @Environment(\.dismiss) var dismiss

    var body: some View {
        VStack {
            Text("액세서리의 QR 코드를 스캔하세요")
                .font(.headline)
                .padding()

            // QR 스캐너 구현
            Rectangle()
                .fill(Color.gray.opacity(0.3))
                .frame(width: 300, height: 300)
                .overlay {
                    Image(systemName: "qrcode.viewfinder")
                        .font(.system(size: 100))
                        .foregroundStyle(.white)
                }

            Button("취소") {
                dismiss()
            }
            .padding()
        }
    }
}

💡 HIG Guidelines

User Experience: Keep the pairing process as simple as possible
피드백: Show clear status at each step
보안: Handle sensitive info (Wi-Fi passwords, etc.) securely
Error Handling: Provide clear resolution when connection fails
권한: Add Bluetooth and network permission descriptions

🎯 Practical Applications

Smart Home: Easy HomeKit accessory setup
Wearables: Fitness tracker and smartwatch pairing
IoT Devices: Matter-based smart devices
Audio: Bluetooth headphone/speaker connection
Healthcare: Secure medical device pairing

📚 Learn More

⚡️ Performance Tips: During Wi-Fi provisioning, autoProvisionCurrentNetwork to automatically forward current network info without requiring the user to enter a password.

📎 Apple Official Resources

📘 Documentation 💻 Sample Code 🎬 WWDC Sessions