使用小工具 > 3D > 模型 (Model)
  
模型 (Model)
* 
由於模型檔案均與各個體驗一起搭售,且可能包含機密資訊,強烈建議您確保搭售檔案不會顯露應受到保護的 IP 資訊。
此小工具的功能為何?
「模型」小工具可將模型新增至您的體驗。
使用此小工具的時機?
當要在體驗中納入 3D 模型時,即可使用「模型」。如需在檢視體驗時提升模型效能的詳細資訊,請參閱 模型複雜度指導方針
還有任何特殊屬性、服務、事件、動作嗎?
欲檢視通用的小工具屬性、服務、事件等清單,可參閱 共通的小工具屬性、服務、事件
下表列出此小工具專屬的屬性、服務以及事件。
內容名稱
JavaScript
類型
描述
資源
src
resource url
連接模型使用資源的路徑。如需支援格式的詳細資訊,請參閱〈支援的 CAD 檔案格式〉。
比例
scale
string
模型的比例。
X 座標
x
number
模型在 X 軸上的位置。
Y 座標
y
number
模型在 Y 軸上的位置。
Z 座標
z
number
模型在 Z 軸上的位置。
X 旋轉
rx
number
模型繞 X 軸的旋轉角度。
Y 旋轉
ry
number
模型繞 Y 軸的旋轉角度。
Z 旋轉
rz
number
模型繞 Z 軸的旋轉角度。
遮蔽
occlude
boolean
若設定為「True」,就看不見小工具的幾何結構,但同時也會在 3D 場景中隱藏小工具的其他增強。
因此,在遮蔽小工具的位置上會顯示背景或相機饋入。如此可隱藏周遭的 3D 幾何結構,藉以強調某些增強功能。
最上層顯示
decal
boolean
變更模型的轉譯,使其隨時位於最上方。
如果選取此核取方塊,模型即永遠不會被其他增強功能覆蓋隱藏。
透明度 (1 不透明 - 0 透明)
opacity
number
以數字 0 與 1 來控制物件的透明度。0 為完全透明;1 則為完全不透明。如果設定為半透明 (例如將不透明度設為 <1),則會控制模型是否繪製成透明的 Shell (預設),或可完全將之看透。
目前步驟
currentStep
number
若已針對模型指定序列,則是啟用中序列的目前步驟。
正在播放
playing
boolean
播放序列時為「true」。
「序列清單」
sequenceList
info table
提供模型可用序列清單的資料負載。資料負載包含 namefilename 欄位。當繫結至小工具時(例如,重複器、清單或選取小工具),您可以輕鬆變更具有多個序列的模型之序列。
序列
sequence
resource url
使用中的動畫序列路徑。當選擇了「資源」屬性的「.pvz」檔案時,隨即以可用的「.pvi」檔案自動產生下拉式功能表。不應同時執行兩個序列。
* 
支援以 Creo Illustrate 8.1 (含) 以下版本所建立的序列。
在設計階段應用序列
showSequenceInCanvas
boolean
在設計階段影響 Vuforia Studio 模型的外觀。如果選取此核取方塊並選擇了序列,序列的初始步驟將直接套用於設計檢視中。若未選取此核取方塊,模型會以其預設狀態顯示。
步驟
steps
number
使用中序列的總步驟數。
服務名稱
JavaScript
描述
快轉
forward
序列往前一個步驟。
播放
play
從目前位置播放序列。
播放全部
playAll
從目前位置播放序列,且不會在步驟間停止播放。
重設
reset
將檢視中的所有模型重設為第一步。
倒轉
rewind
序列回上一個步驟。
停止
stop
將序列停在目前位置。
事件
JavaScript
描述
播放已開始
playstarted
在序列的一個步驟開始播放時觸發。
播放已停止
playstopped
在序列的一個步驟停止播放時觸發。傳遞一個資料物件參數,提供步驟的相關資訊。
模型已載入
modelLoaded
在完全載入模型時觸發。
確認已請求
acknowledgeRequested
序列期間要求確認時觸發。
* 
使用 JS 運算式方塊,針對確認來建立自訂互動。
* 
欲覆寫所有其他可見度設定,並隱藏模型及相關的所有項目,請將下列小工具屬性之一繫結到模型,並選取「選取繫結目標」視窗上的「強制隱藏」
2D 小工具
屬性
核取方塊
數值
開關
數值
開關按鈕
已按下
未按下
這也會覆蓋由已選序列所設定的任何可見度。
動作中的小工具
此範例為小工具可能的外觀!
使用所必須的最少步驟
近似外觀
1. 拖曳「模型」小工具至畫布上。
2. 「資源」欄位中,選取現有的 CAD 檔案、新增新的檔案,或輸入您要顯示的檔案網址。
3. 將模型置於畫布上的適當位置。