¶ 說明
Updated: 2026-05-06
- SDK 版本 1.3.0
- Unity 版本 2021.3 ↑
此 SDK 尚處於開發階段，功能可能尚未完全穩定。
如在使用過程中有遇到任何問題，請與我們聯絡 dev@ewova.com。
我們會盡快解決！
¶ 網頁後台 申請新專案
¶ 填寫您應用程式的資訊
使用 EWova 帳號 建立應用程式專案
需要 組織管理員 與我們聯絡取得 組織開發者權限
並申請新專案來進行下一步
填寫基本資料
完成填寫
¶ 網頁後台 建立使用者紀錄模板
請注意！
當你的樣板完成並釋出應用程式後，若已有使用者產生了紀錄後，就請勿再次編輯樣板。
若編輯已釋出的樣板，可能導致登入時，讀取現有紀錄發生欄位存取錯誤。
若確實有必要進行修改，請參考 刪除使用者紀錄 將錯誤紀錄刪除
¶ 樣板 - 學習進度
創建一個節點 節點 ID 命名為 start
這是由基礎節點 clear 延伸出的節點
所以該完整路徑為 clear/start
我們未來會透過路徑來標記該節點完成
完成節點編輯
¶ 樣板 - 詳細資料
接下來我們開始編輯詳細資料的需要欄位
總覽頁面的欄位、各個頁面名稱與其關卡欄位
¶ 編輯完成
¶ 檢視使用者紀錄
你可以在 後台 > 歷程記錄 找到自己的專案
點擊後就會看到資料了
¶ 使用者紀錄 匯出資料 Excel
點擊 詳細資料
右下角 資料匯出
就可以取得到資料了
可以透過 組織成員歷程記錄 來 批量匯出 您組織的成員資料
¶ 刪除使用者紀錄
組織管理員 可以在 後台 > 歷程記錄 將指定使用者的紀錄刪除
若你 已釋出了應用程式 或 在開發階段中 修改了樣板後遇到了登入的存取錯誤
你可以透過刪除使用者紀錄後再次登入即可
¶ Unity 專案設定
¶ Package Manager
¶ 安裝 Package Newtonsoft Json
Install package by namecom.unity.nuget.newtonsoft-json
¶ 安裝 Package UniTask
Install package from git URLhttps://github.com/Cysharp/UniTask.git?path=src/UniTask/Assets/Plugins/UniTask- ⚠️ 若出現錯誤請參考 [錯誤排除]
¶ 錯誤排除
- 如果透過
Install package from git URL安裝後出現了以下錯誤訊息[Package Manager Window] Error adding package: No 'git' executable was found. Please install Git on your system then restart Unity and Unity Hub - 請先到 [ git 官方網站 ] 中安裝對應你的系統的 git
- 重新開機再次重新安裝一次
¶ 匯入 TextMeshPro 素材
Windows > TextMeshPro > Import TMP Essential Resources
¶ 安裝 學習歷程 UnitySDK
- 複製
API KEY( 先不用下載 SDK )
- 從
PackageManager中安裝 SDK- 此步驟需要安裝「兩」個套件 (v1.3版本變更)
- 1️⃣
Install package from git URL- 輸入安裝核心套件
https://github.com/EWova/UnityPackageCore.git?path=Assets/EWova.Core
- 輸入安裝核心套件
- 2️⃣ 等待安裝完畢後
Install package from git URL- 輸入安裝學習歷程套件
https://github.com/EWova/LearningPortfolioSDK.git?path=Assets/EWova.LearningPortfolioSDK
- 輸入安裝學習歷程套件
- 隨後到
Samples頁籤中匯入BasicAssets
- 找到
Assets/Samples/EWova.LearningPortfolioSDK/{version}/BasicAssets/
- 塞入
API Key後嘗試驗證看看是不是正確的專案
¶ Deeplink
SDK 已內建 Deeplink 功能，
您可以透過修改設定來客製化專屬的 Deeplink 連結。
Windows 必須由使用者先執行過一次，跳轉功能才會正確註冊到系統中。
若使用者從未啟動過，Deeplink 開啟應用程式也不會有回應。
目前「跳轉自動登入」僅限 Android 版本可使用，Windows 尚未支援此功能。
-
設定 .NET Framework ( 僅 Windows 平台必須使用 Framework 其他平台可保留使用 Standard )
Project Settings > Player > Other Settings- 將
Api Compatibility Level設定為.NET Framework
-
接下來找到
[Menu]/EWova/Deeplink/Create Config
-
並輸入你的 MyAppScheme 欄位
Scheme 只能包含 小寫英文字母 和 數字，且不能以數字開頭
不要用 特殊符號 或 大寫字母
-
之後就可以用
elementlabvr://URL Protocol 來啟動應用程式
¶ EWova 空間展示
為了搭配 EWova 世界，讓使用者能從直接跳轉並登入到學習歷程
你需要在回到專案設定中設定你的 Deeplink 網址
只要設定好課程教材顯示
就可以在元宇宙空間中看到你的專案與遊玩排行榜！
¶ Unity 使用 Template 測試登入
你已經可以嘗試使用自己的 EWova 帳號來登入了！
| 學習進度 | 詳細資料 |
|---|---|
 |
 |
