-
Notifications
You must be signed in to change notification settings - Fork 549
AccessorySetupKit iOS xcode26.1 b3
Alex Soto edited this page Oct 20, 2025
·
2 revisions
#AccessorySetupKit.framework
diff -ruN /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessory.h /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessory.h
--- /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessory.h 2025-09-29 01:40:04
+++ /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessory.h 2025-10-11 13:15:24
@@ -91,6 +91,11 @@
// MARK: -
//===========================================================================================================================
+/// A discovered accessory, for use in creating a customized picker display item.
+///
+/// When your app's picker uses the ``ASPickerDisplaySettings/Options/filterDiscoveryResults`` option, you receive ``ASAccessoryEventType/accessoryDiscovered`` events that contain this type.
+/// Use the discovered accessory's Bluetooth properties to create a new ``ASDiscoveredDisplayItem``, incorporating traits like a custom accessory name or a newly downloaded product image.
+/// You can then add this item to the picker to allow the person using the app to set up the accessory.
AS_EXTERN
API_AVAILABLE( ios( 26.1 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos)
NS_SWIFT_SENDABLE
@@ -101,7 +106,7 @@
/// The Bluetooth RSSI (Received Signal Strength Indicator) value from the discovered accessory.
///
-/// This value represents the signal strength in dBm when the accessory was discovered.
+/// This value represents the signal strength in dBm when the session discovered the accessory.
@property (readonly, copy, nullable, nonatomic) NSNumber *bluetoothRSSI NS_REFINED_FOR_SWIFT;
@end
diff -ruN /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessoryEvent.h /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessoryEvent.h
--- /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessoryEvent.h 2025-09-29 01:38:56
+++ /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessoryEvent.h 2025-10-11 09:38:01
@@ -40,6 +40,8 @@
/// The properties of an accessory changed.
ASAccessoryEventTypeAccessoryChanged = 32, // [ASAccessoryEvent] Accessory properties changed.
/// The session discovered an accessory.
+ ///
+ /// Your app only receives this event if your picker uses the ``ASPickerDisplaySettings/Options/filterDiscoveryResults`` option.
ASAccessoryEventTypeAccessoryDiscovered = 33, // [ASAccessoryEvent] Accessory discovered.
/// The discovery session picker appeared.
ASAccessoryEventTypePickerDidPresent = 40, // [ASAccessoryEvent] Picker did present.
diff -ruN /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessorySession.h /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessorySession.h
--- /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessorySession.h 2025-09-29 01:48:20
+++ /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessorySession.h 2025-10-11 09:38:01
@@ -127,10 +127,11 @@
/// Updates the picker with app-filtered accessories.
///
-/// Call this method to update the picker to show app-filtered accessories with updated assets.
+/// You use this method when your picker uses the ``ASPickerDisplaySettings/Options/filterDiscoveryResults`` option to enable manual filtering of discovered accessories.
+/// After creating customized ``ASDiscoveredDisplayItem`` instances for included accessories, call this method to update the picker to show your app-filtered accessories with updated assets.
///
/// - Parameters:
-/// - accessories: the app-filtered accessories to show in the picker.
+/// - displayItems: The app-filtered accessories to show in the picker.
/// - completionHandler: A block or closure that executes after the updatePicker operation completes. The completion handler receives an <doc://com.apple.documentation/documentation/Foundation/NSError> instance if the operation encounters an error.
- (void) updatePickerShowingDiscoveredDisplayItems:(NSArray<ASDiscoveredDisplayItem *> *)displayItems
@@ -140,7 +141,10 @@
/// Finish the discovery session in the picker and show a timeout error.
///
-/// Call this method to finish the discovery session in the picker and show a timeout error if no desired accessories were found. Calling this method after picker has been updated with discovered accessories has no effect.
+/// Use this method if you previously set the picker display setting ``ASPickerDisplaySettings/discoveryTimeout`` to ``ASPickerDisplaySettings/DiscoveryTimeout/unbounded`` in order to perform manual filtering of discovered accessories.
+/// Calling this method finishes the discovery session in the picker and shows a timeout error if the session didn't find any desired accessories.
+///
+/// Calling this method after updating the picker with discovered accessories has no effect.
///
/// - Parameters:
/// - completionHandler: A block or closure that executes after this operation completes. The completion handler receives an <doc://com.apple.documentation/documentation/Foundation/NSError> instance if the operation encounters an error.
diff -ruN /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplayItem.h /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplayItem.h
--- /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplayItem.h 2025-09-29 01:40:04
+++ /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplayItem.h 2025-10-11 13:15:24
@@ -90,6 +90,12 @@
//===========================================================================================================================
+/// A picker display item created from customizing a discovered accessory.
+///
+/// Use this type when your app's picker uses the ``ASPickerDisplaySettings/Options/filterDiscoveryResults`` option.
+/// With this option enabled, your discovery session receives ``ASAccessoryEventType/accessoryDiscovered`` events with discovered accessories.
+/// To include a discovered accessory in the picker, create an instance of this class, optionally using the Bluetooth properties of the event's ``ASDiscoveredAccessory`` to provide a more specific name or product image.
+/// Then send the `ASDiscoveredDisplayItem` to the picker with the session's ``ASAccessorySession/updatePicker(showing:completionHandler:)`` method.
AS_EXTERN
API_AVAILABLE( ios( 26.1 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos)
NS_SWIFT_SENDABLE
diff -ruN /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplaySettings.h /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplaySettings.h
--- /Applications/Xcode_26.1.0-beta2.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplaySettings.h 2025-09-29 01:48:20
+++ /Applications/Xcode_26.1.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplaySettings.h 2025-10-11 13:13:13
@@ -18,6 +18,10 @@
typedef NS_OPTIONS( NSUInteger, ASPickerDisplaySettingsOptions )
{
/// An option to pass discovered accessories to the app for more custom filtering, before they're displayed in the picker for selection.
+ ///
+ /// When your picker uses this option, your ``ASAccessorySession-class`` receives events of type ``ASAccessoryEventType/accessoryDiscovered``.
+ /// Handle this event by examining the discovered accessory.
+ /// To include it in the picker, create a new ``ASDiscoveredDisplayItem`` for it and call ``ASAccessorySession/updatePicker(showing:completionHandler:)``.
ASPickerDisplaySettingsOptionFilterDiscoveryResults = ( 1U << 0 )
} NS_SWIFT_NAME(ASPickerDisplaySettings.Options);
@@ -33,6 +37,10 @@
/// A picker discovery timeout value that times out after about five minutes.
AS_EXTERN ASPickerDisplaySettingsDiscoveryTimeout const ASPickerDisplaySettingsDiscoveryTimeoutLong API_AVAILABLE( ios( 26.0 ) );
/// A picker discovery that only times out when the app tells it to.
+///
+/// Use this timeout value if you set the picker display option ``ASPickerDisplaySettings/Options/filterDiscoveryResults`` and need unlimited time for filtering.
+/// After performing manual discovery, perform the manual timeout by calling the ``ASAccessorySession`` method ``ASAccessorySession/finishPickerDiscovery(completionHandler:)``.
+/// This process shows a timeout message if your filtering added no accessories to the picker, or returns silently if you updated the picker.
AS_EXTERN ASPickerDisplaySettingsDiscoveryTimeout const ASPickerDisplaySettingsDiscoveryTimeoutUnbounded API_AVAILABLE( ios( 26.1 ) );
/// A type that contains settings to customize the display of the accessory picker