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,000ms(2분)의 제한이 있음을 나타냅니다. 대상 생성과 함께 게시 요청을 완료하는 데 필요한 시간에 대한 제한이 없는 경우 이 매개 변수를 0으로 설정합니다.
targetGenerator.maxMemory
이 속성은 모든 대상 생성 작업에서 사용할 수 있는 최대 메모리 양을 정의합니다. 모든 동시 대상 생성 작업에서 사용하는 전체 메모리 양이 targetGenerator.maxMemory 한도를 초과할 경우, 현재 가장 많은 메모리를 차지하는 대상 생성 작업이 종료되고 Experience Service가 해당 게시 요청에 HTTP 413 상태로 응답합니다.
모든 동시 실행 대상 생성 작업에서 사용할 수 있는 최대 메모리 양을 바이트로 제한하려면 이 매개 변수를 양의 정수로 설정합니다. 예를 들면 2.5GB입니다. 다음과 같은 대/소문자 구분 약어를 사용하여 단위를 지정 합니다.
b(바이트)
kb(킬로바이트)
mb(메가바이트)
gb(기가바이트)
tb(테라바이트)
단위를 지정하지 않으면 b가 단위로 간주됩니다. 기본값으로 이 매개 변수는 1.5GB로 설정됩니다.
* 
이 매개 변수를 0으로 설정하여 대상 생성 작업에서 사용할 수 있는 메모리 양에 제한이 없다는 것을 나타낼 수 있습니다. 대상 생성 작업에서 가용 메모리를 모두 사용할 경우 Experience Service가 중지될 수 있기 때문에 생산 환경에서 이 매개 변수를 0으로 설정하는 것을 권장하지 않습니다.
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
이 매개 변수는 대상 생성이 필요한 모델에 포함된 다각형의 최대 수를 정의합니다. 다각형의 수는 대상 생성에 필요한 메모리 양과 밀접한 관계가 있습니다. 이 한도는 Experience Service가 아닌 Vuforia Studio에서 정합니다. 대상 생성이 필요한 모델에 있는 다각형의 수가 targetGenerator.model.maxPolygons 한도를 초과할 경우, Vuforia Studio에서 모델 게시를 허용하지 않습니다.
대상 생성이 필요한 모델에 포함될 수 있는 다각형의 수를 제한하려면 이 매개 변수를 양의 정수로 설정하십시오. 이 매개 변수를 0으로 설정하여 다각형의 수에 제한이 없다는 것을 나타낼 수 있습니다. 기본값으로 이 매개 변수는 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
}
}