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 的功能認知。祝您探索愉快！