Example projects that use *AR Foundation 2.2* and demonstrate its functionality with sample assets and components.
Example projects that use *AR Foundation 3.0* and demonstrate its functionality with sample assets and components.
This set of samples relies on four Unity packages:
This set of samples relies on five Unity packages:
* ARKit Face Tracking
The `master` branch is compatible with Unity 2019.1 and later. For 2018.4, see the [1.5-preview branch](https://github.com/Unity-Technologies/arfoundation-samples/tree/1.5-preview). ARFoundation 1.5 is functionality equivalent to 2.2. The only difference is the version of Unity on which it depends.
## :warning: ARKit 3 Support
**TL;DR:** If you want to checkout the latest and greatest features in ARKit 3, use this `master` branch, Xcode 11 beta 5, and a device running iOS 13 beta. Otherwise, see the [2.1 branch](https://github.com/Unity-Technologies/arfoundation-samples/tree/2.1), which only lacks support for the new ARKit 3 features.
The `master` branch includes support for ARKit 3, which is still in beta and requires Xcode 11 beta 5 and iOS 13 beta 5.
The [2.1 branch](https://github.com/Unity-Technologies/arfoundation-samples/tree/2.1) is compatible with Xcode 9 and 10 and only lacks the new ARKit 3 features.
ARFoundation 2.2 provides interfaces for ARKit 3 features, but only Unity's ARKit XR Plugin 2.2 package contains _support_ for these features and _requires_ Xcode 11 beta 5 and iOS 13 beta 5. Unity's ARKit XR Plugin 2.2 is not backwards compatible with previous versions of Xcode or iOS. Unity's ARKit XR Plugin 2.1 will work with the latest ARFoundation (it just doesn't implement the ARKit 3 features).
While Xcode 11 & iOS 13 are in beta, we will continue to maintain *both* the 2.2 and 2.1 versions of the packages.
The same is also true for Unity's ARKit Face Tracking package 1.1: it _requires_ Xcode 11 beta 5 and iOS 13 beta 5.
The `master` branch is compatible with Unity 2019.2 and later. For 2018.4, see the [1.5-preview branch](https://github.com/Unity-Technologies/arfoundation-samples/tree/1.5-preview). ARFoundation 1.5 is functionality equivalent to 2.2. The only difference is the version of Unity on which it depends.
This table shows the latest version of Unity's ARKit XR Plugin and its Xcode and iOS compatibility:
## ARKit 3 Support
|Unity ARKit XR Plugin|Unity ARKit Face Tracking|Xcode Version|iOS Version|
The ARKit XR Plugin and ARKit Face Tacking packages support both ARKit 2 and ARKit 3 simultaneously. We supply separate libraries and select the appropriate one based on the version of Xcode selected in your Build Settings. This should eliminate the confusion over which package version is compatible with which Xcode version.
This distinciton is temporary. Once iOS 13 is no longer in beta, the ARKit package is expected to work with all versions of Xcode 9+ and iOS 11+.
The ARKit 3 features require Xcode 11 beta 7 and iOS/iPadOS 13.1 beta.
1. Download the latest version of Unity 2019.1 or later.
1. Download the latest version of Unity 2019.2 or later.
2. Open Unity, and load the project at the root of the *arfoundation-samples* repository.
Tim Mowrer
5 年前