Table of Contents

使用 AllSamplesLauncher 快速體驗 EasyAR 樣例

AllSamplesLauncher 是一個集成化的示例啓動器，可以幫助您快速熟悉 EasyAR SDK 的各項功能。通過該啓動器，您可以在單個 Unity 工程中一鍵切換並運行所有官方示例場景，無需手動配置多個獨立項目。

準備工作

在開始之前，請確保您已經完成了以下準備工作：

  1. 已安裝 Unity Hub 和 Unity 編輯器
  2. 創建一個新的 Unity 工程
  3. 已導入 EasyAR Sense Unity Plugin 並且導入了所有 Samples

請參考 快速入門 中的介紹按步驟進行操作。

詳細步驟

  1. 打開 Samples 中的所有場景。
    All Sample Scenes
  2. 點擊菜單欄 File > Build Settings 或 Build Profiles > Scene List 。
  3. 將所有場景都拖動到 Scene List 中。
  4. 確保 AllSamplesLauncher 位於所有場景中的第一個。如不是，可以在窗口內拖動。
    Scene List Order
  5. 點擊菜單欄 File > Build And Run 進行打包、運行。
附註

打包到手機運行時，不要添加頭顯類的場景：

  • Combination_BasedOn_AppleVisionPro
  • Combination_BasedOn_Xreal
    Donot Load Headset

打包中遇到問題

在您編譯、打包過程中，可能遇到一些錯誤。常見的問題有：

錯誤信息 原因 解決辦法
FileNotFoundException:EasyAR Settings Asset 未填寫 License 點擊菜單欄 EasyAR > Sense > Configuration，在 EasyAR Sense License 中填入您的 License Key
Missing Prefab Asset: 'XR Interaction Setup' 頭顯相關文件缺失 打包場景列表中刪除頭顯相關場景。如果您確認需要打包頭顯，請按照 使用頭顯樣例 中的步驟進行

啓動器使用

運行後，您將看到一個簡潔的啓動器界面。

Lanucher Homepage

點擊界面底部中間的 Samples 按鈕，即可進入所有功能的樣例。

Lanucher Samplepage

在界面左側是功能分類，右側則是每個功能下的場景樣例列表。點擊不同的樣例場景，即可體驗 EasyAR 提供的所有不同功能。

同時，在界面的底部還提供了 EasyAR Sense 和 EasyAR Mega 的功能演示視頻，可以幫助您更好的理解 EasyAR 能爲您提供怎樣的功能和效果。

運行樣例前的必讀事項

在運行特定樣例之前，您必須完成以下關鍵配置，否則樣例將無法正常工作：

  1. 設置您的 API Key

    • 部分樣例（特別是涉及雲識別、Mega 雲定位等）需要有效的 API Key。
    • 在菜單欄 EasyAR > Sense > Configuration 中，找到對應樣例需要填寫的地方。
    • 從中填入您從 EasyAR 開發者中心申請到的 App ID、 API Key、 API Secret。
      Key Configuration
    • 重要提示：如果您還沒有 API Key，部分本地功能的樣例（如圖片跟蹤）可能仍能運行，但云功能會失敗。請務必前往 EasyAR 開發者中心 創建應用並獲取 Key。

  2. 配置 XR/平臺支持：

    • 如果您運行的是 頭顯相關 的樣例，您參照 使用頭顯樣例 中的進行。
    • 請確保您的設備（如手機或頭顯）已正確連接並處於開發者模式。

深入探索樣例

示例啓動器是您學習的最佳起點。我們強烈建議您：

  • 先運行，再研究：通過啓動器快速體驗每個樣例的效果，對 EasyAR 的能力建立直觀印象。
  • 打開場景源文件：每個樣例都是一個獨立的 Unity 場景文件，位於 Assets/Samples/EasyAR Sense Unity Plugin/[版本號]/__All Samples__/[功能名稱]/[樣例名稱]/Scenes 目錄下。
  • 研究並閱讀腳本代碼：在樣例場景中，可以打開樣例附帶的 *.cs 腳本，查看我們是如何調用 EasyAR API 來實現特定功能的。這是學習 API 使用方法的最佳途徑。

通過示例啓動器，您可以快速建立對 EasyAR SDK 的功能認知。祝您探索愉快！