3.入門
1.入門
本節涵蓋了幾個重要主題，可幫助您加快visionOS 平臺開發速度。在這里，您將找到構建第一個 Unity PolySpatial XR 應用程序的分步指南的鏈接，以及 PolySpatial XR 開發時的一些開發最佳實踐。
2.開發與迭代
有關先決條件、開發、迭代、部署和調試的信息，請參閱開發和迭代。
3.創建新項目
這些指南提供了 VisionOS 入門的分步說明。
- 在從頭開始新的visionOS項目中，您將找到一個分步教程，指導您從頭開始安裝、設置和部署一個簡單的Unity應用程序以定位visionOS和Apple Vision Pro。
- 在從沉浸式應用模板啟動新的visionOS 項目中，您將找到使用沉浸式應用模板設置新項目的分步教程。
- 在示例內容：了解如何使用visionOS 和應用程序示例中，您會發現各種垂直切片演示項目，解釋如何使用PolySpatial 技術進行visionOS 開發。
4.移植現有項目
將現有 Unity 項目移植到 visonOS 時，需要考慮幾個因素。最大的限制是不支持某些核心 Unity 功能，而其他功能則提供減少的功能集。此外，輸入不同，處理能力和支持的組件也會有所不同。有時您必須開發自己的系統來支持您獨特的項目功能并解決這些限制。
您可以找到有關將 VR 體驗移植到 VisionOS 的信息，了解沉浸式應用程序當前支持哪些Unity 功能和組件，或者如何使用項目驗證來獲得有用的編輯器內幫助來移植項目。有關輸入和其他開發主題的更多信息，請查看參考文檔。
3.1 從頭開始創建VisionOS項目
1.有關硬件和 Unity 版本要求的更多信息，請訪問要求
2.確保切換visionOS的構建平臺（實驗）
3.1.1 完全沉浸式虛擬現實
確保您已安裝xr.sdk.visionos軟件包
1）選擇編輯 > 項目設置...
2）打開XR 插件管理器菜單
3）選中視覺操作系統復選框
4）選擇文件 > 構建設置...
>添加場景（SampleScene）
>選擇構建。
您的應用程序將渲染一個完全沉浸式的空間，您應該看到 Unity 天空盒（或您的應用程序）在 Apple Vision Pro 模擬器中運行。
有關更多信息，請參閱完全沉浸式 VR文檔
3.1.2 混合現實和共享空間
確保已安裝com.unity.polyspatial、com.unity.polyspatial.visionos和com.unity.polyspatial.xr軟件包
1.在場景中創建體積相機
a.打開場景工具/XR Building Blocks 菜單，然后單擊體積相機
b.創建一個空游戲對象并添加體積相機組件
2.將體積相機配置為有界或無界模式并調整尺寸
a.尺寸將調整內容的渲染比例
b.對于有界應用程序，請確保某些內容在體積相機的尺寸內可見
3.打開項目設置 > PolySpatial?...
>選中啟用 PolySpatial 運行時框
無界應用程序
對于想要使用 ARKit 功能的無界應用程序，您需要在 XR 插件管理設置中啟用visionOS，并確保您的項目中有AR Foundation 包。對于 ARKit Hands，請確保您的項目中有XR Hands 包。
1.選擇文件 > 構建設置...
>添加場景（SampleScene）
>選擇構建。
對于有界應用程序，您的應用程序可以與共享空間中的其他應用程序一起存在，對于無界應用程序，您的應用程序將是唯一可見的內容。
注意：Apple Vision Pro 模擬器不提供任何 ARKit 數據，因此平面、網格、跟蹤手等將無法工作。
有關更多信息，請參閱PolySpatial MR 應用程序文檔
3.2 示例
Unity 的PolySpatial 示例為 Unity 中的 VisionOS 開發提供了一個起點，該起點圍繞具有有限體積和無限體驗的特定用例。
3.2.1 有界體積樣本
有針對性的輸入 - 氣球畫廊
目標輸入 - 氣球畫廊是一款迷你游戲，演示如何使用間接捏合和直接（戳）輸入來定位有界體積場景中的內容。
3.2.1.1 動態體積相機 - 角色跑步者
動態體積相機- 角色跑者是一款迷你游戲，演示了在有界體積中動態重新定位體積相機的能力。奔跑者迷你游戲會跟隨角色在一個大于有限體積范圍的環境中導航。
?
3.2.1.2 調試界面
Debug UI場景允許用戶測試各種輸入類型；直接（戳）、直接捏、間接捏以及使用調試 UI分析數據。?
?
3.2.1.3 操縱
操縱場景允許用戶在有界體積內操縱具有不同碰撞器形狀的各種對象。
?
3.2.1.4 用戶界面
UI場景為用戶提供了有界應用程序中使用的常見空間 UI 的示例。這包括按鈕、滑塊、切換按鈕和下拉菜單等元素。
3.2.1.5 項目啟動器
項目啟動器場景允許用戶使用輪播風格的空間 UI 從有限體積啟動各種 Unity 場景。
?
3.2.2無限樣本
3.2.2.1 圖像追蹤
圖像跟蹤場景允許用戶在無限制的應用程序中使用預定義的、唯一的圖像標記生成內容。
3.2.2.2 混合現實
混合現實場景允許用戶在無限制的應用程序中使用自定義 ARKit 手勢生成內容。它還可視化物理環境中的平面數據信息** **。
