3D 콘텐츠 처리 함수
setViewProperties
보기 수준의 렌더링 옵션을 구성합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
기본값
|
|---|---|---|---|---|
|
params
|
객체
|
구성할 보기 속성 포함된 객체입니다.
|
필수
|
|
|
params.dropshadow
|
부울
|
드롭 섀도우를 사용 또는 사용하지 않습니다.
|
선택 사항
|
true
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
 |
현재, params 객체에서 드롭 섀도우만 지원됩니다.
|
addPVS
경험에 3D 모델을 추가합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
trackerName
|
문자열
|
이 모델과 연관되어야 하는 트래커 ID입니다..
|
필수
|
|
name
|
문자열
|
모델 위젯의 Studio ID입니다.
|
필수
|
|
url
|
문자열
|
3D 모델을 로드하기 위한 URI입니다.
|
선택 사항
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
url이 비어 있거나 정의되지 않은 경우 빈 모델 자리 표시자가 작성됩니다.
|
setModelURL
모델에 대한 새 모델 URL을 설정하고 모델을 로드합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
params
|
객체
|
모델 참조 및 URI가 포함된 객체입니다.
|
필수
|
|
params.modelID
|
문자열
|
업데이트할 모델 요소의 Studio ID입니다.
|
필수
|
|
params.modelURL
|
문자열
|
3D 모델을 불러올 URI입니다.
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
모델 요소는 addPVS를 사용하여 미리 초기화해야 합니다.
|
setProperties
특정 요소에 대한 시각적 및 렌더링 관련 효과 속성을 설정합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
기본값
|
|---|---|---|---|---|
|
name
|
문자열
|
업데이트할 요소의 Studio ID입니다.
|
필수
|
|
|
params
|
객체
|
적용할 렌더링 속성이 포함된 객체입니다.
|
필수
|
|
|
params.occlude
|
부울
|
다른 객체에 대한 모델의 가림을 활성화하거나 비활성화합니다.
|
선택 사항
|
true
|
|
params.billboard
|
부울
|
빌보드를 활성화하거나 비활성화합니다(3D 이미지 위젯(3D 이미지, 3D 게이지 및 3D 레이블)에만 적용됨).
|
선택 사항
|
true
|
|
params.hidden
|
부울
|
요소의 숨기기를 활성화하거나 비활성화합니다(모든 비 3D 모델 위젯, 주로 하위 어셈블리에 적용됨).
|
선택 사항
|
true
|
|
params.opacity
|
숫자
|
요소의 불투명도를 설정합니다(0.0 = 투명, 1.0 = 불투명).
|
선택 사항
|
1.0
|
|
params.decal
|
부울
|
전사/항상 위에 있는 렌더링 모드를 활성화하거나 비활성화합니다.
|
선택 사항
|
true
|
|
params.shader
|
문자열
|
세미콜론으로 구분된 셰이더 이름과 선택적 매개 변수로 구성된 셰이더 정의 문자열입니다. 예: "highlight; r f 1; g f 0; b f 0; a f 1"
|
선택 사항
|
""
|
|
params.phantom
|
부울
|
요소에 대한 반투명도를 활성화하거나 비활성화합니다(3D 모델 위젯에만 적용됨).
|
선택 사항
|
true
|
|
params.forceHidden
|
부울
|
요소의 강제 숨기기를 활성화하거나 비활성화합니다( 3D 모델 위젯에만 적용됨).
|
선택 사항
|
true
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
• params 객체에서 여러 속성을 결합하여 한 번에 적용할 수 있습니다.
• 지정하지 않은 속성은 기본값으로 설정됩니다.
|
loadPVI
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
params
|
객체
|
모델 참조와 VIP 파일에 대한 URI가 포함된 객체입니다.
|
필수
|
|
params.modelID
|
문자열
|
VIP를 로드할 모델의 Studio ID입니다.
|
필수
|
|
params.url
|
문자열
|
애니메이션 데이터를 로드하는 데 사용되는 VIP 파일의 URI입니다. 생략할 경우, 모델에 대해 이전에 로드된 애니메이션 데이터가 언로드됩니다.
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
• url이 제공되면 지정된 파일에서 애니메이션이 로드됩니다.
• url이 생략되었거나 빈 문자열이면 이전에 로드된 모든 VIP 데이터가 모델에서 제거됩니다.
|
playStep
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
params
|
객체
|
모델과 단계 정보가 포함된 객체입니다.
|
필수
|
|
params.modelID
|
문자열
|
애니메이션 단계를 로드할 모델의 Studio ID입니다.
|
필수
|
|
params.stepNumber
|
숫자
|
재생할 단계 번호입니다.
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
모델에는 유효한 애니메이션 단계와 함께 로드된 VIP 파일이 있어야 합니다(loadPVI 참조).
|
gotoStep
지정된 모델의 특정 애니메이션 단계로 이동하고 해당 위치로 설정합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
params
|
객체
|
모델과 단계 정보가 포함된 객체입니다.
|
필수
|
|
params.modelID
|
문자열
|
애니메이션 단계를 로드할 모델의 Studio ID입니다.
|
필수
|
|
params.stepNumber
|
숫자
|
이동할 단계 번호입니다.
|
필수
|
|
params.position
|
문자열
|
단계 내 위치: "start" 또는 "end".
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
모델에 PVI 애니메이션 데이터가 로드되어 있어야 합니다(loadPVI 참조).
|
add3DImage
3D 공간에 이미지를 추가합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
기본값
|
|---|---|---|---|---|
|
params
|
객체
|
이미지 배치 및 디스플레이 정보가 포함된 객체입니다.
|
필수
|
|
|
params.tracker
|
문자열
|
이 이미지와 연관되어야 하는 트래커 ID입니다.
|
필수
|
|
|
params.id
|
문자열
|
위젯의 Studio ID입니다.
|
필수
|
|
|
params.src
|
문자열
|
표시할 이미지의 URI 또는 Base64 문자열입니다.
|
필수
|
|
|
params.width
|
숫자
|
3D 공간의 이미지 너비입니다(미터).
|
선택 사항
|
NaN
|
|
params.height
|
숫자
|
3D 공간의 이미지 높이입니다(미터).
|
선택 사항
|
NaN
|
|
params.pivot
|
숫자
|
위치를 지정하기 위한 피벗 포인트입니다. 피벗 값은 다음과 같습니다.
• 1 - 왼쪽 상단 모서리에서 피벗
• 2 - 상단 가운데에서 피벗
• 3 - 오른쪽 상단 모서리에서 피벗
• 4 - 왼쪽 중간 가장자리에서 피벗
• 5 - 가운데에서 피벗(기본값)
• 6 - 오른쪽 중간 가장자리에서 피벗
• 7 - 왼쪽 하단 모서리에서 피벗
• 8 - 하단 가운데에서 피벗
• 9 - 오른쪽 하단 모서리에서 피벗
|
선택 사항
|
5
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
• 너비 또는 높이 중 하나가 생략되었거나 NaN으로 설정된 경우 누락된 값은 원래 가로세로비를 유지하면서 제공된 다른 치수를 기준으로 계산됩니다.
• 너비 및 높이가 모두 생략되었거나 NaN으로 설정된 경우 이미지의 원래 크기에서 치수가 자동으로 결정됩니다.
|
setWayfinderProperties
웨이파인더 위젯의 속성을 설정합니다. 탐색을 시작하려면 이후에 setWaypoint를 호출해야 합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
기본값
|
|---|---|---|---|---|
|
params
|
객체
|
웨이파인더 구성 설정이 포함된 객체입니다.
|
필수
|
|
|
params.widgetId
|
문자열
|
구성할 웨이파인더 위젯의 Studio ID입니다.
|
필수
|
|
|
params.active
|
부울
|
웨이파인더를 활성화하거나 비활성화합니다.
|
선택 사항
|
true
|
|
params.showReticle
|
부울
|
레티클의 표시를 활성화하거나 비활성화합니다.
|
선택 사항
|
true
|
|
params.showRibbon
|
부울
|
웨이포인트로 이어지는 리본 경로의 표시를 활성화하거나 비활성화합니다.
|
선택 사항
|
true
|
|
params.showWaypoints
|
부울
|
웨이포인트의 표시를 활성화하거나 비활성화합니다.
|
선택 사항
|
true
|
|
params.showLabels
|
부울
|
웨이포인트 레이블의 표시를 활성화하거나 비활성화합니다.
|
선택 사항
|
true
|
|
params.labelsOnTop
|
부울
|
다른 장면 요소 위에 레이블의 렌더링을 활성화하거나 비활성화합니다.
|
선택 사항
|
true
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
setWaypoint
위치 및 시각적 모양을 포함하여 현재 활성화된 웨이포인트의 속성을 설정하거나 업데이트합니다. setWayfinderProperties를 사전에 호출해야 합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
기본값
|
|---|---|---|---|---|
|
params
|
객체
|
웨이포인트 구성이 포함된 객체입니다.
|
필수
|
|
|
params.position
|
문자열
|
x, y, z 속성을 가진 객체로서 웨이포인트의 3D 위치를 나타냅니다. 예: {"x": 0.1995, "y": 0.0617, "z": 0.2545}
|
필수
|
|
|
params.gaze
|
문자열
|
x, y, z 속성을 가진 객체로서 3D 응시 방향 벡터입니다. 예: {"x": 0, "y": 0, "z": -1}
|
필수
|
|
|
params.eventRadius
|
숫자
|
이벤트(예: 자동 진행)가 트리거되는 거리(미터)입니다.
|
선택 사항
|
0
|
|
params.wayfinderDisplayBoundary
|
숫자
|
웨이파인더가 숨겨지는 반경(미터)입니다.
|
선택 사항
|
0
|
|
params.color
|
문자열
|
웨이포인트 및 리본의 색입니다. 다음 사전 정의된 rgba 값(주황색, 빨간색, 녹색, 파란색, 노란색, 분홍색, 하늘색, 검정, 흰색) 중 하나여야 합니다. 지원되지 않는 색은 기본적으로 주황색이 됩니다. 예: "rgba(255, 165, 0, 1)") 다음은 지원되는 값입니다.
• 주황색 - rgba(255, 165, 0, 1)
• 빨간색 - rgba(255, 0, 0, 1)
• 녹색 - rgba(0, 255, 0, 1)
• 파란색 - rgba(0, 0, 255, 1)
• 노란색 - rgba(255, 255, 0, 1)
• 분홍색 - rgba(255, 0, 255, 1)
• 하늘색 - rgba(0, 255, 255, 1)
• 검정 - rgba(0, 0, 0, 1)
• 흰색 - rgba(255, 255, 255, 1)
다른 색이 전달되면 기본 색인 주황색: rgba(255, 165, 0, 1)가 자동으로 사용됩니다.
|
선택 사항
|
black
|
|
params.label
|
문자열
|
웨이포인트 옆에 표시할 텍스트 레이블입니다.
|
선택 사항
|
""
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
position 및 gaze 매개 변수는 3D 벡터 객체여야 합니다(예: {"x": 0.1995, "y": 0.0617, "z": 0.2545}).
|