Android Vuforia AR 更換辨識物與顯示模型 (1)

既前篇 Android Vuforia AR 範例：Core Features 的開啟範例後，
我們要開始嘗試替換辨識物和顯示模型進行練習．

一、辨識物的設定

1. 官網新增 Target，並下載檔案
• 解壓縮得到 DemoDatabase.dat、DemoDatabase.xml 兩個檔案
2. Assets 內放置檔案

• 
  
3. 修改至程式中（以 Core Features 項目中的 ImageTargets 進行）

• 在 VuforiaSamples.ImageTargets 中修改程式部分：
• -------------------------------------------------------------
• 在 ImageTargets.java 中，修改和新增辨識物的 Database： DemoDatabase.xml
• -------------------------------------------------------------
• 
• -------------------------------------------------------------
• 在 ImageTargetRenderer.java 中，修改和新增辨識物資料庫的內容項目：TestTarget （可參考官網 TargetManager 或 DemoDatabase.xml）
• -------------------------------------------------------------
• DemoDatabase.xml 內容：
• 
• 在 ImageTargetRenderer.java 找到 renderFrame() 方法，並修改和新增 textureIndex 的判斷：
• 
•  renderFrame() 負責處理 AR 辨識結果和模型矩陣運算，之後將用於第三方模型套件應用．
• 測試結果：

Android Vuforia AR 範例：Core Features

一、下載 SDK 與 Sample 和註冊會員

1. 至 Vufroia Developer Portal 下載 Vuforia 5.5 SDK 和 Samples - Core Features for Android 範例

• https://developer.vuforia.com/
• https://developer.vuforia.com/downloads/samples

2. 登入或註冊 Vuforia 帳號

3. 進入 Develop 分頁，裡面有兩項目：

• License Manager：
• 管理 License，一個 License 可以多款 app 使用，但掃描次數皆累積於共用的那一個 License．
• License 分級：
• Starter：屬於免費使用。可以建立 Target 庫和下載掃描，但在雲端掃描上有次數限制（每個月最高上限） 和 會出現 Vuforia 無水印．
• Classic：一次型付費。無法雲端掃描，但可移除浮水印．
• Cloud：月費型付費。可雲端掃描且可移除浮水印，但雲端掃描量（每個月最高上限）有收費分級制．

• Target Manager：
• 管理 Target，可以建立多個 Database 存放不同的辨識物，透過上傳辨識物可判斷該辨識物的可辨識度（星數越高越好辨識），辨識物可以放 Vuforia 端進行 Cloud Reco 判斷或是下載至裝置內存判斷．兩著差別在於 Cloud 有數量計數收費標準，而下載則不用．

License Manager

Target Manager

二、開啟和執行 Samples - Core Features 

1. 解壓縮下載的 SDK 檔案後，可以看到裡面有的檔案資料夾路徑：
• 參考 readme.txt 所描述的結構說明
• vuforia-sdk-android-5-5-9 \
• assets \                                            Additional assets required to use Vuforia SDK
• frame-markers-transparent \
• build \                                              Vuforia SDK
• include \                                Commented header files
• java \                                     Precompiled Java classes
• vuforia \
• Vuforia.jar
• lib \                                        Dynamic link libraries
• armeabi-v7a \
• libVuforia.so
• licenses \                                        License Agreements
• license_3rdpartynotice.txt
• samples \                                        Destination folder for sample applications
• readme.txt                                              
2.  Android Studio 開啟 VuforiaSample，並在專案中加入下列三項：



1. Vuforia.jar：專案中建立 libs 資料夾，並將 .jar 放入其中和 Add Library
2. libVuforia.so：專案中建立 jniLibs，並將 armeabi-v7a 資料夾和 libVuforia.so 加入
3. license key：將官網 License Manager 中，所建立的 Key 複製並加入程式中．
   
   
   
   
   
   
   
   
   
3. 在 SampleApplicationSession.java 的 InitVuforiaTask 中，找到 Vuforia.setInitParameters() 方法：
   Vuforia.setInitParameters(
           Activity activity,
           int flags,
           "your Key"
   )
   
   
   
   
   
4. 完成以上步驟後，build and run 在自己的手機裝置上進行測試：
   在此以 ImageTargets 選單項目進行