路徑尋找器

使用所必須的最少步驟

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	使用者離開定位點的截斷半徑範圍時，即會觸發。