登入後就會自動產生使用者紀錄報表
- 後台 可以透過 檢視使用者紀錄 檢視
- Unity 可以透過 Unity 創建學習歷程檢視器 檢視
¶ 登入的例外錯誤處理
¶ 讀取/寫入欄位錯誤
若你 已釋出了應用程式 或 在開發階段中 修改了樣板後遇到了存取錯誤
你可以透過刪除使用者紀錄後再次登入即可
請參考 刪除使用者紀錄 將錯誤紀錄刪除
¶ Unity C# 程式撰寫範例
¶ 參考範本宣告 C# Scheme
¶ 進度節點
¶ 詳細資料
¶ 創建 SheetManager 上傳管理器
- 先將登入介面
Packages/EWova.LearningPortfolioSDK/Runtime/Resources/EWova/LearningPortfolio/EWovaLoginPlane放到你的場景中用於登入
- 建立腳本
- 將 SheetManager 並撰寫為單例模式
接下來會依序介紹如何修改
- A. 進度節點
- B. 總覽頁資料
- C. 個別關卡頁資料
¶ A. 修改 進度節點
¶ 創建範例腳本 ModifyProgressNode 來驗證
- 登入 EWova 介面
- 右鍵腳本 驗證 [1.確定該進度是否完成] 是否為
false
- 右鍵腳本 將該進度 [2. 標記該進度為完成] 再次驗證該進度是否已標記為
true
¶ B. 修改 總覽頁資料
¶ 創建範例腳本 ModifyOverviewPage 來驗證
- 登入 EWova 介面
- 右鍵腳本 驗證 [2. 讀取總攬頁的所有資料] 是否正確取得資料
- 右鍵腳本 驗證 [1. 隨便寫入總攬頁的所有資料] 是否成功寫入所有關卡隨機資料
- 右鍵腳本 驗證 [3. 修改第一關資料] 是否有提取目前進度並修改，在塞回資料
¶ C. 修改 個別關卡頁資料
只範例修改第一關頁面，其他頁面修改起來都是差不多的
¶ 創建範例腳本 ModifyLevel1Page 來驗證第一關
- 登入 EWova 介面
- 右鍵腳本 驗證 [1. 插入新列並塞一點資料] 是否正確加了新列，並隨便塞了資料
- 右鍵腳本 驗證 [2. 讀取第一頁的第一列資料] 是否可取得到剛剛加的第一列資訊
- 右鍵腳本 驗證 [3. 修改第一關第一列資料 (資料隨機塞)] 是否有正確上傳了隨機更改的資訊
¶ Unity 登入介面的 C# 功能介紹
EWovaLoginPlane 可以看到 Inspector 上有些公開 Unity 事件可使用
¶ 接收 Event
按下開始遊戲來驗證執行結果
- 使用帳號密碼登入事件
- 跳過登入開始遊戲事件
- 有登入後 開始遊戲事件
¶ Unity 創建學習歷程檢視器
目前只能在登入介面中開啟學習歷程檢視器
但我們不想透過登入介面來檢視學習歷程
而是將檢視器放在自己想放的地方
先建立一個 UGUI 空物件作為父物件 ( 必須是 RectTransform )
使用 PlaceSheetRecordShower 來驗證放置
將想要放置的空物件塞到腳本中
執行腳本後 將會創建一個全新的檢視器到空物件底下
