Table of Contents

타겟 이미지 관리

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

  • 시각적 관리: EasyAR Developer Center에 로그인하여 수동으로 유지 관리합니다.
  • API 자동화 관리: Web Service REST API를 호출하여 자체 비즈니스 시스템 또는 management backend에 통합합니다.
중요

cloud recognition 서비스에서 타겟 이미지 관리와 image recognition은 서로 다른 두 요구 사항이며, API는 두 개의 서로 다른 Cloud URL entry에 대응합니다.

data center region 선택

image library 실행 예제가 위치한 data center는 다음 region 선택을 지원합니다.

  • China-Shanghai
  • US-Silicon Valley

방법 1: EasyAR Developer Center에서 타겟 이미지 관리

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

  1. EasyAR Developer Center에 로그인하고 Cloud Recognition Management로 들어갑니다.
  2. 타겟 region을 선택합니다. 아직 image library를 만들지 않았다면 먼저 새로 만들고 cloud recognition image library를 활성화하십시오.
  3. image library 목록에서 Manage를 클릭하면 타겟 이미지 유지 관리 화면으로 들어가 업로드, 수정 또는 삭제할 수 있습니다.

create-web

방법 2: REST API를 사용한 자동화 관리

많은 타겟 이미지를 처리해야 하는 애플리케이션의 경우, Web Service REST API를 사용하여 애플리케이션 또는 management backend에서 자동화 workflow를 구현하는 것을 권장합니다.

준비 체크리스트

다음은 준비해야 할 체크리스트입니다. 타겟 이미지 관리를 시작하기 전에 새로운 cloud recognition database instance(Cloud Database)를 준비해야 합니다.

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

포트 구분 설명: 타겟 관리 API entry(443)와 mobile/Unity가 호출하는 cloud recognition API entry(8443)는 서로 다른 두 channel입니다. 구성 시 반드시 구분하십시오.

체크리스트 각 항목을 얻는 방법

  • CRS AppId 확인 방법:
    Developer Center -> Cloud Recognition Management -> Select image library -> Manage -> Key

m1-appid

  • API Key / API Secret 확인 방법:
    Developer Center -> Cloud Service APIKey -> Copy

m1-apikey

    아직 API Key가 없다면 APIKey를 만들고 cloud recognition(CRS) permission을 반드시 선택하십시오. API Key 및 permission control에 대해 더 알아보려면 API Key 소개를 참고하십시오.

m1-apikey-cr

  • Token 확인 방법:
    Developer Center -> Cloud Service APIKey -> Manage -> Select validity period -> Generate Token -> Copy

m1-token

    Token의 유효 기간을 사용자 지정해야 하는 경우 UAC API - Token 생성을 참고하여 원본 APIKey와 APISecret으로 Token을 만들 수 있습니다.

  • Cloud URL 확인 방법:
    image library의 타겟 이미지 관리는 Server-end URL 443 포트, Server-end URL을 사용합니다
    Developer Center -> Cloud Recognition Management -> Select image library -> Manage -> Key -> Image Library Management

m1-server-url

멀티 엔드 통합 가이드

실제 workflow에서 타겟 이미지 관리는 일반적으로 개발자의 비즈니스 서버, mobile end 또는 Unity에 통합됩니다.

  • 비즈니스 서비스 플랫폼: 일반적인 서버 개발 언어(Curl/Java/NodeJS/PHP)의 API 호출 예제 코드를 제공하여, 개발자가 타겟 이미지 자동 업로드와 metadata(Meta) 업데이트를 구현하도록 돕습니다.

  • Mobile end(Unity/Mobile): Unity 기반 타겟 이미지 관리 예제 코드를 제공하며, 개발자가 직접 사진을 촬영하고 타겟 이미지를 업로드하는 방식을 구현할 수 있습니다.

예제 코드 실행

아래 그림은 Java 예제 코드 사용을 보여줍니다. 예제 코드에 자신의 준비 체크리스트 각 항목을 입력한 다음 Main을 실행합니다.

m1-java

관련 주제:

다음 주제:

참고

실제 workflow에서 타겟 이미지를 생성할 때는 best practices를 따르고 주의 깊게 읽는 것을 권장합니다.