Table of Contents

Workflow_ARSession 範例詳解

Workflow_ARSession 是一個輕量級的 AR 會話管理範例，旨在展示如何以最小依賴構建一個完整的 AR 應用流程。該範例同時支援 AR Foundation 相容模式 和 簡易模式 ，您可以根據專案需求靈活選擇。

使用方法

場景選擇（二選一）

在 Unity 編輯器中，Workflow_ARSession 場景包含兩組互斥的配置根物件，請僅啟用其中一組（確保另一組處於非啟動狀態）：

配置名稱 適用場景 依賴
ARFoundationCompatibleSceneSetup 已使用或計劃整合 AR Foundation 的專案 需完成 AR Foundation 配置
SimpleSceneSetup 不依賴 AR Foundation，直接使用 EasyAR 原生能力 無額外依賴，適合輕量級 AR 應用

構建與執行

  1. 將 Workflow_ARSession 新增至選單欄 File > Build Settings 或 Build Profiles > Scene List 中。
  2. 根據所選目標平台（如 Android 或 iOS），在 Project Settings > Player 中確認構建選項。
  3. 構建到真機並執行。

應用啟動後，將自動初始化攝影鏡頭並等待識別目標。

識別目標與取得方法

本範例預設演示 影像識別（Image Tracking） 功能，但其架構可輕鬆擴充至物體追蹤、雲端識別等其他模式。

預設目標：namecard.jpg

  • 目標類型：2D 影像（建議列印尺寸 ≥ 90mm × 54mm）
  • 下載網址：🔗 namecard
    namecard

如何替換目標？

  1. 將您的影像（JPG/PNG）放入 Assets/Samples/EasyAR Sense Unity Plugin/[版本號]/__All Samples__/Workflow/Workflow_ARSession/Targets。
  2. 選擇場景中的 ImageTarget-namecard 元件，在 Inspector 的 Image Target Controller (Script) 中變更 Texture 為您的影像。
  3. 修改 Name 和 Scale。 Scale 是您目標的實體尺寸（單位：公尺），以影像的長邊為準。
    Replace Image Target
  4. 儲存並重新構建。

預期效果

當攝影鏡頭對準目標影像時，系統將：

  1. 即時偵測並追蹤影像；
  2. 在影像平面上疊加一個 3D 熊貓；

熊貓的位置、朝向與縮放嚴格繫結於影像目標的位姿，即使影像運動、部分遮擋或光照變化，仍能穩定追蹤。

擴充建議

  • 新增物體追蹤：替換 ImageTracker 為 ObjectTracker，載入 .obj 模型檔；
  • 接入雲端識別：使用 CloudRecognizer 替代本地目標清單；
  • 多目標支援：從單個影像目標擴充為多個影像，系統將自動處理併發追蹤。
提示

更多功能元件請 造訪AR功能元件。

透過 Workflow_ARSession，您可快速掌握 EasyAR 的核心工作流，並以此為基礎構建生產級 AR 應用。