FAQ
아래 FAQ에서 찾을 수 없는 질문은 ARCeyeVLSDK Github에 이슈를 남겨주시거나 dl_ar@naverlabs.com로 연락 바랍니다.
공간 인식
처음부터 공간 인식에 계속 실패합니다.
이 문제는 다음과 같은 원인으로 발생할 수 있으며 해결 방법은 다음과 같습니다.
- ARC eye 공간 스캔 범위 외의 영역에서 스캔을 시도함. →
스캔 범위 내에서 VL 요청 수행 - 공간과 맞지 않은 잘못된 Invoke URL 사용함. →
지정된 공간에서 VL 요청 수행, Invoke URL와 Secret Key 오타 점검 - GPS Guide 영역 설정 오류. →
GPS Guide를 비활성화 한 뒤 테스트 진행 - VL Quality가 High로 설정되어 있음. →
VL Quality를 Low로 설정 한 뒤 테스트 진행 - 네트워크가 연결되지 않음. →
네트워크 연결
처음에는 공간 인식이 잘 됐지만 그 이후 요청에서 계속 공간 인식에 실패합니다.
처음 위치 인식 시 잘못된 위치로 인식되면 해당 문제가 발생할 수 있습니다. 공간 인식 요청을 보낼때 현재 위치값을 기반으로 공간 인식을 시도하기 때문에 처음 위치가 잘못 인식되면 그 이후의 모든 요청이 실패할 가능성이 높아집니다. 장소를 이동한 후 공간 인식을 시도해보세요.
위치가 잘못 인식되는 경우 어떻게 해야 하나요?
VLSDK 세션을 초기화 하시면 됩니다. 기기의 상단이 바닥 방향을 향하는 경우 VLSDKManager 내부에서 자동으로 초기화를 진행합니다. 또는 VLSDK 세션은 VLSDKManager의 ResetSession()을 호출함으로서 초기화 할 수 있습니다.
위치가 잘못 인식된 것을 자동으로 알 수 있나요?
위치나 공간이 잘못 인식된 것을 알 수 있는 기능은 제공되지 않고 있습니다.
같은 공간이 낮에서 밤으로 바뀌어도 잘 동작 하나요?
잘 동작 합니다. ARC eye로 공간을 스캔한 환경과 차이가 발생할 경우 인식률이 떨어질 수는 있지만 공간 기반 AR 서비스를 개발하는데 문제가 없습니다. 다만 공간이 크게 바뀌어 시각적 특징이 달라지는 경우에는 인식이 되지 않을 수도 있습니다. 이 경우에는 해당 공간에 대해 재스캔을 진행해야 합니다.
GPS 값만 가지고 측위를 할 수 있나요?
아니요 GPS와 카메라 이미지가 함께 있어야 측위가 가능합니다.
400 Bad Request 응답을 수신합니다.
스캔 범위 밖에서 요청을 보내는 경우 400 응답을 수신할 수 있습니다. 스캔 범위 내에서 공간 인식을 진행해주세요.
VL 요청
1초에 몇 번 요청을 보내나요?
기본값은 공간 인식 전에는 250ms당 한 번, 공간 인식 후에는 1000ms당 한 번 요청을 보냅니다. 이 값은 VLSDKSettings.asset 파일을 통해 수정할 수 있습니다. 최소 요청 가능 주기는 250ms입니다.
요청을 보내는 이미지의 해상도는 몇인가요?
장축 640px의 이미지를 전송합니다.
앱을 사용하는 동안 항상 요청을 보내나요?
VLSDKManager의 StartSession()이 실행된 이후부터 특정 조건을 만족할 때까지 주기적으로 요청을 보냅니다. 특정 조건은 다음과 같습니다.
StopSession()을 호출한 경우- 기기가 상하 20도 각도로 기울어져 있는 경우
- 천장이나 바닥과 같이 VL을 수행하기 적합하지 않은 이미지를 이용한 불필요한 VL 요청 방지.
패키지 설치
"'VLSDK.bundle'을(를) 열지 않음" 메시지가 출력되고 Play mode 진입 시 에러 메시지가 출력됩니다.
해당 문제는 macOS 환경에서 Github의 ARCeyeVLSDK 저장소 프로젝트를 'Download ZIP'으로 다운로드 받은 뒤 실행할 때 출력되는 메시지입니다. macOS는 브라우저를 통해 다운로드 받은 실행 파일에 대한 보안 이슈를 대응하기 위해 Gatekeeper가 동작하기 때문입니다. 이 문제는 다음 둘 중 한 가지 방법을 사용해서 해결할 수 있습니다.
git clone https://github.com/NaverCloudPlatform/ARCeyeVLSDK.git을 통해 프로젝트 다운로드- 터미널을 통해 다음 명령어를 입력합니다.
xattr -dr com.apple.quarantine `${VLSDK 프로젝트 경로}/Assets/VLSDK/Core/Plugins/OSX/VLSDK.bundle`