{"id":13731263,"url":"https://github.com/CandyCoded/ARFoundation-Components","last_synced_at":"2025-05-08T04:32:21.716Z","repository":{"id":57402615,"uuid":"146667678","full_name":"CandyCoded/ARFoundation-Components","owner":"CandyCoded","description":"📱 Generic components for use with Unity's AR Foundation package","archived":false,"fork":false,"pushed_at":"2024-04-09T04:37:03.000Z","size":584,"stargazers_count":50,"open_issues_count":0,"forks_count":10,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-25T20:04:26.066Z","etag":null,"topics":["arcore","arfoundation-components","arkit","csharp","ios","unity"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CandyCoded.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2018-08-29T22:54:33.000Z","updated_at":"2025-03-12T13:56:45.000Z","dependencies_parsed_at":"2024-01-12T03:35:45.407Z","dependency_job_id":"17d938d2-9ce1-4845-99fd-68bb7ae1a4b1","html_url":"https://github.com/CandyCoded/ARFoundation-Components","commit_stats":{"total_commits":209,"total_committers":1,"mean_commits":209.0,"dds":0.0,"last_synced_commit":"5ae6443e6a83678615597c950c69d18d67b2e814"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CandyCoded%2FARFoundation-Components","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CandyCoded%2FARFoundation-Components/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CandyCoded%2FARFoundation-Components/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CandyCoded%2FARFoundation-Components/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CandyCoded","download_url":"https://codeload.github.com/CandyCoded/ARFoundation-Components/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252999816,"owners_count":21838249,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arcore","arfoundation-components","arkit","csharp","ios","unity"],"created_at":"2024-08-03T02:01:26.076Z","updated_at":"2025-05-08T04:32:21.385Z","avatar_url":"https://github.com/CandyCoded.png","language":"C#","readme":"# ARFoundation Components\n\n\u003e 📱 Generic components for use with Unity's AR Foundation package\n\n[![NPM Version](http://img.shields.io/npm/v/xyz.candycoded.arfoundation-components.svg?style=flat)](https://www.npmjs.org/package/xyz.candycoded.arfoundation-components)\n\n## Contents\n\n- Components\n  - Helper Components\n    - [ARLightEstimation](Documentation/ARLightEstimation.md)\n    - [ARPlaceObjectOnPlane](Documentation/ARPlaceObjectOnPlane.md)\n    - [ARShowPlacementMarkerOnPlane](Documentation/ARShowPlacementMarkerOnPlane.md)\n  - Event Components\n    - [ARPlaneEvents](Documentation/ARPlaneEvents.md)\n    - [ARTrackedImageEvents](Documentation/ARTrackedImageEvents.md)\n    - [ARTrackedObjectEvents](Documentation/ARTrackedObjectEvents.md)\n- Extensions\n  - [ARFoundationExtensions](Documentation/ARFoundationExtensions.md)\n    - [CenterOfScreen](Documentation/ARFoundationExtensions.md#centerofscreen)\n    - [RaycastToPlane](Documentation/ARFoundationExtensions.md#raycasttoplane)\n    - [IsLookingAtPlane](Documentation/ARFoundationExtensions.md#islookingatplane)\n    - [HasTouchedPlane](Documentation/ARFoundationExtensions.md#hastouchedplane)\n    - [SetActiveStateOfPlaneVisuals](Documentation/ARFoundationExtensions.md#setactivestateofplanevisuals)\n\n## Installation\n\n\u003chttps://docs.unity3d.com/Packages/com.unity.package-manager-ui@2.0/manual/index.html\u003e\n\n### Unity Package Manager\n\n```json\n{\n  \"dependencies\": {\n    \"xyz.candycoded.arfoundation-components\": \"https://github.com/CandyCoded/ARFoundation-Components.git#v4.0.4\",\n    \"xyz.candycoded.candycoded\": \"https://github.com/CandyCoded/CandyCoded.git#v4.4.1\",\n    ...\n  }\n}\n```\n\n#### Scoped UPM Registry\n\n```json\n{\n  \"dependencies\": {\n    \"xyz.candycoded.arfoundation-components\": \"4.0.4\",\n    \"xyz.candycoded.candycoded\": \"4.4.1\",\n    ...\n  },\n  \"scopedRegistries\": [\n    {\n      \"name\": \"candycoded\",\n      \"url\": \"https://registry.npmjs.com\",\n      \"scopes\": [\"xyz.candycoded\"]\n    }\n  ]\n}\n```\n\n## Setup\n\nSee \u003chttps://github.com/CandyCoded/ARFoundation-Components-Demo\u003e for a working example of the following steps.\n\n### Install Dependencies\n\n1. Install the latest **ARKit XR Plugin**, **ARCore XR Plugin** and **AR Foundation** (preview) packages from the Package Manager.\n2. Install both the **ARFoundation Components** and **CandyCoded** package (see above).\n\n### Setup AR Foundation\n\n1. Create a new **AR Session Origin** gameObject from the **Create Asset / XR** context menu.\n1. Select the **AR Session Origin** gameObject and attach the **AR Raycast Manager** component.\n1. Remove the **Main Camera** gameObject from the hierarchy (as the **AR Session Origin** contains its own camera).\n1. Create a new **AR Session** gameObject from the **Create Asset / XR** context menu.\n1. Create a new **AR Default Plane** gameObject from the **Create Asset / XR** context menu, drag it into the **Asset** panel creating a prefab and then remove it from the hierarchy.\n1. Attach the **AR Plane Manager** component to the **AR Session Origin** gameObject and drag the **AR Default Plane** prefab from the **Assets** panel into the **Plane Prefab** property.\n1. Change the **Detection Flags** to **Horizontal** (or whatever plane type you will target).\n\n### Setup ARFoundation Components\n\n1. Select the **AR Camera** in the **AR Session Origin** gameObject and change the **Light Estimation Mode** on the **AR Camera Manager** component to **AmbientIntensity**.\n1. Select the **Directional Light** gameObject and attach the **AR Light Estimation** component.\n1. Drag the **AR Camera** component into the **Camera Manager** property of the **AR Light Estimation** component.\n1. Attach the **AR Plane Events** and **AR Place Object On Plane** components to the **AR Session Origin** gameObject.\n1. Create a new **Cube** and set the scale to `Vector3(0.1f, 0.1f, 0.1f)`, drag it into the **Asset** panel creating a prefab and then remove it from the hierarchy.\n1. Drag the **Cube** into the **Object to Place** property of the **AR Place Object On Plane** component and enable the option **Place Multiple**.\n1. Create a new event in the **Plane Touched with Touch Position** event section of the **AR Plane Events** component.\n1. Drag the **AR Session Origin** gameObject into the object field of the event.\n1. Select the **ARPlaceObjectOnPlane** \u003e **PlaceObjectOnPlane** dynamic method from the dropdown.\n\n### Setup iOS build\n\n1. Check that the scene is in the **Build Settings** window.\n1. Change the build platform in the **Build Settings** window to **iOS**.\n1. In the **XR Plug-in Managment** panel, make sure to enable the ARKit plug-in providers.\n1. In the **Player Settings** panel, make sure following settings are correct:\n\n| Setting                        | Value                         | Description                                                                              |\n| ------------------------------ | ----------------------------- | ---------------------------------------------------------------------------------------- |\n| **Camera Usage Description**   | `AR BABY` or any other string | This value will display when the dialog asking for camera permission displays on device. |\n| **Target minimum iOS Version** | `11` or higher                | iOS 11 was the first version ARKit was available.                                        |\n| **Architecture**               | `ARM64`                       | The only iOS devices that support ARKit are built on `ARM64` architecture.               |\n\n### Setup Android build\n\nFirst follow: \u003chttps://developers.google.com/ar/develop/unity/android-11-build\u003e\n\n1. Check that the scene is in the **Build Settings** window.\n1. Change the build platform in the **Build Settings** window to **Android**.\n1. In the **XR Plug-in Managment** panel, make sure to enable the ARCore plug-in providers.\n1. In the **Player Settings** panel, make sure following settings are correct:\n\n| Setting               | Value                                           | Description                                                                                                                |\n| --------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| **Graphic APIs**      | `OPENGLs3` and remove `Vulcan`                  | ARCore does not support Vulcan [arcore-android-sdk issue #258](https://github.com/google-ar/arcore-android-sdk/issues/258) |\n| **Minimum API level** | `Android 7.0 'Nugget' (API level 24)` or higher | Android 7 was the first version ARCore was available.                                                                      |\n","funding_links":[],"categories":["C#"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCandyCoded%2FARFoundation-Components","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCandyCoded%2FARFoundation-Components","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCandyCoded%2FARFoundation-Components/lists"}