Table of Contents

Running EasyAR Android samples

이 문서는 EasyAR에서 제공하는 네이티브 Android 샘플을 실행하는 방법을 설명합니다. 여기서는 HelloAR을 예로 들어 샘플 실행 방법을 소개하며, 다른 샘플도 이 문서를 참고하여 사용할 수 있습니다.

준비 작업

  • 시작하기 전에 다음 환경을 준비했는지 확인하세요:

    • Android Studio 2025.1.2 이상
    • JDK 17
    • Android NDK r28
    • Android 휴대폰
  • EasyAR Sense 네이티브 샘플 다운로드 후 압축 해제

  • EasyAR 개발 센터(중국어 사이트 / 영어 사이트)에서 License Key 획득. 패키지명이 샘플과 일치해야 함(예: HelloAR은 cn.easyar.samples.helloar)

샘플 가져오기 및 컴파일

  1. Android Studio 메뉴에서 File -> New -> Import Project... 순서로 선택한 후 샘플 디렉터리를 선택하여 가져옵니다. Android Studio가 다운로드 및 구성을 완료할 때까지 기다립니다.
    importhelloar

  2. 라이선스(License Key) 설정
    ARActivity.java 경로를 찾아 코드 안내에 따라 개발 센터에서 얻은 License Key를 입력합니다.
    fillkey

  3. 컴파일 및 실행
    휴대폰을 컴퓨터에 연결하고 실행 버튼을 클릭한 후 휴대폰에서 실행하라는 메시지에 따라 진행합니다.
    buildandrun

HelloAR은 평면 이미지 인식 및 추적 기능과 가상 객체를 오버레이하는 기능을 구현합니다. 샘플에서 인식 이미지는 assets/sightplus 경로에서 찾을 수 있습니다.

HelloAR 샘플 실행 효과는 다음과 같습니다.
rungif

관련 읽을거리