安装和配置 Experience Service > 配置参数 > 目标生成
  
目标生成
当显示体验时,Vuforia View 使用目标来追踪实物,并呈现相关的增强现实信息。当创作体验时,作者可以从多种目标中进行选择:ThingMark、空间目标、模型目标和图像目标。如果将使用模型目标或图像目标的体验发布到 Experience ServiceExperience 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 (字节,B)
kb (千字节,KB)
mb (兆字节,MB)
gb (千兆字节,GB)
tb (万亿字节,TB)
如果未指定任何单位,则假定 b 为单位。默认情况下,此参数被设置为 1.5GB
* 
可以将此参数设置为零,表示不限制目标生成任务所消耗的内存量。建议不要在生产环境中将此参数设置为零,因为如果目标生成任务占用所有可用内存会导致 Experience Service 崩溃。
targetGenerator.image.disable
若要启用图像目标生成,请将此属性设置为 false。若要禁用,请将此属性设置为 true。默认情况下,此参数被设置为 false
targetGenerator.image.maxImageSize
对于需要目标生成的图像,此参数定义其最大文件大小。如果需要目标生成的图像的文件大小超出 targetGenerator.image.maxImageSize 限制,则发布请求被拒绝,并显示 HTTP 413 状态。
* 
此限制不适用于不需要目标生成的图像。
默认情况下,此参数设置为 0,这表示对于需要目标生成的图像没有文件大小限制。可将此参数设置为正整数,以指定最大文件大小 (字节)。使用以下缩写 (区分大小写) 指定单位:
b (字节,B)
kb (千字节,KB)
mb (兆字节,MB)
gb (千兆字节,GB)
如果未指定任何单位,则假定字节为单位。
targetGenerator.model.disable
此参数可以通过安装程序进行配置。若要启用模型目标生成,请将此属性设置为 false。若要禁用,请将此属性设置为 true
targetGenerator.model.maxModelSize
对于需要目标生成的模型,此参数定义其最大文件大小。如果需要目标生成的模型的文件大小超出 targetGenerator.model.maxModelSize 限制,则发布请求被拒绝,并显示 HTTP 413 状态码。
* 
此限制不适用于不需要 MTG 的模型。
默认情况下,此参数设置为 0,这表示对于需要目标生成的模型没有文件大小限制。可将此参数设置为正整数,以指定最大文件大小 (字节)。使用以下缩写 (区分大小写) 指定单位:
b (字节,B)
kb (千字节,KB)
mb (兆字节,MB)
gb (千兆字节,GB)
如果未指定任何单位,则假定字节为单位。
targetGenerator.model.maxPolygons
此参数定义需要目标生成的模型所含多边形的最大数目。多边形的数量与目标生成所需的内存量密切相关。此限制由 Vuforia Studio 强制执行,而不是 Experience Service。如果需要目标生成的模型中的多边形数量超出 targetGenerator.model.maxPolygons 限制,Vuforia Studio 将不允许发布该模型。
可将此参数设置为一个正整数,用以限制需要目标生成的模型中包含的多边形的数目。可以将此参数设置为零,表示不限制多边形的数目。默认情况下,此参数被设置为 500,000
下面是一个配置 Experience Service 的 JSON 代码段示例:
Experience Service 启用模型目标和图像目标生成
将并发目标生成任务的数量限制为 4
对于需要目标生成的发布请求,将完成该请求所用的时间限制为 3 分钟
将所有同时执行的目标生成任务可用的内存限制为 4 GB
将需要目标生成的模型的大小限制为 80 MB
将需要目标生成的模型中的多边形数量限制为 300, 000
将需要目标生成的图像的大小限制为 10 MB
"targetGenerator": {
"maxTasks": 4,
"timeout": 180000,
"maxMemory": "4GB",
"model": {
"maxModelSize": "80MB",
"maxPolygons": 300000,
"disable": false
},
"image": {
"maxImageSize": "10MB",
"disable": false
}
}