위젯 작업 > 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 이벤트가 트리거됩니다. 이 이벤트는 사용자 인터페이스에 오류 메시지를 자동으로 표시하지 않습니다. 경험 작성자는 이 이벤트를 처리하고 해당 경험에 대해 필요한 오류 알림이나 대체 동작을 작성할 책임이 있습니다. 이를 통해 누락된 제품 데이터에 대해 사용자에게 어떻게 알릴지를 완전히 제어할 수 있습니다.
사용 사례 예
다음 사용 사례를 참조하십시오.
도움이 되셨나요?