安裝及配置 Experience Service > 組態參數 > 目標產生
  
目標產生
顯示體驗時,Vuforia View 使用目標來追蹤實體物件並彩現與此類實體物件相關的增強。 編寫體驗時,編寫者可從多個目標類型中進行選擇:ThingMark、空間目標、模型目標與圖像目標。使用模型目標或圖像目標的體驗發佈至 Experience Service 時,Experience Service 必須透過上傳的模型或圖像產生目標。
產生目標會消耗可用系統的大量資源,而且可能會降低 Experience Service 的效能。為大型且複雜的模型產生模型目標時尤其如此,會消耗大量記憶體。可使用下述組態參數來限制目標產生所消耗的系統資源。
參數
描述
targetGenerator.maxTasks
此參數定義所允許的目標產生器同步任務的數量。如果需產生目標的專案是在進行中任務數達到 targetGenerator.maxTasks 限制時進行發佈,則發佈請求會以 HTTP 429 狀態遭到拒絕。
依預設,此參數設定為 0,這表示同步任務數量沒有限制。將此參數設定為正整數,以限制同步目標產生任務的數量。
targetGenerator.timeout
此內容定義完成需產生目標之發佈請求所允許的最長時間。如果完成需產生目標之發佈請求所花的時間超過 targetGenerator.timeout 限制,則發佈請求會終止,Experience Service 會以 HTTP 413 狀態回應原始發佈請求。
此參數的預設值為 -1,表示完成發佈請求 (含目標產生) 所需的時間上限為 120,000 毫秒 (2 分鐘)。如果完成包含目標產生之發佈請求所需的時間並無限制,請將此參數設為 0
targetGenerator.maxMemory
此內容定義所有目標產生任務可用的最大記憶體大小。若所有同步目標產生任務總共使用的記憶體超出 targetGenerator.maxMemory 限制,則目前記憶體佔用量最大的目標產生任務會終止,且 Experience Service 會以 HTTP 413 狀態回應對應的發佈請求。
將此參數設定為正整數,以限制所有同步執行目標產生之任務可消耗的最大記憶體大小 (以位元組表示)。例如,2.5GB。使用下列區分大小寫的縮寫指定單位:
b (位元組)
kb (千位元組)
mb (百萬位元組)
gb (十億位元組)
tb (太-位元組)
若未指定單位,則單位會假定為 b。依預設,本參數已設定為 1.5GB
* 
此參數可設定為零,表示目標產生任務消耗的記憶體大小不受限制。不建議在生產環境中將此參數設定為零,因為如果目標產生任務消耗所有可用的記憶體,其會導致 Experience Service 當機。
targetGenerator.image.disable
如需啟用圖像目標產生,將此內容設定為 false。若要將其禁用,則將其設定為 true。依預設,本參數已設定為 false
targetGenerator.image.maxImageSize
此參數定義需產生目標之圖像的最大檔案大小。如果需產生目標之圖像的檔案大小超出 targetGenerator.image.maxImageSize 限制,則發佈請求會遭拒絕且產生 HTTP 413 狀態。
* 
此限制不適用於無需產生目標的圖像。
依預設,此參數設定為 0,這表示需產生目標之圖像的檔案大小沒有限制。將此參數設定為正整數,以指定最大檔案大小 (以位元組表示)。使用下列區分大小寫的縮寫指定單位:
b (位元組)
kb (千位元組)
mb (百萬位元組)
gb (十億位元組)
若未指定單位,則單位會假定為位元組。
targetGenerator.model.disable
可以使用安裝程式設定此參數。若要啟用模型目標產生,將此內容設定為 false。若要將其禁用,則將其設定為 true
targetGenerator.model.maxModelSize
此參數定義需產生目標之模型的最大檔案大小。如果需產生目標之模型的檔案大小超出 targetGenerator.model.maxModelSize 限制,則發佈請求會遭拒絕且產生 HTTP 413 狀態。
* 
此限制不適用於不需要 MTG 的模型。
依預設,此參數設定為 0,這表示需產生目標之模型的檔案大小沒有限制。將此參數設定為正整數,以指定最大檔案大小 (以位元組表示)。使用下列區分大小寫的縮寫指定單位:
b (位元組)
kb (千位元組)
mb (百萬位元組)
gb (十億位元組)
若未指定單位,則單位會假定為位元組。
targetGenerator.model.maxPolygons
此參數定義需產生目標之模型中所含的多邊形的最大數量。多邊形的數量與目標產生所需的記憶體大小密切相關。此限制受 Vuforia Studio 強制執行,而不是 Experience Service。若需產生目標之模型中的多邊形數超出 targetGenerator.model.maxPolygons 限制,Vuforia Studio 不會允許發佈模型。
將此參數設定為正整數,以限制需產生目標之模型可包含的多邊形數量。此參數可以設定為零,表示多邊形數量不受限制。依預設,本參數已設定為 500,000
以下是配置 Experience Service 的 JSON 程式碼片段範例,如下所示:
可在 Experience Service 上啟用模型目標和圖像目標產生
將同步目標產生任務數限制為 4 個
將完成需產生目標之發佈請求所花的時間限制為 3 分鐘
將所有同步執行目標產生之任務可消耗的記憶體限制為 4GB
將需產生目標之模型的大小限制為 80MB
將需產生目標之模型中所含的多邊形數限制為 300,000 個
將需產生目標之圖像的大小限制為 10MB
"targetGenerator": {
"maxTasks": 4,
"timeout": 180000,
"maxMemory": "4GB",
"model": {
"maxModelSize": "80MB",
"maxPolygons": 300000,
"disable": false
},
"image": {
"maxImageSize": "10MB",
"disable": false
}
}