CRS 자주 묻는 질문

다음은 cloud image recognition 기능 사용 중 자주 묻는 질문과 답변입니다.

Q: CRS는 cloud에서 3D 모델/가상 콘텐츠 로드를 지원하나요?

A: 예. CRS는 다음 방식으로 3D 모델/가상 콘텐츠 로드를 지원합니다.

meta 속성: target image의 meta field에 AR 콘텐츠를 텍스트 파일 형식으로 저장합니다. 3D model은 Base64를 통해 텍스트로 encoding하거나 Alibaba Cloud OSS, AWS S3 같은 cloud storage URL로 저장할 수 있습니다.
로드 프로세스: 클라이언트가 CRS에서 meta 데이터를 가져온 후 Unity 또는 Three.js 같은 3D engine을 사용하여 model을 parsing하고 로드합니다.
참고 문서: Recognition target 생성 | POST /targets를 참조하십시오.

대용량 파일(>2MB)은 Base64 encoding으로 인해 request body가 너무 커지는 것을 피하기 위해 URL 방식을 사용하십시오.

Q: CRS에는 recognition 횟수 제한이 있나요?

A: 총 recognition 횟수 제한은 없지만 concurrency 등급이 있습니다.

기본 모드: QPS < 50인 애플리케이션에 적합합니다. 강제 제한은 없지만 fair use 원칙을 준수해야 합니다.
높은 concurrency 모드: QPS >= 50일 때는 recognition 안정성과 낮은 latency를 보장하기 위해 전용 resource cloud service로 업그레이드하는 것이 좋습니다.

애플리케이션이 공휴일이나 대형 이벤트 기간에 일시적인 concurrency 급증을 겪을 수 있다면, 반드시 최소 3영업일 전에 EasyAR 기술 지원에 연락하여 서비스 업그레이드를 신청하십시오.

Q: Web Service API가 404를 반환하는 이유는 무엇인가요?

A: 404 오류는 일반적으로 요청한 URL path가 존재하지 않거나 resource를 찾지 못했음을 의미합니다. 일반적인 원인은 다음과 같습니다.

URL 형식 오류: 존재하지 않는 endpoint에 접근했습니다. 예를 들어 http://your_crs_uuid.na1.crs.easyar.com:8888에 직접 접근하는 것은 유효하지 않습니다. http://your_crs_uuid.na1.crs.easyar.com:8888/ping 같은 완전한 endpoint를 사용해야 합니다.
Recognition result 비어 있음: /search interface 호출 시 일치하는 target이 없으면 404도 반환되며, message body는 No result: there is no matching입니다.

Troubleshooting 단계:

해결 제안: /search가 404를 반환하면 현재 이미지가 어떤 target에도 hit되지 않았다는 의미입니다. 사용자에게 촬영 각도를 조정하도록 안내하거나 target이 CRS에 업로드되었는지 확인할 수 있습니다.

Q: 일반적인 Web Service API 오류 response code의 원인은 무엇인가요?

A: 404 외에도 다음 오류 코드가 자주 발생합니다.

400 invalid appId (appKey)
- 원인: 요청한 Key가 올바르지 않거나 signature 검증에 실패했습니다.
- Troubleshooting: Key가 CRS image library에서 복사한 것인지, POST request에 완전한 signature가 포함되어 있는지, request parameter가 Content-Type: application/json을 사용하는지 확인합니다.
400 invalid date
- 원인: request timestamp가 유효하지 않거나 서버 시간과 차이가 너무 큽니다. 일반적으로 +/-5분 이내여야 합니다.
- Troubleshooting: 디바이스 시간이 정확한지 확인합니다. 특히 time zone 설정에 주의하십시오.
415 unsupported media type
- 원인: HTTP Header에 Content-Type: application/json이 설정되지 않았거나 request body 형식이 잘못되었습니다.
- Troubleshooting: POST request의 Header에 Content-Type: application/json이 포함되어 있고 Body가 유효한 JSON인지 확인합니다.

일반 제안: 모든 CRS API request는 CRS API 문서를 엄격히 따라야 합니다.

설명: 위 FAQ는 CRS 사용 중 자주 발생하는 문제를 다룹니다. 새로운 문제를 보고해야 하는 경우 피드백을 보내고 문의하기를 이용해 주십시오.