Repository navigation
ARKit macOS xcode27.3 b1
Alex Soto edited this page Nov 4, 2026
·
1 revision
#ARKit.framework
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/accessory_tracking.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/accessory_tracking.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/accessory_tracking.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/accessory_tracking.h 2026-11-04 09:32:06
@@ -413,7 +413,7 @@
typedef bool (*ar_accessories_enumerator_function_t)(void *_Nullable context, ar_accessory_t accessory) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of reference objects.
+ Enumerates a collection of accessories using a function.
- Parameters:
- accessories: The collection of accessories.
@@ -640,7 +640,7 @@
ar_accessory_anchor_t accessory_anchor) AR_MT_UNSAFE AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of acessory anchors.
+ Enumerates a collection of accessory anchors using a function.
- Parameters:
- accessory_anchors: A collection of accessory anchors.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/anchor.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/anchor.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/anchor.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/anchor.h 2026-11-04 09:32:06
@@ -23,14 +23,14 @@
#pragma mark - Anchor
/**
- Represents the identity, location, and orientation of an object in world space.
+ The identity, location, and orientation of an object in world space.
*/
AR_OBJECT_DECL(ar_anchor)
AR_REFINED_FOR_SWIFT
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0));
/**
- Get the transform from an anchor to the origin coordinate system.
+ Gets the transform from the anchor to the origin coordinate system.
- Parameter anchor: The anchor.
@@ -41,7 +41,7 @@
AR_EXTERN simd_float4x4 ar_anchor_get_origin_from_anchor_transform(ar_anchor_t anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the identifier of an anchor.
+ Gets the unique identifier that distinguishes this anchor from all other anchors.
- Parameters:
- anchor: The anchor.
@@ -52,7 +52,7 @@
AR_EXTERN void ar_anchor_get_identifier(ar_anchor_t anchor, uuid_t _Nonnull out_identifier) AR_REFINED_FOR_SWIFT;
/**
- Get the timestamp corresponding to an anchor.
+ Gets the timestamp corresponding to the anchor.
- Parameter anchor: The anchor.
@@ -65,14 +65,14 @@
#pragma mark - Trackable Anchor
/**
- An anchor that can be tracked over time.
+ An anchor that can gain and lose its tracking state over the course of a session.
*/
AR_OBJECT_DECL_SUBCLASS(ar_trackable_anchor, ar_anchor)
AR_REFINED_FOR_SWIFT
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0));
/**
- Determine whether an anchor is tracked.
+ Returns a Boolean value that indicates whether ARKit is tracking an anchor.
- Parameter anchor: The anchor.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/authorization.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/authorization.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/authorization.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/authorization.h 2026-11-04 09:32:06
@@ -16,26 +16,27 @@
#pragma mark - Authorization Result
/**
- Status of an authorization for ARKit data.
+ The authorization states for a type of ARKit data.
*/
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0))
OS_ENUM(ar_authorization_status, intptr_t,
- // The user has not yet granted permission.
+ /** Permission for your app to use the associated kind of ARKit data is undetermined. */
ar_authorization_status_not_determined,
- // The user has explicitly granted permission.
+ /** Your app has permission to use the associated kind of ARKit data. */
ar_authorization_status_allowed,
- // The user has explicitly denied permission.
+ /** Your app doesn't have permission to use the associated kind of ARKit data. */
ar_authorization_status_denied)
AR_REFINED_FOR_SWIFT;
/**
- Types of authorization for ARKit data.
+ The authorization types you can request from ARKit.
*/
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0))
OS_OPTIONS(ar_authorization_type, uintptr_t,
+ /** There isn't an authorization type. */
ar_authorization_type_none = 0,
/**
- Authorization type used when requesting hand tracking.
+ The authorization for access to detailed hand-tracking data.
@see `ar_hand_tracking_provider_t`
*/
ar_authorization_type_hand_tracking = (1 << 0),
@@ -70,7 +71,7 @@
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0));
/**
- Get the authorization type associated with an authorization result.
+ Gets the authorization type associated with an authorization result.
- Parameter authorization_result: The authorization result.
@@ -80,7 +81,7 @@
AR_EXTERN ar_authorization_type_t ar_authorization_result_get_authorization_type(ar_authorization_result_t authorization_result) AR_REFINED_FOR_SWIFT;
/**
- Get the authorization status associated with an authorization result.
+ Gets the authorization status associated with an authorization result.
- Parameter authorization_result: The authorization result.
@@ -99,7 +100,7 @@
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0));
/**
- Get the count of authorization results in a collection.
+ Gets the number of authorization results in a collection.
- Parameter authorization_results: The collection of authorization results.
@@ -110,7 +111,7 @@
#ifdef __BLOCKS__
/**
- Handler for enumerating a collection of authorization results.
+ A handler for enumerating a collection of authorization results.
- Parameter authorization_result: The authorization result.
@@ -120,7 +121,7 @@
typedef bool (^ar_authorization_results_enumerator_t)(ar_authorization_result_t authorization_result) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of authorization results.
+ Enumerates a collection of authorization results.
- Parameters:
- authorization_results: The collection of authorization results.
@@ -146,7 +147,7 @@
ar_authorization_result_t authorization_result) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of authorization results using a function.
+ Enumerates a collection of authorization results using a function.
- Parameters:
- authorization_results: The collection of authorization results.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/barcode_detection.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/barcode_detection.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/barcode_detection.h 2026-10-04 03:50:41
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/barcode_detection.h 2026-11-04 09:32:06
@@ -288,7 +288,7 @@
typedef bool (*ar_barcode_anchors_enumerator_function_t)(void *_Nullable context, ar_barcode_anchor_t barcode_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of barcode anchors using a function.
+ Enumerates a collection of barcode anchors using a function.
- Parameters:
- barcode_anchors: The collection of barcode anchors.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/camera_frame_provider.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/camera_frame_provider.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/camera_frame_provider.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/camera_frame_provider.h 2026-11-04 09:32:06
@@ -265,7 +265,7 @@
ar_camera_video_format_t camera_video_format) AR_REFINED_FOR_SWIFT;
/**
- Enumerate all supported camera video formats for this configuration using a function.
+ Enumerates all supported camera video formats for this configuration using a function.
- Parameters:
- camera_video_formats: The camera video formats collection.
@@ -366,7 +366,7 @@
ar_camera_frame_sample_t camera_frame_sample) AR_REFINED_FOR_SWIFT;
/**
- Enumerate all supported camera frame samples for this configuration using a function.
+ Enumerates all supported camera frame samples for this configuration using a function.
- Parameters:
- camera_frame_samples: The collection of frame samples.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/camera_region.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/camera_region.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/camera_region.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/camera_region.h 2026-11-04 09:32:06
@@ -253,7 +253,7 @@
ar_camera_region_anchor_t camera_region_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of camera region anchors using a function.
+ Enumerates a collection of camera region anchors using a function.
- Parameters:
- camera_region_anchors: The collection of camera region anchors.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/data_provider.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/data_provider.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/data_provider.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/data_provider.h 2026-11-04 09:32:06
@@ -19,7 +19,7 @@
#pragma mark - Data Provider
/**
- Base type for all ARKit data providers.
+ A source of live data from ARKit.
*/
AR_OBJECT_DECL(ar_data_provider)
AR_REFINED_FOR_SWIFT
@@ -33,18 +33,22 @@
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0));
/**
- State of a data provider.
+ The possible states of a data provider.
*/
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0))
OS_ENUM(ar_data_provider_state, intptr_t,
+ /** The data provider has been created. */
ar_data_provider_state_initialized,
+ /** The data provider is running. */
ar_data_provider_state_running,
+ /** The data provider is paused. */
ar_data_provider_state_paused,
+ /** The data provider is stopped. */
ar_data_provider_state_stopped
) AR_REFINED_FOR_SWIFT;
/**
- Get the state of a data provider.
+ Gets the current status of data coming from a data provider.
- Parameter data_provider: The data provider.
@@ -55,7 +59,7 @@
AR_EXTERN ar_data_provider_state_t ar_data_provider_get_state(ar_data_provider_t data_provider) AR_REFINED_FOR_SWIFT;
/**
- Get the authorization type required by a data provider.
+ The kinds of authorization you need to use a particular data provider type.
- Parameter data_provider: The data provider.
@@ -67,7 +71,7 @@
#pragma mark - Data Providers Collection
/**
- Create an empty collection of data providers.
+ Creates an empty collection of data providers.
- Note: This type supports ARC. In non-ARC files, use `ar_retain()` and `ar_release()` to retain and release the object.
@@ -77,7 +81,7 @@
AR_EXTERN AR_OBJECT_RETURNS_RETAINED ar_data_providers_t ar_data_providers_create(void) AR_REFINED_FOR_SWIFT;
/**
- Create a collection of data providers populated with given data providers.
+ Creates a collection of data providers that contains the data providers you supply.
- Parameter data_provider: The `nil`-terminated list of data providers to add to a newly created collection.
@@ -90,7 +94,7 @@
NS_REQUIRES_NIL_TERMINATION AR_REFINED_FOR_SWIFT;
/**
- Add a data provider to a collection.
+ Adds a data provider to a collection.
- Parameters:
- data_providers: The collection to expand.
@@ -100,7 +104,7 @@
AR_EXTERN void ar_data_providers_add_data_provider(ar_data_providers_t data_providers, ar_data_provider_t data_provider_to_add) AR_REFINED_FOR_SWIFT;
/**
- Add data providers to a collection.
+ Adds multiple data providers to a collection.
- Parameters:
- data_providers: The collection to expand.
@@ -111,7 +115,7 @@
ar_data_providers_t data_providers_to_add) AR_REFINED_FOR_SWIFT;
/**
- Remove a data provider from a collection.
+ Removes a data provider from a collection.
- Parameters:
- data_providers: The collection from which to remove.
@@ -122,7 +126,7 @@
ar_data_provider_t data_provider_to_remove) AR_REFINED_FOR_SWIFT;
/**
- Remove data providers from a collection.
+ Removes multiple data providers from a collection.
- Parameters:
- data_providers: The collection from which to remove.
@@ -133,7 +137,7 @@
ar_data_providers_t data_providers_to_remove) AR_REFINED_FOR_SWIFT;
/**
- Get the count of data providers in a collection.
+ Gets the number of data providers in a collection.
- Parameter data_providers: The collection of data providers.
@@ -144,7 +148,7 @@
#ifdef __BLOCKS__
/**
- Handler for enumerating a collection of data providers.
+ A handler for enumerating a collection of data providers.
- Parameter data_provider: The data provider.
@@ -154,7 +158,7 @@
typedef bool (^ar_data_providers_enumerator_t)(ar_data_provider_t data_provider) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of data providers.
+ Enumerates a collection of data providers.
- Parameters:
- data_providers: The collection of data providers.
@@ -178,7 +182,7 @@
typedef bool (*ar_data_providers_enumerator_function_t)(void *_Nullable context, ar_data_provider_t data_provider) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of data providers using a function.
+ Enumerates a collection of data providers using a function.
- Parameters:
- data_providers: The collection of data providers.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/environment_light_estimation.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/environment_light_estimation.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/environment_light_estimation.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/environment_light_estimation.h 2026-11-04 09:32:06
@@ -173,7 +173,7 @@
typedef bool (^ar_environment_probe_anchors_enumerator_t)(ar_environment_probe_anchor_t environment_probe_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of environment probe anchors.
+ Enumerates a collection of environment probe anchors.
- Parameters:
- environment_probe_anchors: The collection of environment probe anchors.
@@ -199,7 +199,7 @@
ar_environment_probe_anchor_t environment_probe_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of environment probe anchors.
+ Enumerates a collection of environment probe anchors using a function.
- Parameters:
- environment_probe_anchors: The collection of environment probe anchors.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/error.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/error.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/error.h 2026-10-04 03:50:41
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/error.h 2026-11-04 09:32:06
@@ -20,23 +20,23 @@
#pragma mark - Error
/**
- Represents an error in ARKit.
+ An error reported by ARKit.
*/
AR_OBJECT_DECL(ar_error)
AR_REFINED_FOR_SWIFT
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0));
/**
- The error domain for ARKit errors.
+ A string that indicates the error domain in Core Foundation.
*/
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0)) AR_EXTERN const CFStringRef ar_error_domain AR_REFINED_FOR_SWIFT;
/**
- Error code type for ARKit errors.
+ Codes that identify errors in ARKit.
*/
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0)) typedef intptr_t ar_error_code_t AR_REFINED_FOR_SWIFT;
/**
- Get the error code associated with an error.
+ Gets the error code associated with an error.
- Parameter error: The `ar_error_t` instance.
@@ -46,7 +46,7 @@
AR_EXTERN ar_error_code_t ar_error_get_error_code(ar_error_t error) AR_REFINED_FOR_SWIFT;
/**
- Copy out a `CFErrorRef` that represents an `ar_error_t`.
+ Copies a reference to a Core Foundation error object that represents the specified ARKit error.
- Parameter error: The `ar_error_t` instance.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/hand_skeleton.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/hand_skeleton.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/hand_skeleton.h 2026-10-04 03:50:41
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/hand_skeleton.h 2026-11-04 09:32:06
@@ -130,7 +130,7 @@
#endif // __BLOCKS__
/**
- Enumerate the joints in an `ar_hand_skeleton_t` using a function.
+ Enumerates the joints in an `ar_hand_skeleton_t` using a function.
- Parameters:
- hand_skeleton: The hand skeleton.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/hand_tracking.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/hand_tracking.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/hand_tracking.h 2026-10-04 03:50:41
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/hand_tracking.h 2026-11-04 09:32:06
@@ -23,7 +23,7 @@
AR_ASSUME_NONNULL_BEGIN
/**
- Status enum values for the hand anchor at a specified timestamp from the provider.
+ An enumeration that describes the status of a hand anchor query.
*/
API_AVAILABLE(visionos(2.0))
API_UNAVAILABLE(macos, macCatalyst)
@@ -35,7 +35,7 @@
AR_REFINED_FOR_SWIFT;
/**
- An anchor that tracks a hand's position and skeleton.
+ A hand's position in a person's surroundings.
*/
AR_OBJECT_DECL_SUBCLASS(ar_hand_anchor, ar_trackable_anchor)
AR_REFINED_FOR_SWIFT
@@ -51,7 +51,7 @@
API_UNAVAILABLE(macos, macCatalyst);
/**
- A data provider for hand tracking.
+ A source of live data about the position of a person's hands and hand joints.
*/
AR_OBJECT_DECL_SUBCLASS(ar_hand_tracking_provider, ar_data_provider)
AR_REFINED_FOR_SWIFT
@@ -61,12 +61,14 @@
#pragma mark - Hand Anchor
/**
- Enum for the chirality of a hand.
+ The values identifying hand chirality.
*/
API_AVAILABLE(visionos(1.0))
API_UNAVAILABLE(macos, macCatalyst)
OS_ENUM(ar_hand_chirality, intptr_t,
+ /** A right hand. */
ar_hand_chirality_right,
+ /** A left hand. */
ar_hand_chirality_left
) AR_REFINED_FOR_SWIFT;
@@ -81,7 +83,7 @@
) AR_REFINED_FOR_SWIFT;
/**
- Create a hand anchor.
+ Creates a hand anchor.
- Note: This type supports ARC. In non-ARC files, use `ar_retain()` and `ar_release()` to retain and release the object.
@@ -117,7 +119,7 @@
AR_EXTERN ar_hand_skeleton_t _Nullable ar_hand_anchor_get_hand_skeleton(ar_hand_anchor_t hand_anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the chirality of the hand tracked by a hand anchor.
+ Gets the value that indicates whether the hand is a left or right hand.
- Parameter hand_anchor: The hand anchor.
@@ -205,7 +207,7 @@
#ifdef __BLOCKS__
/**
- Handler called when there are updates to hand tracking.
+ A handler for receiving updates to hand anchors.
- Parameters:
- hand_anchor_left: The latest left hand anchor.
@@ -244,7 +246,7 @@
#pragma mark - Hand Tracking Provider
/**
- Create a hand tracking provider.
+ Creates a hand tracking provider.
- Parameter hand_tracking_configuration: The configuration for hand tracking.
@@ -259,7 +261,7 @@
#ifdef __BLOCKS__
/**
- Set the handler for receiving hand tracking updates.
+ Sets the handler for receiving hand tracking updates.
- Parameters:
- hand_tracking_provider: The hand tracking provider.
@@ -277,7 +279,7 @@
#endif // __BLOCKS__
/**
- Set the function for receiving hand tracking updates.
+ Sets the function for receiving hand tracking updates.
- Parameters:
- hand_tracking_provider: The hand tracking provider.
@@ -296,7 +298,7 @@
ar_hand_tracking_update_handler_function_t _Nullable hand_tracking_update_handler_function) AR_REFINED_FOR_SWIFT;
/**
- Determine whether this device supports the hand tracking provider.
+ Returns a Boolean value that indicates whether the current runtime environment supports hand tracking providers.
- Returns: `true` if the hand tracking provider is supported on this device, `false` otherwise.
*/
@@ -305,9 +307,9 @@
AR_EXTERN bool ar_hand_tracking_provider_is_supported(void) AR_REFINED_FOR_SWIFT;
/**
- Fill the given `ar_hand_anchor_t` instances with the latest hand tracking data. Subsequent calls will continue returning the latest hand tracking
+ Fetches the most recent hand anchors for each hand.
- data. New anchor data will be returned when the hand tracking data is updated.
+ Subsequent calls will continue returning the latest hand tracking data. New anchor data will be returned when the hand tracking data is updated.
- Note: For apps compiled with a visionOS 1.0 SDK, subsequent calls to this function will not update the given `ar_hand_anchor_t` instances, and will
return `false` until the latest hand tracking data has arrived.
@@ -361,7 +363,7 @@
ar_hand_anchor_t hand_anchor_right) AR_REFINED_FOR_SWIFT;
/**
- Get the authorization type required by the hand tracking provider.
+ Gets the types of authorizations required to track hands.
- Returns: The required authorization type.
*/
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/identifiers.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/identifiers.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/identifiers.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/identifiers.h 2026-11-04 09:32:06
@@ -87,7 +87,7 @@
typedef bool (*ar_identifiers_enumerator_function_t)(void *_Nullable context, uuid_t _Nonnull identifier) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of identifiers using a function.
+ Enumerates a collection of identifiers using a function.
- Parameters:
- identifiers: The collection of identifiers.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/image_tracking.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/image_tracking.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/image_tracking.h 2026-10-04 03:50:41
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/image_tracking.h 2026-11-04 09:32:06
@@ -27,7 +27,7 @@
API_UNAVAILABLE_BEGIN(macCatalyst);
/**
- An anchor that tracks an image's position and orientation in the physical environment.
+ A 2D image's position in a person's surroundings.
*/
AR_OBJECT_DECL_SUBCLASS(ar_image_anchor, ar_trackable_anchor)
AR_REFINED_FOR_SWIFT
@@ -41,7 +41,7 @@
API_AVAILABLE(visionos(1.0));
/**
- A reference image that can be detected and tracked.
+ A 2D image the system uses as a reference to find the same image in a person's surroundings.
*/
AR_OBJECT_DECL(ar_reference_image)
AR_REFINED_FOR_SWIFT
@@ -62,7 +62,7 @@
API_AVAILABLE(visionos(1.0));
/**
- A data provider for image tracking.
+ A source of live data about a 2D image's position in a person's surroundings.
*/
AR_OBJECT_DECL_SUBCLASS(ar_image_tracking_provider, ar_data_provider)
AR_REFINED_FOR_SWIFT
@@ -84,7 +84,7 @@
ar_image_anchor_t _Nullable other_anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the estimated scale factor from an image anchor.
+ Gets the estimated scale factor between the tracked image's physical size and the reference image's size.
- Parameter image_anchor: The image anchor.
@@ -94,7 +94,7 @@
AR_EXTERN float ar_image_anchor_get_estimated_scale_factor(ar_image_anchor_t image_anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the underlying tracked reference image from an image anchor.
+ Gets the reference image that this image anchor tracks.
- Parameter image_anchor: The image anchor to get the reference image from.
@@ -163,7 +163,7 @@
#pragma mark - Image Anchors Collection
/**
- Get the count of image anchors in a collection.
+ Gets the number of image anchors in the collection.
- Parameter image_anchors: The collection of image anchors.
@@ -174,7 +174,7 @@
#ifdef __BLOCKS__
/**
- Handler for enumerating a collection of image anchors.
+ A handler for enumerating a collection of image anchors.
- Parameter image_anchor: The image anchor.
@@ -184,7 +184,7 @@
typedef bool (^ar_image_anchors_enumerator_t)(ar_image_anchor_t image_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of image anchors.
+ Enumerates a collection of image anchors.
- Parameters:
- image_anchors: The collection of image anchors.
@@ -208,7 +208,7 @@
typedef bool (*ar_image_anchors_enumerator_function_t)(void *_Nullable context, ar_image_anchor_t image_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of image anchors using a function.
+ Enumerates a collection of image anchors using a function.
- Parameters:
- image_anchors: The collection of image anchors.
@@ -223,7 +223,7 @@
#pragma mark - Reference Image
/**
- Create a reference image from a `CVPixelBufferRef`.
+ Creates a reference image from a pixel buffer.
- Parameters:
- pixelBuffer: The reference image as `CVPixelBuffer`.
@@ -240,7 +240,7 @@
float physicalWidth) AR_REFINED_FOR_SWIFT;
/**
- Create a reference image from a `CGImageRef`.
+ Creates a reference image from a Core Graphics image.
- Parameters:
- image: The reference image as `CGImageRef`.
@@ -270,7 +270,7 @@
ar_reference_image_t _Nullable other_reference_image) AR_REFINED_FOR_SWIFT;
/**
- Set a reference image's name.
+ Sets the name of a reference image.
- Parameters:
- reference_image: The reference image.
@@ -280,7 +280,7 @@
AR_EXTERN void ar_reference_image_set_name(ar_reference_image_t reference_image, const char *_Nullable name) AR_REFINED_FOR_SWIFT;
/**
- Get a reference image's name.
+ Gets the name of a reference image.
- Parameter reference_image: The reference image.
@@ -305,7 +305,7 @@
AR_EXTERN const char *_Nullable ar_reference_image_get_resource_group_name(ar_reference_image_t reference_image) AR_REFINED_FOR_SWIFT;
/**
- Get the width of a reference image, in meters.
+ Gets the width, in meters, of a reference image in the real world.
- Parameter reference_image: The reference image.
@@ -315,7 +315,7 @@
AR_EXTERN float ar_reference_image_get_physical_width(ar_reference_image_t reference_image) AR_REFINED_FOR_SWIFT;
/**
- Get the height of a reference image, in meters.
+ Gets the height, in meters, of a reference image in the real world.
- Parameter reference_image: The reference image.
@@ -327,7 +327,7 @@
#pragma mark - Reference Images Collection
/**
- Create an empty collection of reference images.
+ Creates an empty collection of reference images.
- Note: This type supports ARC. In non-ARC files, use `ar_retain()` and `ar_release()` to retain and release the object.
@@ -337,7 +337,7 @@
AR_EXTERN AR_OBJECT_RETURNS_RETAINED ar_reference_images_t ar_reference_images_create(void) AR_REFINED_FOR_SWIFT;
/**
- Load reference images from a bundle into a new collection.
+ Creates multiple reference images based on their group name in an asset catalog.
- Parameters:
- group_name: The group to load images from.
@@ -352,7 +352,7 @@
ar_reference_images_load_reference_images_in_group(const char *group_name, CFBundleRef _Nullable bundle) AR_REFINED_FOR_SWIFT;
/**
- Add a reference image to a collection.
+ Adds a reference image to a collection.
The image must be unique. A duplicate of any existing image in the collection will not be added.
@@ -364,7 +364,7 @@
AR_EXTERN void ar_reference_images_add_image(ar_reference_images_t reference_images, ar_reference_image_t image_to_add) AR_REFINED_FOR_SWIFT;
/**
- Add reference images to a collection.
+ Adds multiple reference images to a collection.
The images must be unique. Duplicates of any existing image in the collection will not be added.
@@ -376,7 +376,7 @@
AR_EXTERN void ar_reference_images_add_images(ar_reference_images_t reference_images, ar_reference_images_t images_to_add) AR_REFINED_FOR_SWIFT;
/**
- Get the count of reference images in the collection.
+ Gets the number of reference images in a collection.
- Parameter reference_images: The collection of reference images.
@@ -387,7 +387,7 @@
#ifdef __BLOCKS__
/**
- Handler for enumerating a collection of reference images.
+ A handler for enumerating a collection of reference images.
- Parameter reference_image: The reference image.
@@ -397,7 +397,7 @@
typedef bool (^ar_reference_images_enumerator_t)(ar_reference_image_t reference_image) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of reference images.
+ Enumerates a collection of reference images.
- Parameters:
- reference_images: The collection of reference images.
@@ -421,7 +421,7 @@
typedef bool (*ar_reference_images_enumerator_function_t)(void *_Nullable context, ar_reference_image_t reference_image) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of reference images using a function.
+ Enumerates a collection of reference images using a function.
- Parameters:
- reference_images: The collection of reference images.
@@ -437,7 +437,7 @@
#pragma mark - Image Tracking Configuration
/**
- Create an image tracking configuration.
+ Creates an image tracking configuration.
- Note: This type supports ARC. In non-ARC files, use `ar_retain()` and `ar_release()` to retain and release the object.
@@ -447,9 +447,9 @@
AR_EXTERN AR_OBJECT_RETURNS_RETAINED ar_image_tracking_configuration_t ar_image_tracking_configuration_create(void) AR_REFINED_FOR_SWIFT;
/**
- Add reference images to the set of images to be tracked. The image tracking configuration can run without any reference images, but will not detect
+ Adds reference images to the set to be tracked.
- anything.
+ The image tracking configuration can run without any reference images, but will not detect anything.
- Parameters:
- image_tracking_configuration: The configuration for image tracking.
@@ -462,7 +462,7 @@
#pragma mark - Image Tracking Provider
/**
- Create an image tracking provider.
+ Creates an image tracking provider that tracks the reference images you supply.
- Parameter image_tracking_configuration: The configuration for image tracking.
@@ -476,7 +476,7 @@
#ifdef __BLOCKS__
/**
- Handler called when there are updates to image anchors.
+ A handler for receiving updates to image anchors.
- Parameters:
- added_anchors: The collection of anchors that were added.
@@ -489,7 +489,7 @@
ar_image_anchors_t removed_anchors) AR_REFINED_FOR_SWIFT;
/**
- Set the handler for receiving image tracking updates.
+ Sets the handler for receiving image tracking updates.
- Parameters:
- image_tracking_provider: The image tracking provider.
@@ -521,7 +521,7 @@
ar_image_anchors_t removed_anchors) AR_REFINED_FOR_SWIFT;
/**
- Set the function for receiving image tracking updates.
+ Sets the function for receiving image tracking updates.
- Parameters:
- image_tracking_provider: The image tracking provider.
@@ -551,7 +551,7 @@
ar_image_tracking_provider_copy_all_image_anchors(ar_image_tracking_provider_t image_tracking_provider) AR_REFINED_FOR_SWIFT;
/**
- Determine whether this device supports the image tracking provider.
+ Returns a Boolean value that indicates whether the current runtime environment supports image tracking providers.
- Returns: `true` if the image tracking provider is supported on this device, `false` otherwise.
*/
@@ -559,7 +559,7 @@
AR_EXTERN bool ar_image_tracking_provider_is_supported(void) AR_REFINED_FOR_SWIFT;
/**
- Get the authorization type required by the image tracking provider.
+ Gets the types of authorizations required to track images.
- Returns: The required authorization type.
*/
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/object.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/object.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/object.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/object.h 2026-11-04 09:32:06
@@ -82,7 +82,7 @@
AR_EXTERN_C_BEGIN
/**
- Increment the reference count of an ARKit.framework object.
+ Adds a reference count to an ARKit object.
- Parameter object: An ARKit.framework object.
*/
@@ -90,7 +90,7 @@
AR_EXTERN __SWIFT_UNAVAILABLE_MSG("Can't be used with ARC") void *_Nullable ar_retain(void *_Nullable object) AR_REFINED_FOR_SWIFT;
/**
- Decrement the reference count of an ARKit.framework object.
+ Releases a reference count on an ARKit object.
- Parameter object: An ARKit.framework object.
*/
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/object_tracking.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/object_tracking.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/object_tracking.h 2026-10-04 03:50:41
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/object_tracking.h 2026-11-04 09:32:06
@@ -237,7 +237,7 @@
typedef bool (^ar_object_anchors_enumerator_t)(ar_object_anchor_t object_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of object anchors.
+ Enumerates a collection of object anchors.
- Parameters:
- object_anchors: The collection of object anchors.
@@ -262,7 +262,7 @@
typedef bool (*ar_object_anchors_enumerator_function_t)(void *_Nullable context, ar_object_anchor_t object_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of object anchors.
+ Enumerates a collection of object anchors using a function.
- Parameters:
- object_anchors: The collection of object anchors.
@@ -643,7 +643,7 @@
typedef bool (^ar_reference_objects_enumerator_t)(ar_reference_object_t reference_object) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of reference objects.
+ Enumerates a collection of reference objects.
- Parameters:
- reference_objects: The collection of reference objects.
@@ -668,7 +668,7 @@
typedef bool (*ar_reference_objects_enumerator_function_t)(void *_Nullable context, ar_reference_object_t reference_object) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of reference objects.
+ Enumerates a collection of reference objects using a function.
- Parameters:
- reference_objects: The collection of reference objects.
@@ -844,7 +844,7 @@
#pragma mark - Object tracking provider
/**
- Error codes specific to object tracking.
+ Error codes that describe object tracking failures.
*/
API_AVAILABLE(visionos(2.0))
OS_ENUM(ar_object_tracking_error_code, ar_error_code_t,
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/plane_detection.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/plane_detection.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/plane_detection.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/plane_detection.h 2026-11-04 09:32:06
@@ -26,7 +26,7 @@
API_UNAVAILABLE_BEGIN(macCatalyst);
/**
- An anchor that tracks a detected plane's position and geometry.
+ An anchor that represents horizontal and vertical planes.
*/
AR_OBJECT_DECL_SUBCLASS(ar_plane_anchor, ar_anchor)
AR_REFINED_FOR_SWIFT
@@ -40,14 +40,14 @@
API_AVAILABLE(visionos(1.0));
/**
- Describes the geometry of a detected plane including vertices and extent.
+ The geometry of a plane anchor.
*/
AR_OBJECT_DECL(ar_plane_geometry)
AR_REFINED_FOR_SWIFT
API_AVAILABLE(visionos(1.0));
/**
- Describes the bounding rectangle of a detected plane.
+ The size of a plane.
*/
AR_OBJECT_DECL(ar_plane_extent)
AR_REFINED_FOR_SWIFT
@@ -61,7 +61,7 @@
API_AVAILABLE(visionos(1.0));
/**
- A data provider for plane detection.
+ A source of live data about planes in a person's surroundings.
*/
AR_OBJECT_DECL_SUBCLASS(ar_plane_detection_provider, ar_data_provider)
AR_REFINED_FOR_SWIFT
@@ -92,38 +92,38 @@
) AR_REFINED_FOR_SWIFT;
/**
- A value describing the classification of a plane anchor.
+ The kinds of object classification a plane anchor can have.
*/
OS_ENUM(ar_plane_classification, intptr_t,
- /** The plane classification is currently unavailable. */
+ /** A plane classification is currently unavailable. */
ar_plane_classification_status_not_available = 0,
- /** The classification of the plane has not yet been determined. */
+ /** A plane classification is undetermined. */
ar_plane_classification_status_undetermined,
- /** The plane classification is not any of the known classes. */
+ /** A plane classification isn't one of the known classes. */
ar_plane_classification_status_unknown,
- /** The classification is of type wall. */
+ /** A wall. */
ar_plane_classification_wall,
- /** The classification is of type floor. */
+ /** A floor. */
ar_plane_classification_floor,
- /** The classification is of type ceiling. */
+ /** A ceiling. */
ar_plane_classification_ceiling,
- /** The classification is of type table. */
+ /** A table. */
ar_plane_classification_table,
-
- /** The classification is of type seat. */
+
+ /** A seat. */
ar_plane_classification_seat,
- /** The classification is of type window. */
+ /** A window. */
ar_plane_classification_window,
- /** The classification is of type door. */
+ /** A door. */
ar_plane_classification_door
) AR_REFINED_FOR_SWIFT
@@ -132,7 +132,7 @@
#ifdef __BLOCKS__
/**
- Handler called when there are updates to plane anchors.
+ A handler for receiving updates to plane anchors.
- Parameters:
- added_anchors: The collection of anchors that were added.
@@ -163,7 +163,7 @@
#pragma mark - Plane Detection Configuration
/**
- Create a plane detection configuration.
+ Creates a plane detection configuration.
- Note: The alignment is set to `ar_plane_alignment_horizontal | ar_plane_alignment_vertical` by default.
- Note: This type supports ARC. In non-ARC files, use `ar_retain()` and `ar_release()` to retain and release the object.
@@ -174,7 +174,7 @@
AR_EXTERN AR_OBJECT_RETURNS_RETAINED ar_plane_detection_configuration_t ar_plane_detection_configuration_create(void) AR_REFINED_FOR_SWIFT;
/**
- Set the desired alignment of planes to detect.
+ Sets the plane alignments that you want the provider to detect.
- Parameters:
- plane_detection_configuration: The configuration for plane detection.
@@ -200,7 +200,7 @@
ar_plane_anchor_t _Nullable other_anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the alignment of a plane anchor.
+ Gets the alignment — horizontal or vertical — of a plane anchor relative to gravity.
- Parameter plane_anchor: The plane anchor.
@@ -210,7 +210,7 @@
AR_EXTERN ar_plane_alignment_t ar_plane_anchor_get_alignment(ar_plane_anchor_t plane_anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the geometry of a plane anchor.
+ Gets the geometry of a plane anchor.
- Parameter plane_anchor: The plane anchor.
@@ -220,7 +220,7 @@
AR_EXTERN ar_plane_geometry_t ar_plane_anchor_get_geometry(ar_plane_anchor_t plane_anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the classification of a plane anchor.
+ Gets the kind of real-world object that ARKit determines the plane anchor might be.
- Parameter plane_anchor: The plane anchor.
@@ -300,7 +300,7 @@
ar_plane_geometry_t _Nullable other_plane_geometry) AR_REFINED_FOR_SWIFT;
/**
- Get the mesh vertices of a plane geometry.
+ Gets the vertices in the mesh that describes a plane.
- Parameter plane_geometry: The plane geometry.
@@ -310,7 +310,7 @@
AR_EXTERN ar_geometry_source_t ar_plane_geometry_get_mesh_vertices(ar_plane_geometry_t plane_geometry) AR_REFINED_FOR_SWIFT;
/**
- Get the mesh faces of a plane geometry.
+ Gets the faces in the mesh that describes a plane.
- Parameter plane_geometry: The plane geometry.
@@ -320,7 +320,7 @@
AR_EXTERN ar_geometry_element_t ar_plane_geometry_get_mesh_faces(ar_plane_geometry_t plane_geometry) AR_REFINED_FOR_SWIFT;
/**
- Get the extent of a plane geometry.
+ Gets the size of a plane.
- Parameter plane_geometry: The plane geometry.
@@ -345,7 +345,7 @@
ar_plane_extent_t _Nullable other_plane_extent) AR_REFINED_FOR_SWIFT;
/**
- Get the width of a plane extent.
+ Gets the width of a plane.
- Parameter plane_extent: The plane extent.
@@ -355,7 +355,7 @@
AR_EXTERN float ar_plane_extent_get_width(ar_plane_extent_t plane_extent) AR_REFINED_FOR_SWIFT;
/**
- Get the height of the plane extent.
+ Gets the height of a plane.
- Parameter plane_extent: The plane extent.
@@ -365,7 +365,7 @@
AR_EXTERN float ar_plane_extent_get_height(ar_plane_extent_t plane_extent) AR_REFINED_FOR_SWIFT;
/**
- Get the transform from a plane extent to the plane anchor’s coordinate system.
+ Gets the transform from a plane extent to the plane anchor’s coordinate system.
- Parameter plane_extent: The plane extent.
@@ -377,7 +377,7 @@
#pragma mark - Plane Anchors Collection
/**
- Get the count of plane anchors in a collection.
+ Gets the number of plane anchors in a collection.
- Parameter plane_anchors: The collection of plane anchors.
@@ -388,7 +388,7 @@
#ifdef __BLOCKS__
/**
- Handler for enumerating a collection of plane anchors.
+ A handler for enumerating a collection of plane anchors.
- Parameter plane_anchor: The plane anchor.
@@ -398,7 +398,7 @@
typedef bool (^ar_plane_anchors_enumerator_t)(ar_plane_anchor_t plane_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of plane anchors.
+ Enumerates a collection of plane anchors.
- Parameters:
- plane_anchors: The collection of plane anchors.
@@ -422,7 +422,7 @@
typedef bool (*ar_plane_anchors_enumerator_function_t)(void *_Nullable context, ar_plane_anchor_t plane_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of plane anchors using a function.
+ Enumerates a collection of plane anchors using a function.
- Parameters:
- plane_anchors: The collection of plane anchors.
@@ -437,7 +437,7 @@
#pragma mark - Plane Detection Provider
/**
- Create a plane detection provider.
+ Creates a plane detection provider for the types of planes you want to detect.
- Parameter plane_detection_configuration: The configuration for plane detection.
@@ -451,7 +451,7 @@
#ifdef __BLOCKS__
/**
- Set the handler for receiving plane detection updates.
+ Sets the handler for receiving plane detection updates.
- Parameters:
- plane_detection_provider: The plane detection provider.
@@ -468,7 +468,7 @@
#endif // __BLOCKS__
/**
- Set the function for receiving plane detection updates.
+ Sets the function for receiving plane detection updates.
- Parameters:
- plane_detection_provider: The plane detection provider.
@@ -498,7 +498,7 @@
ar_plane_detection_provider_copy_all_plane_anchors(ar_plane_detection_provider_t plane_detection_provider) AR_REFINED_FOR_SWIFT;
/**
- Determine whether this device supports the plane detection provider.
+ Returns a Boolean value that indicates whether the current runtime environment supports plane detection providers.
- Returns: `true` if the plane detection provider is supported on this device, `false` otherwise.
*/
@@ -506,7 +506,7 @@
AR_EXTERN bool ar_plane_detection_provider_is_supported(void) AR_REFINED_FOR_SWIFT;
/**
- Get the authorization type required by the plane detection provider.
+ Gets the types of authorizations necessary for detecting planes.
- Returns: The required authorization type.
*/
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/room_tracking.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/room_tracking.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/room_tracking.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/room_tracking.h 2026-11-04 09:32:06
@@ -223,7 +223,7 @@
typedef bool (*ar_room_anchors_enumerator_function_t)(void *_Nullable context, ar_room_anchor_t room_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of room anchors using a function.
+ Enumerates a collection of room anchors using a function.
- Parameters:
- room_anchors: The collection of room anchors.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/scene_reconstruction.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/scene_reconstruction.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/scene_reconstruction.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/scene_reconstruction.h 2026-11-04 09:32:06
@@ -35,6 +35,8 @@
API_AVAILABLE(visionos(1.0));
/**
+ The shapes that make up a mesh anchor.
+
Describes the geometry of a mesh including vertices, normals, and faces.
*/
AR_OBJECT_DECL(ar_mesh_geometry)
@@ -49,6 +51,8 @@
API_AVAILABLE(visionos(2.0));
/**
+ A container for geometrical vector data.
+
Describes a source of geometry data such as vertices or normals.
*/
AR_OBJECT_DECL(ar_geometry_source)
@@ -56,6 +60,8 @@
API_AVAILABLE(visionos(1.0));
/**
+ A container for vertex indices of lines or triangles.
+
Describes geometry index data organized as primitives like triangles or lines.
*/
AR_OBJECT_DECL(ar_geometry_element)
@@ -77,7 +83,7 @@
API_AVAILABLE(visionos(1.0));
/**
- A data provider for scene reconstruction.
+ A source of live data about the shape of a person's surroundings.
*/
AR_OBJECT_DECL_SUBCLASS(ar_scene_reconstruction_provider, ar_data_provider)
AR_REFINED_FOR_SWIFT
@@ -86,35 +92,48 @@
#pragma mark - Geometry Element
/**
- A value describing the primitive type of an `ar_geometry_element_t`.
+ The kinds of geometry primitives that a geometry element can contain.
*/
API_AVAILABLE(visionos(1.0))
OS_ENUM(ar_geometry_primitive_type, intptr_t,
- /** A primitive type representing a line. */
+ /** Two vertices that connect to form a line. */
ar_geometry_primitive_type_line = 0,
- /** A primitive type representing a triangle. */
+ /** Three vertices that connect to form a triangle. */
ar_geometry_primitive_type_triangle
) AR_REFINED_FOR_SWIFT;
/**
- A value describing the classification of a mesh face of an `ar_mesh_geometry_t`.
+ The kinds of classification a mesh anchor can have.
*/
OS_ENUM(ar_mesh_classification, intptr_t,
ar_mesh_classification_none = 0,
+ /** A wall. */
ar_mesh_classification_wall,
+ /** A floor. */
ar_mesh_classification_floor,
+ /** A ceiling. */
ar_mesh_classification_ceiling,
+ /** A table. */
ar_mesh_classification_table,
+ /** A seat. */
ar_mesh_classification_seat,
+ /** A window. */
ar_mesh_classification_window,
+ /** A door. */
ar_mesh_classification_door,
+ /** A set of stairs. */
ar_mesh_classification_stairs,
+ /** A bed. */
ar_mesh_classification_bed,
+ /** A cabinet. */
ar_mesh_classification_cabinet,
+ /** A home appliance. */
ar_mesh_classification_home_appliance,
+ /** A television. */
ar_mesh_classification_tv,
+ /** A plant. */
ar_mesh_classification_plant
) AR_REFINED_FOR_SWIFT
API_DEPRECATED_WITH_REPLACEMENT("ar_surface_classification_t", visionos(1.0, 26.0));
@@ -156,7 +175,7 @@
#ifdef __OBJC__
/**
- Get a Metal buffer containing index data that defines a geometry element.
+ Gets a Metal buffer that contains index data that defines the geometry of an object.
- Parameter geometry_element: The geometry element.
@@ -167,7 +186,7 @@
#endif // __OBJC__
/**
- Get the count of primitives in a geometry element.
+ Gets the number of primitives in the Metal buffer for a geometry element.
- Parameter geometry_element: The geometry element.
@@ -177,7 +196,7 @@
AR_EXTERN size_t ar_geometry_element_get_count(ar_geometry_element_t geometry_element) AR_REFINED_FOR_SWIFT;
/**
- Get the number of bytes per index value in a geometry element.
+ Gets the number of bytes that represent an index value.
- Parameter geometry_element: The geometry element.
@@ -187,7 +206,7 @@
AR_EXTERN size_t ar_geometry_element_get_bytes_per_index(ar_geometry_element_t geometry_element) AR_REFINED_FOR_SWIFT;
/**
- Get the index count per primitive of a geometry element.
+ Gets the number of indices for each primitive.
This is based on the primitive type. For `ar_geometry_primitive_type_triangle` the value is `3`.
@@ -199,7 +218,7 @@
AR_EXTERN size_t ar_geometry_element_get_index_count_per_primitive(ar_geometry_element_t geometry_element) AR_REFINED_FOR_SWIFT;
/**
- Get the primitive type of a geometry element.
+ Gets the kind of primitive, lines or triangles, that a geometry element contains.
- Parameter geometry_element: The geometry element.
@@ -225,7 +244,7 @@
#ifdef __OBJC__
/**
- Get a Metal buffer containing per-vector data for a geometry source.
+ Gets a Metal buffer that contains per-vector data for a geometry source.
- Parameter geometry_source: The geometry source.
@@ -236,7 +255,7 @@
#endif // __OBJC__
/**
- Get the count of vectors in a geometry source.
+ Gets the number of vectors in a geometry source.
- Parameter geometry_source: The geometry source.
@@ -247,7 +266,7 @@
#ifdef __OBJC__
/**
- Get the type of per-vector data in a geometry source.
+ Gets the vertex format for data in a geometry source's buffer.
- Parameter geometry_source: The geometry source.
@@ -258,7 +277,7 @@
#endif // __OBJC__
/**
- Get the count of scalar components in each vector of a geometry source.
+ Gets the number of scalar components in each vector in a geometry source.
- Parameter geometry_source: The geometry source.
@@ -268,7 +287,7 @@
AR_EXTERN size_t ar_geometry_source_get_components_per_vector(ar_geometry_source_t geometry_source) AR_REFINED_FOR_SWIFT;
/**
- Get the offset (in bytes) from the beginning of a geometry source's Metal buffer.
+ Gets the offset, in bytes, from the beginning of a geometry source's buffer.
- Parameter geometry_source: The geometry source.
@@ -278,7 +297,7 @@
AR_EXTERN size_t ar_geometry_source_get_offset(ar_geometry_source_t geometry_source) AR_REFINED_FOR_SWIFT;
/**
- Get the number of bytes from a vector to the next one in a geometry source's Metal buffer.
+ Gets the number of bytes between one vector and another in a geometry source's buffer.
- Parameter geometry_source: The geometry source.
@@ -303,7 +322,7 @@
ar_mesh_geometry_t _Nullable other_mesh_geometry) AR_REFINED_FOR_SWIFT;
/**
- Get the vertices of a mesh geometry.
+ Gets the vertices of the mesh.
- Parameter mesh_geometry: The mesh geometry.
@@ -313,7 +332,7 @@
AR_EXTERN ar_geometry_source_t ar_mesh_geometry_get_vertices(ar_mesh_geometry_t mesh_geometry) AR_REFINED_FOR_SWIFT;
/**
- Get the normals of a mesh geometry.
+ Gets the normals of the mesh.
- Parameter mesh_geometry: The mesh geometry.
@@ -323,7 +342,7 @@
AR_EXTERN ar_geometry_source_t ar_mesh_geometry_get_normals(ar_mesh_geometry_t mesh_geometry) AR_REFINED_FOR_SWIFT;
/**
- Get the faces of a mesh geometry.
+ Gets the faces of the mesh.
- Parameter mesh_geometry: The mesh geometry.
@@ -333,7 +352,7 @@
AR_EXTERN ar_geometry_element_t ar_mesh_geometry_get_faces(ar_mesh_geometry_t mesh_geometry) AR_REFINED_FOR_SWIFT;
/**
- Get the classification for each face of a mesh geometry.
+ Gets the classification of each face in the mesh.
- Parameter mesh_geometry: The mesh geometry.
@@ -390,7 +409,7 @@
typedef bool (*ar_mesh_geometries_enumerator_function_t)(void *_Nullable context, ar_mesh_geometry_t mesh_geometry) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of mesh geometries using a function.
+ Enumerates a collection of mesh geometries using a function.
- Parameters:
- mesh_geometries: The collection of mesh geometries.
@@ -419,8 +438,10 @@
ar_mesh_anchor_t _Nullable other_mesh_anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the geometry of the mesh in a mesh anchor's coordinate system.
+ Gets the shape of a mesh anchor.
+ The geometry is expressed in the mesh anchor's coordinate system.
+
- Parameter mesh_anchor: The mesh anchor.
- Returns: An instance of `ar_mesh_geometry_t`.
@@ -476,7 +497,7 @@
#pragma mark - Mesh Anchors Collection
/**
- Get the count of mesh anchors in a collection.
+ Gets the number of mesh anchors in the collection.
- Parameter mesh_anchors: The collection of mesh anchors.
@@ -487,7 +508,7 @@
#ifdef __BLOCKS__
/**
- Handler for enumerating a collection of mesh anchors.
+ A handler for enumerating a collection of mesh anchors.
- Parameter mesh_anchor: The mesh anchor.
@@ -497,7 +518,7 @@
typedef bool (^ar_mesh_anchors_enumerator_t)(ar_mesh_anchor_t mesh_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of mesh anchors.
+ Enumerates a collection of mesh anchors.
- Parameters:
- mesh_anchors: The collection of mesh anchors.
@@ -521,7 +542,7 @@
typedef bool (*ar_mesh_anchors_enumerator_function_t)(void *_Nullable context, ar_mesh_anchor_t mesh_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of mesh anchors using a function.
+ Enumerates a collection of mesh anchors using a function.
- Parameters:
- mesh_anchors: The collection of mesh anchors.
@@ -536,7 +557,7 @@
#pragma mark - Scene Reconstruction Configuration
/**
- Scene reconstruction modes.
+ The additional kinds of information you can request about a person's surroundings.
*/
API_AVAILABLE(visionos(1.0))
OS_OPTIONS(ar_scene_reconstruction_mode,
@@ -550,7 +571,7 @@
#ifdef __BLOCKS__
/**
- Handler called when there are updates to mesh anchors.
+ A handler for receiving updates to mesh anchors.
- Parameters:
- added_anchors: The collection of anchors that were added.
@@ -579,7 +600,7 @@
ar_mesh_anchors_t removed_anchors) AR_REFINED_FOR_SWIFT;
/**
- Create a scene reconstruction configuration.
+ Creates a scene reconstruction configuration.
- Note: This type supports ARC. In non-ARC files, use `ar_retain()` and `ar_release()` to retain and release the object.
@@ -589,7 +610,7 @@
AR_EXTERN AR_OBJECT_RETURNS_RETAINED ar_scene_reconstruction_configuration_t ar_scene_reconstruction_configuration_create(void) AR_REFINED_FOR_SWIFT;
/**
- Get the scene reconstruction mode.
+ Gets the scene reconstruction mode.
- Parameter scene_reconstruction_configuration: The configuration for scene reconstruction.
@@ -600,7 +621,7 @@
ar_scene_reconstruction_configuration_t scene_reconstruction_configuration) AR_REFINED_FOR_SWIFT;
/**
- Set the scene reconstruction mode.
+ Sets the scene reconstruction mode.
- Parameters:
- scene_reconstruction_configuration: The configuration for scene reconstruction.
@@ -614,7 +635,7 @@
#pragma mark - Scene Reconstruction Provider
/**
- Create a scene reconstruction provider.
+ Creates a provider that reconstructs the person's surroundings.
- Parameter scene_reconstruction_configuration: The configuration for scene reconstruction.
@@ -628,7 +649,7 @@
#ifdef __BLOCKS__
/**
- Set the handler for receiving scene reconstruction updates.
+ Sets the handler for receiving scene reconstruction updates.
- Parameters:
- scene_reconstruction_provider: The scene reconstruction provider.
@@ -645,7 +666,7 @@
#endif // __BLOCKS__
/**
- Set the function for receiving scene reconstruction updates.
+ Sets the handler for receiving scene reconstruction updates.
- Parameters:
- scene_reconstruction_provider: The scene reconstruction provider.
@@ -675,7 +696,7 @@
ar_scene_reconstruction_provider_copy_all_mesh_anchors(ar_scene_reconstruction_provider_t scene_reconstruction_provider) AR_REFINED_FOR_SWIFT;
/**
- Determine whether this device supports the scene reconstruction provider.
+ Returns a Boolean value that indicates whether the current runtime environment supports scene reconstruction providers.
- Returns: `true` if the scene reconstruction provider is supported on this device, `false` otherwise.
*/
@@ -683,7 +704,7 @@
AR_EXTERN bool ar_scene_reconstruction_provider_is_supported(void) AR_REFINED_FOR_SWIFT;
/**
- Get the authorization type required by the scene reconstruction provider.
+ Gets the types of authorizations needed to run scene reconstruction.
- Returns: The required authorization type.
*/
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/session.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/session.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/session.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/session.h 2026-11-04 09:32:06
@@ -31,14 +31,14 @@
#pragma mark - Session
/**
- An ARKit session that manages data providers and authorization.
+ The main entry point for receiving data from ARKit.
*/
AR_OBJECT_DECL(ar_session)
AR_REFINED_FOR_SWIFT
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0));
/**
- Create an ARKit session.
+ Creates a new session.
- Note: This type supports ARC. In non-ARC files, use `ar_retain()` and `ar_release()` to retain and release the object.
@@ -62,13 +62,13 @@
AR_EXTERN AR_OBJECT_RETURNS_RETAINED ar_session_t ar_session_create_with_device(ar_device_t device) AR_REFINED_FOR_SWIFT;
/**
- Session error codes.
+ The error codes for ARKit sessions.
*/
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0))
OS_ENUM(ar_session_error_code, ar_error_code_t,
- /// Error code indicating that a data provider requires an authorization that has not been granted by the user.
+ /** The error code for when a data provider is missing at least one authorization it needs to run. */
ar_session_error_code_data_provider_not_authorized = 100,
- /// Error code indicating a data provider has failed to run.
+ /** The error code for when a data provider fails to run. */
ar_session_error_code_data_provider_failed_to_run = 101
) AR_REFINED_FOR_SWIFT;
@@ -142,7 +142,7 @@
ar_session_data_provider_state_change_handler_function_t _Nullable data_provider_state_change_handler_function) AR_REFINED_FOR_SWIFT;
/**
- Run data providers on a session.
+ Runs a session with the data providers you supply.
- Parameters:
- session: The session.
@@ -152,7 +152,7 @@
AR_EXTERN void ar_session_run(ar_session_t session, ar_data_providers_t data_providers) AR_REFINED_FOR_SWIFT;
/**
- Stop all running data providers on a session.
+ Stops a session.
- Parameter session: The session.
*/
@@ -174,7 +174,7 @@
#ifdef __BLOCKS__
/**
- Handler to be called when there are updates to authorization.
+ A handler for receiving updates in authorization status for a specific authorization type.
- Parameter authorization_result: The authorization result.
*/
@@ -182,7 +182,7 @@
typedef void (^ar_authorization_update_handler_t)(ar_authorization_result_t authorization_result) AR_REFINED_FOR_SWIFT;
/**
- Set the handler for receiving authorization status updates.
+ Sets the handler for receiving updates in authorization status for a specific authorization type.
- Parameters:
- session: The session.
@@ -211,7 +211,7 @@
ar_authorization_result_t authorization_result) AR_REFINED_FOR_SWIFT;
/**
- Set the function for receiving authorization status updates.
+ Sets the handler for receiving updates in authorization status for a specific authorization type.
- Parameters:
- session: The session.
@@ -231,7 +231,7 @@
#ifdef __BLOCKS__
/**
- Handler to be called upon completion of an authorization request.
+ A handler to call upon completion of an authorization request.
- Parameters:
- authorization_results: The collection of authorization results.
@@ -241,7 +241,7 @@
typedef void (^ar_authorization_results_handler_t)(ar_authorization_results_t authorization_results, ar_error_t _Nullable error) AR_REFINED_FOR_SWIFT;
/**
- Query the status of different authorization types.
+ Checks whether the current session is authorized for particular authorization types without requesting authorization.
- Parameters:
- session: The session.
@@ -255,7 +255,7 @@
ar_authorization_results_handler_t results_handler) AR_REFINED_FOR_SWIFT;
/**
- Request authorization for accessing ARKit data.
+ Requests authorization from the user to use the specified kinds of ARKit data.
This will asynchronously prompt users for permission to access their data. If the authorization is already allowed or denied by the user,
the handler will be called without prompting the user for permission again.
@@ -286,7 +286,7 @@
ar_error_t _Nullable error) AR_REFINED_FOR_SWIFT;
/**
- Query the status of different authorization types.
+ Checks whether the current session is authorized for particular authorization types without requesting authorization.
- Parameters:
- session: The session.
@@ -302,7 +302,7 @@
ar_authorization_results_handler_function_t results_handler_function) AR_REFINED_FOR_SWIFT;
/**
- Request authorization for accessing ARKit data.
+ Requests authorization from the user to use the specified kinds of ARKit data.
This will asynchronously prompt users for permission to access their data. If the authorization is already allowed or denied by the user,
the function will be called without prompting the user for permission again.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/strings_collection.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/strings_collection.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/strings_collection.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/strings_collection.h 2026-11-04 09:32:06
@@ -74,7 +74,7 @@
typedef bool (*ar_strings_enumerator_function_t)(void *_Nullable context, const char *string) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of strings using a function.
+ Enumerates a collection of strings using a function.
- Parameters:
- strings: Strings collection.
diff -ruN /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/world_tracking.h /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/world_tracking.h
--- /Applications/Xcode_27.2.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/world_tracking.h 2026-10-04 03:50:42
+++ /Applications/Xcode_27.3.0-beta1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ARKit.framework/Headers/world_tracking.h 2026-11-04 09:32:06
@@ -23,7 +23,7 @@
AR_ASSUME_NONNULL_BEGIN
/**
- An anchor that can be placed at a location in the real world.
+ A fixed location in a person's surroundings.
*/
AR_OBJECT_DECL_SUBCLASS(ar_world_anchor, ar_trackable_anchor)
AR_REFINED_FOR_SWIFT
@@ -46,7 +46,7 @@
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0));
/**
- A data provider for world tracking.
+ A source of live data about the device pose and anchors in a person's surroundings.
*/
AR_OBJECT_DECL_SUBCLASS(ar_world_tracking_provider, ar_data_provider)
AR_REFINED_FOR_SWIFT
@@ -69,7 +69,7 @@
ar_world_anchor_t _Nullable other_anchor) AR_REFINED_FOR_SWIFT;
/**
- Create a world anchor initialized with a transform from the anchor to the origin coordinate system.
+ Creates a world anchor from a position and orientation in world space.
- Parameter origin_from_anchor_transform: The origin from anchor transform.
@@ -145,7 +145,7 @@
#pragma mark - World Anchors Collection
/**
- Get the count of world anchors in a collection.
+ Gets the number of world anchors in the collection.
- Parameter world_anchors: The collection of world anchors.
@@ -157,7 +157,7 @@
#ifdef __BLOCKS__
/**
- Handler for enumerating a collection of world anchors.
+ A handler for enumerating a collection of world anchors.
- Parameter world_anchor: The world anchor.
@@ -168,7 +168,7 @@
typedef bool (^ar_world_anchors_enumerator_t)(ar_world_anchor_t world_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of world anchors.
+ Enumerates a collection of world anchors.
- Parameters:
- world_anchors: The collection of world anchors.
@@ -194,7 +194,7 @@
typedef bool (*ar_world_anchors_enumerator_function_t)(void *_Nullable context, ar_world_anchor_t world_anchor) AR_REFINED_FOR_SWIFT;
/**
- Enumerate a collection of world anchors using a function.
+ Enumerates a collection of world anchors using a function.
- Parameters:
- world_anchors: The collection of world anchors.
@@ -210,7 +210,7 @@
#pragma mark - World Tracking Configuration
/**
- Create a world tracking configuration.
+ Creates a world tracking configuration.
- Note: This type supports ARC. In non-ARC files, use `ar_retain()` and `ar_release()` to retain and release the object.
@@ -222,7 +222,7 @@
#pragma mark - World Tracking Provider
/**
- Create a world tracking provider.
+ Creates a world tracking provider.
- Parameter world_tracking_configuration: The configuration for world tracking.
@@ -298,9 +298,10 @@
#ifdef __BLOCKS__
/**
- A handler that the provider calls when there are updates to world anchors. This includes updates to persisted world anchors from previous runs of the
- app.
+ A handler for receiving updates to world anchors.
+ This includes updates to persisted world anchors from previous runs of the app.
+
- Parameters:
- added_anchors: The collection of world anchors that were added.
- updated_anchors: The collection of world anchors that were updated.
@@ -317,7 +318,7 @@
ar_world_anchors_t removed_anchors) AR_REFINED_FOR_SWIFT;
/**
- Set the handler for receiving world tracking anchor updates.
+ Sets the handler for receiving world tracking updates.
- Parameters:
- world_tracking_provider: The world tracking provider.
@@ -374,21 +375,21 @@
ar_world_tracking_anchor_update_handler_function_t _Nullable world_tracking_anchor_update_handler_function) AR_REFINED_FOR_SWIFT;
/**
- Error codes specific to world tracking.
+ The error codes for errors that world tracking providers throw.
*/
API_AVAILABLE(visionos(1.0))
API_UNAVAILABLE(macos, macCatalyst)
OS_ENUM(ar_world_tracking_error_code, ar_error_code_t,
- /// Error code indicating that a world anchor failed to be added.
+ /** The error code for when a world tracking provider can't add a world anchor. */
ar_world_tracking_error_code_add_anchor_failed = 200,
- /// Error code indicating that the maximum amount of world anchors have been added.
+ /** The error code for when a world tracking provider reaches its world anchor limit. */
ar_world_tracking_error_code_anchor_max_limit_reached = 201,
- /// Error code indicating that a world anchor failed to be removed.
+ /** The error code for when a world tracking provider can't remove a world anchor. */
ar_world_tracking_error_code_remove_anchor_failed = 202
) AR_REFINED_FOR_SWIFT;
/**
- Determine whether this device supports the world tracking provider.
+ Returns a Boolean value that indicates whether the current runtime environment supports world tracking providers.
- Returns: `true` if the world tracking provider is supported on this device, `false` otherwise.
*/
@@ -397,7 +398,7 @@
#ifdef __BLOCKS__
/**
- A handler that the provider calls when a request to add a world anchor has completed (successfully or not).
+ A handler to call upon completion of a request to add a world anchor.
- Parameters:
- world_anchor: The world anchor to be added to the world tracking provider.
@@ -411,8 +412,10 @@
ar_error_t _Nullable error) AR_REFINED_FOR_SWIFT;
/**
- Add a world anchor to the world tracking provider. This anchor will be persisted across device restarts unless explicitly removed.
+ Adds a world anchor you supply to the set of currently tracked anchors.
+ This anchor will be persisted across device restarts unless explicitly removed.
+
- Parameters:
- world_tracking_provider: The world tracking provider.
- world_anchor: The world anchor to add.
@@ -443,8 +446,10 @@
ar_error_t _Nullable error) AR_REFINED_FOR_SWIFT;
/**
- Add a world anchor to the world tracking provider. This anchor will be persisted across device restarts unless explicitly removed.
+ Adds a world anchor you supply to the set of currently tracked anchors.
+ This anchor will be persisted across device restarts unless explicitly removed.
+
- Parameters:
- world_tracking_provider: The world tracking provider.
- world_anchor: The world anchor to add.
@@ -462,7 +467,7 @@
#ifdef __BLOCKS__
/**
- A handler that the provider calls when a request to remove a world anchor has completed (successfully or not).
+ A handler to call upon completion of a request to remove a world anchor.
- Parameters:
- world_anchor: The world anchor to be removed from the world tracking provider.
@@ -476,7 +481,7 @@
ar_error_t _Nullable error) AR_REFINED_FOR_SWIFT;
/**
- Remove a world anchor from the world tracking provider.
+ Removes a world anchor from a world tracking provider.
- Parameters:
- world_tracking_provider: The world tracking provider.
@@ -492,7 +497,7 @@
ar_world_tracking_remove_anchor_completion_handler_t remove_anchor_completion_handler) AR_REFINED_FOR_SWIFT;
/**
- Remove a world anchor from the world tracking provider using its identifier.
+ Removes a world anchor from a world tracking provider using its identifier.
- Parameters:
- world_tracking_provider: The world tracking provider.
@@ -525,7 +530,7 @@
ar_error_t _Nullable error) AR_REFINED_FOR_SWIFT;
/**
- Remove a world anchor from the world tracking provider.
+ Removes a world anchor from a world tracking provider.
- Parameters:
- world_tracking_provider: The world tracking provider.
@@ -543,7 +548,7 @@
ar_world_tracking_remove_anchor_completion_handler_function_t remove_anchor_completion_handler_function) AR_REFINED_FOR_SWIFT;
/**
- Remove a world anchor from the world tracking provider using its identifier.
+ Removes a world anchor from a world tracking provider using its identifier.
- Parameters:
- world_tracking_provider: The world tracking provider.
@@ -733,22 +738,22 @@
*/
API_AVAILABLE(visionos(1.0), macos(26.0), macCatalyst(26.0))
OS_ENUM(ar_device_anchor_query_status, intptr_t,
- // The device anchor at the specified timestamp was successfully obtained.
+ /** The device anchor query succeeded. */
ar_device_anchor_query_status_success = 0,
- // The device anchor at the specified timestamp failed to be obtained.
+ /** The device anchor query failed. */
ar_device_anchor_query_status_failure)
AR_REFINED_FOR_SWIFT;
/**
- Tracking states of a device anchor.
+ Values that describe the tracking states of a device anchor.
*/
API_AVAILABLE(visionos(2.0), macos(26.0), macCatalyst(26.0))
OS_ENUM(ar_device_anchor_tracking_state, intptr_t,
- // The anchor is not tracked.
+ /** The value that indicates the framework isn't tracking the anchor. */
ar_device_anchor_tracking_state_untracked = 0,
- // Only orientation is currently tracked.
+ /** The value that indicates that the framework is only currently tracking orientation. */
ar_device_anchor_tracking_state_orientation_tracked,
- // Both position and orientation are currently tracked.
+ /** The value that indicates that the framework is currently tracking both position and orientation. */
ar_device_anchor_tracking_state_tracked)
AR_REFINED_FOR_SWIFT;
@@ -818,11 +823,11 @@
AR_EXTERN bool ar_device_anchor_is_tracked(ar_device_anchor_t anchor) AR_REFINED_FOR_SWIFT;
/**
- Get the tracking state of the device anchor.
+ Gets the tracking state of the device anchor.
- Parameter anchor: The anchor.
- - Returns: Tracking state of this anchor.
+ - Returns: The tracking state of this anchor.
*/
API_AVAILABLE(visionos(2.0), macos(26.0), macCatalyst(26.0))
@@ -831,7 +836,7 @@
#pragma mark - World Tracking Prediction
/**
- Query a device anchor at the given timestamp.
+ Queries the predicted pose of the current device at a given time.
The origin is a right-handed coordinate system and is defined such that X points to the right, Y points up, and Z points backward.
@@ -858,7 +863,7 @@
ar_device_anchor_t device_anchor) AR_REFINED_FOR_SWIFT AR_MT_UNSAFE;
/**
- Get the authorization type required by the world tracking provider.
+ Gets the types of authorizations required to track world anchors.
- Returns: The required authorization type.
*/