# Getting start with AR foundation in Unity
###### tags: `Unity` `Software`

## AR foundation是什麼？
AR foundation是Unity遊戲引擎中開發AR (Augmented Reality)擴增實境的插件，它整合了開發Android應用程式的ARCore和開發IOS應用程式的ARKit。

更多說明：[Unity Manual - About AR Foundation](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.2/manual/index.html)

## 系統要求
AR foundation系統要求：

### Android
#### 硬體
* 一個能支援ARCORE的Android設備或模擬器
* 將Android設備連接到開發機器(電腦)的USB傳輸線
#### 軟體
* Unity 2019.4.3f1以上版本
* [Android Build Support](https://docs.unity3d.com/Manual/GettingStartedAddingEditorComponents.html) (於安裝Unity選擇之Modules)

### iOS
#### 硬體
* 一個能支援ARCORE的iOS設備或模擬器
* 將iOS設備連接到開發機器(電腦)的USB傳輸線
#### 軟體
* Unity 2019.4.3f1以上版本
* [iOS Build Support](https://docs.unity3d.com/Manual/GettingStartedAddingEditorComponents.html) (於安裝Unity選擇之Modules)
* [Xcode 11.0以上版本](https://developer.apple.com/xcode/)

更多說明：[Google ARCore - AR Foundation 入門](https://developers.google.com/ar/develop/unity-arf/getting-started-ar-foundation)

## 操作版本
不同版本Unity的環境建置操作略有不同，本Documentation所操作的軟體版本為下列：
* Unity 2020.3.27f1
* AR foundation 4.1.9
* ARCore XR Plugin 4.1.9

## 安裝Unity
安裝並開啟[Unity Hub](https://unity3d.com/get-unity/download)，於Install選單中，點選右上方"ADD" button，並選擇所要之Unity版本並安裝。

於彈出之"Add Moduales"視窗中，選擇所要匯出及運行之設備系統：Android設備選擇Android Build Support (包含Android SDK & NDK和Open JDK)；iOS設備選擇iOS Build Support，選擇完畢後按"Done"，這些Modules (Android Build Support, iOS Build Support...)便會與Unity一同安裝。


安裝完畢後想要更動Modules，只要於Unity Hub > Installs的Unity版本右上方選單 (三個點)選擇Add Modules便可修改。


## Android系統開發設定
開發Andriod系統應用程式，必須使用Windows作業系統開發。

### 1. Package Manager
於Package Manager安裝AR foundation及開發特定Platform (Android, iOS, ...)的插件包。

路徑：Windows > Package Manager > Unity Registry

本次操作包含以下：
* AR foundation 4.1.9
* ARCore XR Plugin 4.1.9


### 2. Project Setting
於Project Settings的XR Plug-in Management視窗中，勾選Plug-in Providers中"ARCore"來啟用剛剛安裝之ARCore插件。

路徑：Edit > Project Settings > XR Plug-in Management


### 3. Build Setting
於Build Settings視窗中，切換至"Android" (於Platform中選擇Android，並點選"Switch Platform" button)，無須修改其設定。

路徑：File > Build Settings


### 4. Player Setting
於Player Settings視窗中，設定匯出程式安裝包的設定。

路徑：File > Build Settings > Player Settings > Other Settings (或Edit > Project Settings > Player)

於Other Settings中設定以下幾個項目：

**Package Name**
Create a unique app ID using a Java package name format.
For example, use com.example.helloAR.
* Company Name
* Product Name

**Rendering**
* 取消勾選Auto Graphics API
* 取消Vulkan被列在Graphics APIs中
* 取消勾選Multithreaded Rendering

**Minimum API Level**
* 如果是開發 [AR Required](https://developers.google.com/ar/develop/unity-arf/enable-arcore) app，選擇 *Android 7.0 'Nougat' (API Level 24)* 或更新之版本
* 如果是開發 [AR Optional](https://developers.google.com/ar/develop/unity-arf/enable-arcore) app，選擇 *Android API Level 14* 或更新之版本

**Scripting Backend**
* 選擇IL2CPP
* 不是Mono

**Target Architectures**
* 選擇ARM64 （支援64位ARM）
* 不是ARMv7 （支援32位ARM）



**Youtube References**
[AR in Unity [02] - Install and Setup AR Foundation](https://www.youtube.com/watch?v=Wefzs2kgUVA)
[AR Foundation & Unity 01: Setup for Android](https://www.youtube.com/watch?v=0mpsiO2lCx0&t=2s)

## iOS系統開發設定
開發iOS系統應用程式，必須使用Mac OS作業系統開發。雖然有方法可以用Windows開發，但容易會出現問題，不建議使用Windows開發iOS系統應用程式。

Under construction...

**Youtube References**
[AR Foundation & Unity 02: Setup for iOS](https://www.youtube.com/watch?v=eu_eG0eTFlA&list=PL6VJLOFcTt7awvyIGIbLLPOBrW6-Y1R-J&index=2)

## AR 基本設置
刪除預設之Main Camera，並於Hierarchy底下之XR選項中新增"AR Session Origin"和"AR Session"。


在AR Session Origin中有一AR Camera，並於其Tag中設定它為MainCamera，之後在AR Camera的範圍中放置物件即可。