使用小工具 > 3D > 產品
產品
* 
此小工具只適用於 Vuforia StudioExperience Service 10.0.0 (含) 以上版本。
此小工具的功能為何?
產品小工具可供您擷取模型、模型目標等可重複使用的資產,而不必編寫任何程式碼。小工具會使用產品 API 自動擷取先前在 Experience Service 上傳及產生的特定產品資料,讓您輕鬆將動態內容整合至您的體驗中。如需詳細資訊,請參閱〈Vuforia Studio 產品 API〉。
使用此小工具的時機?
在您要從 Experience Service 動態載入模型及模型目標的任何體驗中,使用「產品」小工具。只要將「產品」小工具連接至 「模型」小工具及「動態目標」小工具,即可確保擷取的資產在執行階段順暢載入,而無需指令編寫。
使用此小工具時,體驗會採用已定義的邏輯:
如果已簡化模型,體驗則會自動擷取「中等」品質的版本。
如有多個模型目標可供使用,體驗會依下列順序優先載入最高品質的選項:進階 > 內部部署進階 > 標準。如果相同品質等級具備了多個版本,則會自動選擇最新版本。
如需逐步深入了解,請查看〈使用案例:動態載入和比對資產〉。
還有任何特殊內容、服務、事件、動作嗎?
欲檢視常用小工具屬性、服務、事件等清單,可參閱 共通的小工具屬性、服務、事件
* 
如果您不確定執行是哪個版本的 Experience Service,請聯絡您的系統管理員。
內容名稱
JavaScript
類型
描述
「產品 ID」
productID
string
產品的產品 ID。
「版本」
version
string
指定產品的版本。一個產品可以具備多個版本。如果並未提供版本,則會預設使用最新的可用版本。
* 
「最新」指的是最近建立的版本,不一定是版本編號最高的版本。
模型
modelUri
string
產品的模型資源 URL。(.pvz 檔案)
「目標」
targetUri
string
產品的目標資源 URL。(.dat 檔案)
* 
「產品」小工具可用以根據產品 ID 與選用版本載入及顯示產品資料。如果您一併提供產品 ID 和版本,小工具會載入該特定版本的產品。如果只提供產品 ID 而版本留白,小工具會自動載入最新版本的產品。
事件
JavaScript
描述
「產品已載入」
productLoaded
成功擷取產品相關 URL 時觸發。如要偵測模型什麼時候完全載入,請使用「模型目標」小工具的 modelLoaded 事件。
「產品失敗」
productFailed
產品載入失敗時觸發。
* 
如果找不到您提供的產品 ID 或產品 ID 與版本的組合,則會觸發 Product Failed 事件。此事件不會在使用者介面中自動顯示錯誤訊息。您身為體驗的編寫者,需要責任處理此事件,並為您的體驗建立所有必要的錯誤通知或因應行為;讓您完全掌控如何向使用者傳達缺少產品資料。
範例使用案例
請參閱下列使用案例:
這是否有幫助?