# 安裝 Pico VR SDK

:::warning
使用 Pico 3 代的朋友，請使用新版 Pico XR SDK 。
使用此 SDK 也能用，但 XR 才能支援完整功能 (如眼動)。
:::

## 下載 Pico VR SDK
- SDK: https://developer.pico-interactive.com/sdk/index?id=4&device_id=1&platform_id=1 (有 Deprecated 那個)

- Document: http://sdk.picovr.com/docs/sdk/en/chapter_one.html

- github: https://github.com/picoxr/support

## 安裝 Pico VR SDK
- 直接解壓縮點兩下 UnityPackage ，Import 進專案就可以用了

## 建立 Pico Manager Prefab (以下稱 Rig)
- Pico 的 Rig 是 2 個部分組成，視角跟控制器
- 視角 (頭盔) 的在 `PicoMobileSDK/Pvr_UnitySDK/Prefabs/Pvr_UnitySDK`
- 控制器的在 `PicoMobileSDK/Pvr_Controller/Prefabs/ControllerManager`
- 把控制器 prefab 拉到視角 prefab 底下 (如下圖)
- 
- 把控制器的 demo 腳本關掉
- 把場景原有的 Camera 關閉或刪除
- *有關控制器如何與場景互動，請參閱後續章節*

## 替換 Rig
- SteamVR 的 Manager Prefab 叫做 `[CameraRig]`，我們要把它替換成剛剛製作的
- 我這裡的控制器 Prefab 因為是用腳本生成的，所以會寫成這樣
- 

:::warning
**每個會用到的場景都要放上 Rig！**
像是實驗室框架中 Init 的場景原本是沒放 rig 的。
不然在實機上會顯示很多個畫面 / 很多黑條 / 閃來閃去 / 星爆氣流，而且無法繼續執行
:::

## 更改 Project Setting
到 Edit > Project Settings > Player Settings 改一些東西

#### Resolution and Presentation
- Blit Type => `Never`

- Orientation => `Landscape Left`

#### Other Settings
- Graphic API => **不能**含有 `Vulkan`

- Minimum API => `23` ~ `27` 都可 (如果是 XR SDK 需要 26)
- Target API => `27` (或 `Highest Install`，*官方不建議，說網路功能會壞掉*)

## 安裝自訂 Andoid SDK
隨 Unity 安裝的 Android SDK 無法 build 出專案，需要自己指定 Android SDK
這裡提供我 build 成功的版本：https://drive.google.com/file/d/1oSMBSI64a4gxhG-3fulHrsqVmj6FHLXk/view?usp=sharing

*(如果載點失效了可以滑動左邊章節列表到最下面，BOKU NO PICO)*

下載後解壓縮到任意資料夾 **(路徑不要含有中文)**，
打開 Unity 功能列 Edit > Preferences > External Tools 取消勾選用預設的 Android SDK，並設定你剛剛解壓的位置


## 修改 Android Manifest
:::info
視 SDK 版本而決定要不要修改 (Android SDK 版本>=29 就不需要改)
(如果你用的是我提供的 SDK (版本 28) 就需要改)
:::

修改檔案 `Plugins/Android/AndroidManifest.xml`
把`android:requestLegacyExternalStorage="true"` 這幾個字拿掉

不然會遇到以下錯誤

:::warning
如果你使用 Pico XR SDK，他在 build 的時候會很暴力的強制把 `requestLegacyExternalStorage` 寫上去。
請到 Pico XR 套件的位置找到 `PXR_BuildProcessor`，把這行註解掉

UpdateOrCreateAttributeInTag(manifestDoc, "/manifest","application", "requestLegacyExternalStorage","true");

:::

<!-- 根據 pico VR document：
> Special meta-data needs to be added; otherwise, an exception will be displayed -->

<!--  -->