Use reference image libraries with AssetBundles
Understand how to package a reference image library into an AssetBundle.
To include a reference image library in an AssetBundle, AR Foundation requires that you first call ARBuildProcessor.PreprocessBuild before you build AssetBundles. Platform-specific data is attached to XRReferenceImageLibrary
assets during this preprocessor step.
Refer to the following sample code to understand how to build AssetBundles that contain reference image libraries:
static void ExportAssetBundles(string directoryPath, BuildTarget buildTarget)
{
UnityEditor.XR.ARSubsystems.ARBuildProcessor.PreprocessBuild(buildTarget);
BuildPipeline.BuildAssetBundles(
directoryPath,
BuildAssetBundleOptions.ForceRebuildAssetBundle,
buildTarget);
}
Build AssetBundles window
Alternatively, you can use the Build AssetBundles window, located at Assets > AR Foundation > Build AssetBundles, to export your AssetBundles to the chosen directory.
Build AssetBundles window.
The following table describes the fields in the Build AssetBundles window:
Element | Description |
---|---|
Build for Target | Specifies the target platform for the AssetBundles. |
Output Directory | The directory in which to save the built AssetBundles. You can either type this into the text field or click the folder icon to open a file picker. |
Clean Output Directory | If enabled, all files in the output directory will be deleted before the AssetBundles are built. |
Build AssetBundles | Build the AssetBundles to the chosen directory. |