# unity-technologies/arfoundation-samples architecture

> Architecture diagram of the GitHub repository unity-technologies/arfoundation-samples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/unity-technologies/arfoundation-samples
- Repository: https://github.com/unity-technologies/arfoundation-samples

## Overview

##### Project type and purpose
- This is an open-source Unity sample application (“AR Foundation Samples”) that demonstrates AR Foundation 6.0 features across multiple AR scenarios (plane detection, image/object/face/body tracking, meshing, occlusion, environment probes, multi-device collaboration, etc.).
- It is not a classic client–server or full-stack web app; it is a single-player AR demo built on top of Unity’s engine, AR Foundation package, and platform-specific XR plug-ins.

##### File structure
- Top level:
- Assets/ – All Unity assets (Scenes, Scripts, Prefabs, Materials, Shaders, Fonts, etc.)
- Packages/ – package manifest declaring dependencies: AR Foundation, ARCore, ARKit, OpenXR, URP, TextMeshPro
- ProjectSettings/ – Unity project configuration (graphics, input, XR settings, URP settings)
- .github/, LICENSE.md, CONTRIBUTING.md – repo meta, CI/issue templates
- Under Assets/:
- Scenes/ – dozens of minimal sample scenes for each AR feature
- Scripts/Runtime/ – C# MonoBehaviours using AR Foundation APIs (ARPlaneManager, ARRaycastManager, ARImageTrackingManager, ARFaceManager, ARMeshManager, AROcclusionManager, AREnvironmentProbeManager, Multipeer connectivity code, etc.)
- Scripts/Editor/ – custom inspectors and asset editors for event assets, UI
- Prefabs/, Materials/, Shaders/, Fonts/, InputActions/, etc. – reusable assets referenced by scenes and scripts
- Settings/ – build profiles (Meta Quest, Visual Scripting)
- Samples/ – sample content for XR Interaction Toolkit
- Key config files:
- Packages/manifest.json – declares AR Foundation & XR plug-in dependencies
- ProjectSettings/XRSettings.asset – XR Loader configuration (ARKitLoader, ARCoreLoader, OpenXRLoader, SimulationLoader)
- URP assets – Universal Render Pipeline settings and renderers

##### README for additional insights
- Confirms AR Foundation 6.0 usage, Unity 2023.2+ compatibility
- Lists supported packages (AR Foundation, ARCore XR, ARKit XR, OpenXR)
- Describes each sample scene’s purpose and the associated key scripts

