타겟 이미지 관리

타겟 이미지(Targets)는 다음 두 가지 방법으로 관리할 수 있습니다.

클라우드 인식 서비스에서 타겟 이미지 관리와 이미지 인식은 서로 다른 요구사항이며, API는 서로 다른 두 개의 Cloud URL 엔드포인트에 해당합니다.

이미지 라이브러리가 실행되는 데이터센터는 다음 지역에서 선택할 수 있습니다.

방법1: EasyAR 개발센터에서 타겟 이미지 관리

소규모 테스트 또는 수동 빠른 업로드에 적합합니다. 단계는 다음과 같습니다.

대량의 타겟 이미지를 처리해야 하는 애플리케이션의 경우, Web Service REST API를 사용하여 자체 애플리케이션 또는 관리 백엔드에서 자동화된 워크플로우를 구현하는 것이 좋습니다.

다음은 준비해야 할 목록입니다. 타겟 이미지를 관리하기 전에 새로운 클라우드 인식 데이터베이스 인스턴스(Cloud Database)를 준비해야 합니다.

CRS AppId
API Key / API Secret 또는 Token
Cloud URL
- Server-end URL: 타겟 이미지 관리 URL 주소, https 사용 시 443 포트
- Client-end URL: 이미지 인식 서비스 URL 주소, https 사용 시 8443 포트

포트 구분 설명: 타겟 관리 API 엔드포인트(443)와 모바일/Unity에서 호출하는 클라우드 인식 API 엔드포인트(8443)는 서로 다른 채널입니다. 구성 시 반드시 구분하십시오.

m1-appid

m1-apikey

아직 API Key가 없으면 APIKey를 생성하고, 반드시 클라우드 인식(CRS) 권한을 선택해야 합니다. API Key 및 권한 제어에 대한 자세한 내용은 주제 API Key 소개를 참조하세요.

m1-apikey-cr

m1-token

Token의 유효기간을 사용자 정의해야 하는 경우, 원본 APIKey와 APISecret을 사용하여 Token을 생성하는 UAC API —— Token 생성 방식을 참조할 수 있습니다.

Cloud URL 확인 방법:
이미지 라이브러리에서 타겟 이미지 관리에 사용되는 것은 Server-end URL 443 포트, Server-end URL입니다.
개발센터 -> 클라우드 인식 관리 -> 이미지 라이브러리 선택 -> 관리 -> 키 -> 이미지 라이브러리 관리

m1-server-url

실제 워크플로우에서 타겟 이미지 관리는 일반적으로 개발자의 비즈니스 서버, 모바일 또는 Unity에 통합됩니다.

비즈니스 플랫폼: 일반적인 서버 개발 언어(Curl/Java/NodeJS/PHP)로 API를 호출하는 샘플 코드를 제공하여 개발자가 타겟 이미지 자동 업로드 및 메타데이터(Meta) 업데이트를 구현할 수 있도록 돕습니다.
모바일(Unity/Mobile): Unity 기반의 타겟 이미지 관리 샘플 코드를 제공합니다. 개발자는 직접 촬영하여 타겟 이미지를 업로드하는 방식을 구현할 수 있습니다.

샘플 코드 실행

아래는 Java 샘플 코드 사용 예시입니다. 샘플 코드에 자신의 준비 목록 항목을 입력한 후 Main을 실행합니다.

m1-java