audioaccessorykit

Register paired iOS accessories for automatic audio switching with placement-aware routing.

Updated May 10, 2026
One-click install
npx skills add https://github.com/FelixRauch/medat-figuren --skill audioaccessorykit-felixrauch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audioaccessorykit
Source: https://github.com/FelixRauch/medat-figuren/tree/main/.agents/skills/audioaccessorykit
Command: npx skills add https://github.com/FelixRauch/medat-figuren --skill audioaccessorykit-felixrauch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

AudioAccessoryKit solves the problem of getting the right audio output device when users connect and wear iOS-supported audio accessories, without manual switching.

Core Features & Use Cases

  • Accessory registration for audio routing: Register paired accessories and declare capabilities so the system can route audio output intelligently.
  • Automatic audio switching with placement awareness: Enable audio switching and optionally report accessory placement (in-ear/on-head/over-the-ear/off-head) for more accurate routing.
  • Multi-device source coordination: Provide connected audio source identifiers (e.g., Bluetooth device addresses) so routing can follow the active source.
  • Robust update lifecycle: Retrieve current accessory configuration, update configuration changes asynchronously, and handle capability-related errors safely.

Quick Start

Register a paired accessory with AudioAccessoryKit by declaring the audioSwitching capability (and add placement capability if you will update devicePlacement as the accessory is worn or removed).

Frequently Asked Questions about audioaccessorykit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I route audio to paired iOS accessories automatically in SwiftUI?

To route audio automatically, register the paired accessory with AudioAccessoryKit by declaring the audioSwitching capability, allowing the system to intelligently direct audio output without manual user switching.

What is accessory placement tracking for automatic audio switching?

Accessory placement tracking reports whether a device is in-ear, on-head, over-the-ear, or off-head, enabling the system to perform more accurate and context-aware automatic audio routing for connected accessories.

Do I need to use AccessorySetupKit before enabling automatic audio switching?

Yes, a prior pairing flow via AccessorySetupKit is required. You must also use iOS 26.4+ and Swift 6.3, with declared capability matching to register and update accessory configuration.

How do I coordinate multiple Bluetooth audio sources for routing on iOS?

You coordinate multi-device audio sources by providing connected audio source identifiers, such as Bluetooth device addresses, so the system can follow the active source during automatic audio switching.

How do I handle errors when updating accessory configuration asynchronously?

Handle capability-related errors safely by using async error-handled calls to retrieve current accessory configuration and update it asynchronously, ensuring a robust update lifecycle for connected devices.