기타 함수
takeScreenshot
현재 카메라 보기의 스크린샷을 캡처하며, 선택적으로 가상(증강) 콘텐츠를 포함할 수 있습니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
기본값
|
|---|---|---|---|---|
|
params
|
객체
|
스크린샷 구성이 포함된 객체입니다.
|
필수
|
|
|
params.withAugmentation
|
부울
|
스크린샷에 가상 또는 증강 콘텐츠를 포함할지 여부를 설정합니다.
|
필수
|
|
|
params.dataURL
|
부울
|
결과 문자열에 데이터 URI 접두사(예: “data:image/png;base64,”)를 추가할지 여부를 설정합니다.
|
선택 사항
|
true
|
|
params.imgFormat
|
문자열
|
이미지 형식입니다. 지원되는 파일 유형:
• .png
• .jpeg
|
선택 사항
|
"PNG"
|
|
params.imgWidth
|
숫자
|
캡처된 이미지의 목표 너비입니다(단위: 픽셀).
|
선택 사항
|
|
|
params.imgHeight
|
숫자
|
캡처된 이미지의 목표 높이입니다(단위: 픽셀).
|
선택 사항
|
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
 |
• imgWidth 또는 imgHeight가 제공되지 않은 경우:
◦ 카메라의 기본 해상도로 이미지가 캡처됩니다.
◦ 해상도가 화면 너비 및 높이의 절반보다 작을 경우, 이미지 크기는 최소한 화면 너비의 절반에 화면 높이의 절반을 곱한 값으로 확대되어 경험 내 미리 보기에서 회색 테두리가 나타나지 않도록 합니다.
◦ 기본 해상도가 이미 이 임계값을 충족하는 경우, 이미지는 변경되지 않습니다.
• 치수가 하나만 제공되면(imgWidth 또는 imgHeight) 누락된 치수가 원래 가로세로비를 유지하기 위해 자동으로 계산됩니다.
• 치수가 모두 제공된 경우(imgWidth 및 imgHeight):
◦ 원래 가로세로비를 유지하기 위해 치수 하나가 다시 계산됩니다.
◦ 최종 이미지는 지정된 경계 내에 맞춰집니다.
• dataURL이 true인 경우 base64로 인코딩된 문자열 앞에 MIME 유형이 붙습니다(예: "data:image/png;base64," 또는 "data:image/jpeg;base64,").
• 이미지는 successCallback을 통해 반환됩니다.
|
scanForNextBarCode
바코드 스캐너를 시작하고 다음으로 인식 가능한 바코드를 기다립니다. 바코드가 감지되면 스캐너가 멈추고 결과를 반환합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
• 유효한 바코드가 감지되면 스캔이 자동으로 중지됩니다.
• successCallback에서 반환된 값은 바코드의 디코딩된 문자열 표현입니다.
|
scanBarCodeScanning
현재 실행 중인 바코드 스캐너가 활성 상태이면 이를 중지하며, 스캐너가 실행 중이 아닐 경우에는 아무런 영향을 주지 않습니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
• 이 함수는 scanForNextBarcode를 통해 시작된 진행 중인 바코드 스캔을 수동으로 취소하는 데 사용할 수 있습니다.
• 현재 활성 상태인 스캔이 없으면 이 함수는 아무런 효과 없이 정상적으로 반환됩니다.
• 스캐너는 바코드를 성공적으로 감지한 후 자동으로 중지되므로, 이 함수는 일반적으로 수동 취소가 필요할 때만 사용됩니다.
|
setupTrackingEventsCommand
추적된 대상의 위치 또는 방향 변경과 같은 추적 이벤트 업데이트를 수신하도록 콜백을 등록합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
• successCallback은 추적이 활성 상태인 동안 프레임당 한 번씩 호출됩니다.
• 각 콜백은 다음 값으로 구성된 문자열 배열을 수신합니다.
◦ trackerId - 현재 트래커의 ID입니다(트래커 ID).
◦ cameraPosition - 트래커 공간에서 카메라의 위치입니다([x,y,z] 형식의 문자열).
◦ cameraForward - 트래커 공간에서 카메라의 전방 방향 벡터입니다.
◦ cameraUp - 트래커 공간에서 카메라의 위쪽 방향 벡터입니다.
◦ timestamp - 추적 시점의 UNIX 타임스탬프입니다(단위: 초).
• errorCallback은 현재 이 함수에서 사용되지 않습니다.
|
setDimensions
3D 이미지의 너비와 높이를 설정합니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|
|---|---|---|---|---|
|
id
|
문자열
|
업데이트할 3D 이미지의 Studio ID입니다.
|
필수
|
|
|
params
|
객체
|
치수값이 포함된 객체입니다.
|
필수
|
|
|
params.width
|
숫자
|
이미지의 목표 너비입니다.
|
선택 사항
|
NaN
|
|
params.height
|
숫자
|
이미지의 목표 높이입니다.
|
선택 사항
|
NaN
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
• 이 함수는 이미지(3D 이미지, 3D 게이지 및 3D 레이블)를 수락하는 3D 위젯에 대해서만 지원됩니다.
• 너비 또는 높이 중 하나가 생략되었거나 NaN으로 설정된 경우 누락된 값은 원래 가로세로비를 유지하면서 제공된 다른 치수를 기준으로 계산됩니다.
• 너비 및 높이가 모두 생략되었거나 NaN으로 설정된 경우 질감의 기본 크기에서 치수가 자동으로 결정됩니다.
|