Crs 자주 묻는 질문

이미지 클라우드 인식 기능 사용 중 자주 묻는 질문과 답변입니다.

Q: Crs는 클라우드에서 3D 모델/가상 콘텐츠를 로드할 수 있나요?

A: 예, Crs는 다음 방식을 통해 3D 모델/가상 콘텐츠를 로드할 수 있습니다:

meta 속성: 대상 이미지의 meta 필드에 AR 콘텐츠를 텍스트 파일 형식으로 저장합니다. 3D 모델은 Base64로 인코딩하거나 클라우드 스토리지 URL(예: Alibaba Cloud OSS, AWS S3)로 저장할 수 있습니다.
로드 절차: 클라이언트가 Crs에서 meta 데이터를 획득한 후, 3D 엔진(Unity, Three.js 등)으로 모델을 파싱 및 로드합니다.
참고 문서: 자세한 내용은 인식 대상 생성 | POST /targets를 참조하세요.

대용량 파일(>2MB)은 Base64 인코딩으로 인한 요청 본문 과다를 피하려면 URL 방식을 사용하세요.

Q: Crs에는 인식 횟수 제한이 있나요?

A: 총 인식 횟수 제한은 없으나 동시 처리량에 따라 등급이 구분됩니다:

휴일 또는 대형 행사 기간에 동시 접속량이 급증할 수 있는 애플리케이션은 반드시 최소 3영업일 전에 EasyAR 기술 지원팀에 연락하여 서비스 업그레이드를 신청하세요.

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

A: 404 오류는 일반적으로 요청한 URL 경로가 존재하지 않거나 리소스를 찾을 수 없음을 의미하며, 흔한 원인은 다음과 같습니다:

URL 형식 오류: 존재하지 않는 엔드포인트에 접근했습니다. 예: http://your_crs_uuid.na1.crs.easyar.com:8888 직접 접근은 무효하며, http://your_crs_uuid.na1.crs.easyar.com:8888/ping 같은 완전한 엔드포인트를 사용해야 합니다.
인식 결과 없음: /search 인터페이스 호출 시 일치하는 대상이 없으면 404를 반환하며 메시지 본문은 No result: there is no matching입니다.

점검 절차:

해결 권장: /search가 404를 반환하면 현재 이미지가 대상을 인식하지 못한 것이므로 사용자에게 촬영 각도를 조정하도록 안내하거나 Crs에 대상 업로드 여부를 점검하세요.

Q: 흔한 Web Service API 오류 반환 코드의 원인은 무엇인가요?

A: 404 외에 다음과 같은 오류 코드가 흔히 발생합니다:

400 invalid appId (appKey)
- 원인: 요청한 Key가 올바르지 않거나 서명 검증에 실패했습니다.
- 점검: Key가 Crs 이미지 라이브러리 내에서 복사되었는지 확인하세요. POST 요청에 완전한 서명이 포함되었는지, 요청 매개변수가 Content-Type: application/json을 사용하는지 점검하세요.
400 invalid date
- 원인: 요청 타임스탬프가 유효하지 않거나 서버 시간과 과도하게 차이납니다(보통 ±5분 이내 요구).
- 점검: 장치 시간이 정확한지 점검하세요(특히 시간대 설정에 유의).
415 unsupported media type
- 원인: HTTP Header에 Content-Type: application/json이 설정되지 않았거나 요청 본문 형식이 잘못되었습니다.
- 점검: POST 요청의 Header에 Content-Type: application/json이 포함되고, Body가 유효한 JSON인지 확인하세요.

일반 권장: 모든 Crs API 요청은 Crs API 문서를 엄격히 따라야 합니다.

설명: 본 FAQ는 Crs 사용 중 빈번히 발생하는 문제를 다루고 있습니다. 새로운 문제를 보고하려면 피드백을 보내주시고 문의하기를 이용해 주세요!