追蹤函數
addTracker
|
名稱
|
類型
|
描述
|
必要/選用
|
預設
|
|---|---|---|---|---|
|
params
|
物件
|
組態物件包含了追蹤器設定。
|
必要
|
|
|
params.name
|
字串
|
追蹤器或追蹤情境的名稱。
|
必要
|
|
|
params.enableTrackingEvents
|
布林
|
啟用或停用追蹤事件。
|
選用
|
true
|
|
params.trackingHints
|
布林
|
啟用或停用追蹤提示以提高辨識度。
|
選用
|
true
|
|
successCallback
|
函數
|
在作業成功完成時呼叫。
|
選用
|
|
|
errorCallback
|
函數
|
在作業失敗時呼叫。
|
選用
|
 |
如果 enableTrackingEvents 和 trackingHints 皆為 true，追蹤資料會透過 successCallback 持續廣播。
|
addMarker
將標記 (目標) 新增至體驗。來源可以選用任何支援的追蹤目標類型。有關支援追蹤器類型的詳細資訊，請參見〈核心元件及概念〉。
|
名稱
|
類型
|
描述
|
必要/選用
|
預設
|
|---|---|---|---|---|
|
trackerName
|
字串
|
要與此標記要建立關聯的追蹤器 ID (透過 addTracker 定義)。
|
必要
|
|
|
name
|
字串
|
目標小工具的 Studio ID。
|
必要
|
|
|
src
|
字串
|
定義要使用的追蹤目標類型和 ID。
範例：
• "vuforia-vumark:///vumark?id=5:789"
• "vuforia-vumark:///app/resources/Uploaded/BarCodeEAN?id="
• "vuforia-image:///image?id=image-target-1"
• "vuforia-runtime-image:///app/resources/Uploaded/stones.jpg?id=0486b3eb-880e-4c9b-8416-0e646f409e4c"
• "vuforia-area:///area?id=area-target-1"
• "vuforia-model:///model?id=model-target-1"
|
必要
|
|
|
size
|
浮點數
|
追蹤目標的尺寸 (以公尺為單位)，可用於圖像和 ThingMark 追蹤目標。
|
選用
|
0
|
|
successCallback
|
函數
|
在作業成功完成時呼叫。
|
選用
|
|
|
errorCallback
|
函數
|
在作業失敗時呼叫。
|
選用
|
getTracked
擷取目前所有作用中追蹤器 (目標) 的清單，然後將名稱傳遞至 successCallback。
|
名稱
|
類型
|
描述
|
必要/選用
|
|---|---|---|---|
|
successCallback
|
函數
|
在作業成功完成時呼叫。
|
選用
|
|
errorCallback
|
函數
|
在作業失敗時呼叫。
|
選用
|
|
|
傳遞給 successCallback 的陣列格式為：["targetName1", "targetName2"]
|
resetSpatialTracking
重設空間追蹤系統，包含環境追蹤。
|
名稱
|
類型
|
描述
|
必要/選用
|
|---|---|---|---|
|
successCallback
|
函數
|
在作業成功完成時呼叫。
|
選用
|
|
errorCallback
|
函數
|
在作業失敗時呼叫。
|
選用
|
|
|
此函數會移除所有錨點，並重設手勢型轉換 (例如縮放、旋轉、方位)。
|