Panduan Memulai Sceneform untuk Android

Menyiapkan lingkungan pengembangan

Membuka project contoh

Mendapatkan project contoh. Anda dapat:

  • Mendownload dan mengekstrak Contoh Sceneform

    -atau-

  • Clone repositori dengan perintah berikut:

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

Di Android Studio, buka project contoh Hello Sceneform, yang terletak di subdirektori app dalam direktori sceneform-android-sdk.

Menyiapkan perangkat atau emulator

Anda dapat menjalankan aplikasi AR di perangkat yang didukung atau di Android Emulator:

Ada persyaratan tambahan untuk menjalankan aplikasi Sceneform di emulator:

  • Anda memerlukan Android Emulator versi 27.2.9 atau yang lebih baru.

  • OpenGL ES 3.0 atau yang lebih tinggi harus didukung dan diaktifkan di Android Emulator.

    • Pastikan emulator Anda dikonfigurasi untuk menggunakan versi terbaru. Di panel Extended controls (Lainnya di Toolbar), pilih Settings > Advanced > OpenGL ES API level > Renderer maximum (up to OpenGL ES 3.1), lalu mulai ulang emulator.

    • Jalankan emulator, berinteraksi sebentar dengan perangkat yang diemulasikan, lalu periksa apakah OpenGL ES 3.0 atau yang lebih tinggi sedang digunakan:

      adb logcat | grep eglMakeCurrent

      Jika Anda melihat ver 3 0 atau versi yang lebih baru, Anda dapat menjalankan aplikasi Sceneform. Jika Anda melihat versi yang lebih rendah, berarti GPU desktop Anda tidak mendukung OpenGL ES 3.0 dan Anda harus menggunakan perangkat yang didukung untuk menjalankan aplikasi Sceneform.

Menjalankan contoh

Pastikan perangkat Android Anda terhubung ke komputer pengembangan, lalu klik Run di Android Studio. Kemudian, pilih perangkat Anda sebagai target deployment, lalu klik OK.

Android Studio membuat project Anda menjadi APK yang dapat di-debug, menginstal APK, lalu menjalankan aplikasi tersebut di perangkat. Untuk informasi selengkapnya, lihat Mem-build dan Menjalankan Aplikasi Anda.

Anda mungkin akan diminta untuk menginstal atau mengupdate Layanan Google Play untuk AR jika tidak ada atau sudah tidak berlaku. Pilih LANJUTKAN untuk menginstalnya dari Google Play Store.

Aplikasi Hello Sceneform memungkinkan Anda menempatkan dan memanipulasi figurin Android di permukaan datar.

Menambahkan Sceneform ke project yang sudah ada

Untuk menggunakan Sceneform dalam project yang sudah ada:

  1. Ikuti langkah-langkah untuk Mengaktifkan ARCore di aplikasi

  2. Tambahkan library Sceneform ke file build.gradle aplikasi:

    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'
}

Langkah berikutnya