使用小工具 > 3D > 路徑尋找器
  
路徑尋找器
此小工具的功能為何?
您可使用路徑尋找器小工具放置定位點,指引使用者前往模型的特定部份或其環境中的特定地點。如果您需要提示或引導使用者注意模型上的特定位置,或其環境中的地點,即可使用路徑尋找器。
作用中的小工具
此範例為小工具可能的外觀!
使用所必須的最少步驟
1. 拖曳「模型」小工具至畫布上。
2. 「資源」欄位中,選取現有的 CAD 檔案、新增新的檔案,或輸入您要顯示的檔案網址。
3. 將模型隨意放在畫布上的任何位置。
4. 拖放「路徑尋找器」小工具至畫布上。
5. 請確認已為路徑尋找器小工具設定下列內容:
「事件半徑 (公尺)」- 在此範例中,此內容設定為 0.5
「路徑尋找器顯示邊界 (公尺)」- 在此範例中,此內容設定為 1
「自動前進」- 確定已選取此核取方塊
* 
啟用「自動前進」會停用「已啟程」事件。
「已啟用」- 確認已選取此核取方塊
6. 將新增定位點圖示 () 拖放至模型上的任一位置。
7. 放置好定位點後,即可變更「易記名稱」來更新標籤。
8. 新增其他任何定位點。
9. 在您將所有定位點放置在模型上後,即可視需要在專案樹中重新排序定位點。定位點在專案樹中顯示的順序,代表使用者將被導向至定位點的順序。
10. 發佈體驗,然後在 Vuforia View 中檢視。您將看到第一個定位點。
還有任何特殊內容、服務、事件、動作嗎?
放置定位點後,您即可選取一個定位點來檢視其內容和事件。如需詳細資訊,請參閱〈定位點〉。
欲檢視常見小工具內容、服務、事件等清單,請參閱〈共通的小工具屬性、服務、事件〉。
下表列出此小工具專屬的內容、服務以及事件。
內容名稱
JavaScript 內容
描述
軌跡虛線顏色
ribbonColor
選取您定位點軌跡虛線的顏色:
橘色 (預設)
紅色
綠色
藍色
黃色
黑色
白色
洋紅色
土耳其藍
* 
選取與您的模型或周圍環境形成鮮明對比的顏色。
事件半徑 (公尺)
eventRadius
此內容預設的值為 0.5
使用者進入定位點的事件半徑內後,代表已抵達定位點 / 從定位點啟程,並會觸發「已抵達」「已啟程」事件。您可以使用特定定位點的「事件半徑 (公尺)」來覆寫此內容。
路徑尋找器顯示邊界 (公尺)
wayfinderDisplayBoundary
此內容預設的值為 2
輸入任何大於 0 的值時,即會隱藏標線與功能區軌跡虛線。為避免發生此行為,請將「路徑尋找器顯示邊界 (公尺)」設定為 0。您可以使用特定定位點的「路徑尋找器顯示邊界 (公尺)」內容來覆寫此內容。
自動前進
autoAdvance
預設會選取此內容。如果已啟用,在使用者進入定位點的截止半徑內時,路徑尋找器將自動導覽到下一個定位點。
「循環」
looping
在顯示最後一個定位點後,將使用者導回陣列中的第一個定位點。
「顯示軌跡虛線」
showRibbon
預設會選取此內容。如啟用,會在設計和執行階段顯示路徑尋找器的軌跡虛線。
顯示定位點
showWaypoints
預設會選取此內容。如啟用,會在設計及執行階段顯示定位點。
顯示標籤
showLabels
預設會選取此內容。如啟用,會在設計階段和執行階段中顯示標籤。
將標籤置於頂端
labelsOnTop
預設不會選取此內容。如啟用,標籤會顯示在其他物件上,且不會被遮障。
「已啟用」
此內容會在執行階段開啟或關閉路徑尋找器。其中包括可見度、事件紀錄、事件觸發和服務。
顯示標線
showReticle
預設不會選取此內容。如啟用此功能,標線會在執行階段顯示於畫面中央。
定位點資料
waypointsData
以零為基底索引的定位點陣列。
已選取的定位點索引
selectedWaypointIndex
目前選取之定位點的索引。
已選取的定位點資料
selectedWaypointData
目前選取之定位點的物件。
服務名稱
JavaScript 服務
描述
下一個
next
導覽前進至下一個定位點。
上一個
previous
導覽返回至上一個定位點。
事件名稱
JavaScript 事件
描述
已抵達
arrived
使用者進入定位點的截斷半徑範圍時,即會觸發。
已啟程
departed
使用者離開定位點的截斷半徑範圍時,即會觸發。