Android용 Aspectform 빠른 시작

개발 환경 설정

샘플 프로젝트 열기

샘플 프로젝트를 가져옵니다. 대신 다음 중 원하는 방법을 선택합니다.

  • 장면 샘플 다운로드 및 추출

    -또는-

  • 다음 명령어를 사용하여 저장소를 클론합니다.

    git clone https://github.com/google-ar/sceneform-android-sdk.git

Android 스튜디오에서 sceneform-android-sdk 디렉터리 내 app 하위 디렉터리에 있는 Hello Sceneform 샘플 프로젝트를 엽니다.

기기 또는 에뮬레이터 준비

지원되는 기기 또는 Android Emulator에서 AR 앱을 실행할 수 있습니다.

에뮬레이터에서 sceneform 앱을 실행하기 위한 추가 요구사항이 있습니다.

  • Android Emulator 버전 27.2.9 이상이 필요합니다.

  • Android Emulator에서 OpenGL ES 3.0 이상이 지원되고 사용 설정되어야 합니다.

    • 에뮬레이터가 최신 버전을 사용하도록 구성되어 있는지 확인합니다. Extended controls 패널(툴바의 더보기)에서 Settings > Advanced > OpenGL ES API level >Renderer max (up to OpenGL ES 3.1)를 선택한 다음 에뮬레이터를 다시 시작합니다.

    • 에뮬레이터를 실행하고 에뮬레이션된 deivce와 잠시 상호작용한 후 OpenGL ES 3.0 이상이 사용되고 있는지 확인합니다.

      adb logcat | grep eglMakeCurrent

      ver 3 0 이상의 버전이 있다면 장면 양식 앱을 실행할 수 있습니다. 하위 버전이 표시되면 데스크톱 GPU가 OpenGL ES 3.0을 지원하지 않는 것이며, 지원되는 기기를 사용하여 장면 양식 앱을 실행해야 합니다.

샘플 실행

Android 기기가 개발 머신에 연결되어 있는지 확인하고 Android 스튜디오에서 Run 을 클릭합니다. 그런 다음 기기를 배포 대상으로 선택하고 OK를 클릭합니다.

Android 스튜디오는 프로젝트를 디버그 가능한 APK로 빌드하고, APK를 설치한 다음, 기기에서 앱을 실행합니다. 자세한 내용은 앱 빌드 및 실행을 참고하세요.

Google Play AR 서비스가 누락되거나 오래된 경우 설치하거나 업데이트하라는 메시지가 표시될 수 있습니다. 계속을 선택하여 Google Play 스토어에서 설치합니다.

Hello 양식 양식 앱을 사용하면 평평한 표면에 Android 피규어를 배치하고 조작할 수 있습니다.

기존 프로젝트에 장면 양식 추가

기존 프로젝트에서 장면 양식을 사용하는 방법은 다음과 같습니다.

  1. 앱에 ARCore를 사용 설정하는 단계를 따릅니다.

  2. app build.gradle 파일에 Sceneform 라이브러리를 추가합니다.

    android {
    // Sceneform libraries use language constructs from Java 8.
    // Add these compile options if targeting minSdkVersion < 26.
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

dependencies {
    …

    // Provides ArFragment, and other UX resources.
    implementation 'com.google.ar.sceneform.ux:sceneform-ux:1.15.0'

    // Alternatively, use ArSceneView without the UX dependency.
    implementation 'com.google.ar.sceneform:core:1.15.0'
}

다음 단계