##### Be very detailed
- Essential Managers in ARFoundation, key XR Subsystem names, and the Loader/Plug-in mapping
- Separate runtime vs. editor components for clarity
- Don’t overthink: break the project into its main functional slices (Scenes/UI → ARFoundation → XR Subsystem → Plug-in → Native SDK → Hardware)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer - Unity
    subgraph "Presentation Layer"
        direction TB
        Scenes["Scenes\n(Assets/Scenes/)"]:::unity
        Prefabs["Prefabs\n(Assets/Prefabs/)"]:::unity
    end

    %% AR Foundation Layer
    subgraph "AR Foundation Layer"
        direction TB
        ARSession["ARSession"]:::foundation
        ARSessionOrigin["ARSessionOrigin"]:::foundation
        ARManagers["AR Managers\n(Plane, Raycast, Anchor,\nPointCloud, Mesh, Occlusion,\nEnvProbe, TrackedImage,\nTrackedObject, Face, Body, Participant)"]:::foundation
        ARAnchorVis["ARAnchorDebugVisualizer"]:::foundation
        ARPlaneVis["ARPlaneDebugVisualizer"]:::foundation
        ARPlaceObj["ARPlaceObject"]:::foundation
    end

    %% XR Subsystem Interface
    subgraph "XR Subsystem Interface"
        direction TB
        SubsystemIF["XR Subsystem Interfaces\n(Session, Plane, Raycast,\nAnchor, PointCloud, Mesh,\nEnvironmentProbe, Occlusion,\nImageTracking, ObjectTracking,\nFace, HumanBody, Participant)"]:::subsystem
        SubsystemsUtil["SubsystemsUtility.cs"]:::subsystem
        OpenXRUtil["OpenXRUtility.cs"]:::subsystem
        XRManagerUtil["XRManagerUtility.cs"]:::subsystem
    end

    %% XR Loader & Plugins
    subgraph "XR Loader & Plugins"
        direction TB
        ARCoreLoader["AR Core Loader"]:::loader
        ARKitLoader["AR Kit Loader"]:::loader
        OpenXRLoader["Open XR Loader"]:::loader
        SimulationLoader["Simulation Loader"]:::loader
        ARCoreLoaderSettings["AR Core Loader Settings"]:::loader
        ARKitLoaderSettings["AR Kit Loader Settings"]:::loader
        OpenXREditorSettings["OpenXR Editor Settings"]:::loader
        XRSettingsAsset["XRSettings.asset"]:::loader
    end

    %% Native Platform APIs
    subgraph "Native Platform APIs"
        direction TB
        GeoInterop["GeoAnchorsNativeInterop.m"]:::native
        MultiBridge["MultipeerDelegate-C-Bridge.m"]:::native
        MultiHeader["MultipeerDelegate.h"]:::native
    end

    %% Render Pipeline & Graphics
    subgraph "Render Pipeline & Graphics"
        direction TB
        URPAsset["URP Render Pipeline Asset"]:::render
        URPRenderer["URP Renderer Asset"]:::render
        Shaders["Shaders\n(Assets/Shaders/)"]:::render
    end

    %% Data Flow
    Scenes -->|instantiates| ARSession
    Prefabs -->|used in| ARSessionOrigin
    ARSession --> ARManagers
    ARSessionOrigin --> ARManagers
    ARManagers --> ARAnchorVis
    ARManagers --> ARPlaneVis
    ARManagers --> ARPlaceObj
    ARManagers --> SubsystemIF
    SubsystemIF --> SubsystemsUtil
    SubsystemIF --> OpenXRUtil
    SubsystemIF --> XRManagerUtil
    SubsystemIF --> ARCoreLoader
    SubsystemIF --> ARKitLoader
    SubsystemIF --> OpenXRLoader
    SubsystemIF --> SimulationLoader
    ARCoreLoader --> ARCoreLoaderSettings
    ARKitLoader --> ARKitLoaderSettings
    OpenXRLoader --> OpenXREditorSettings
    SimulationLoader --> XRSettingsAsset
    ARCoreLoader -->|calls native| GeoInterop
    ARKitLoader -->|calls native| GeoInterop
    OpenXRLoader -->|calls native| MultiBridge
    SimulationLoader -->|calls native| MultiHeader
    GeoInterop -->|interfaces| Hardware
    MultiBridge -->|interfaces| Hardware
    MultiHeader -->|interfaces| Hardware
    ARManagers --> URPAsset
    ARManagers --> URPRenderer
    ARManagers --> Shaders

    %% Click Events
    click Scenes "https://github.com/unity-technologies/arfoundation-samples/tree/main/Assets/Scenes/"
    click Prefabs "https://github.com/unity-technologies/arfoundation-samples/tree/main/Assets/Prefabs/"
    click ARAnchorVis "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scripts/Runtime/ARAnchorDebugVisualizer.cs"
    click ARPlaneVis "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scripts/Runtime/ARPlaneDebugVisualizer.cs"
    click ARPlaceObj "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scripts/Runtime/ARPlaceObject.cs"
    click SubsystemsUtil "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scripts/Runtime/Util/SubsystemsUtility.cs"
    click OpenXRUtil "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scripts/Runtime/Util/OpenXRUtility.cs"
    click XRManagerUtil "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scripts/Runtime/Util/XRManagerUtility.cs"
    click ARCoreLoader "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/XR/Loaders/AR Core Loader.asset"
    click ARKitLoader "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/XR/Loaders/AR Kit Loader.asset"
    click OpenXRLoader "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/XR/Loaders/Open XR Loader.asset"
    click SimulationLoader "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/XR/Loaders/Simulation Loader.asset"
    click ARCoreLoaderSettings "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/XR/Settings/AR Core Loader Settings.asset"
    click ARKitLoaderSettings "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/XR/Settings/AR Kit Loader Settings.asset"
    click OpenXREditorSettings "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/XR/Settings/OpenXR Editor Settings.asset"
    click XRSettingsAsset "https://github.com/unity-technologies/arfoundation-samples/blob/main/ProjectSettings/XRSettings.asset"
    click GeoInterop "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scenes/ARKit/ARKitGeoAnchors/GeoAnchorsNativeInterop.m"
    click MultiBridge "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scripts/Runtime/Multipeer/NativeCode/MultipeerDelegate-C-Bridge.m"
    click MultiHeader "https://github.com/unity-technologies/arfoundation-samples/blob/main/Assets/Scripts/Runtime/Multipeer/NativeCode/MultipeerDelegate.h"

    %% Styles
    classDef unity fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef foundation fill:#ccffcc,stroke:#333,stroke-width:1px
    classDef subsystem fill:#ffe5b4,stroke:#333,stroke-width:1px
    classDef loader fill:#ffcccc,stroke:#333,stroke-width:1px
    classDef native fill:#e0e0e0,stroke:#333,stroke-width:1px
    classDef render fill:#f2f2f2,stroke:#333,stroke-width:1px
```
