Android Studio

Integrasi ARCore di Android Studio: Membangun Pengalaman Augmented Reality yang Imersif
Android Studio

Integrasi ARCore di Android Studio untuk Aplikasi AR Imersif

PPLG

PPLG

Penulis
07 May 2026
38 x dilihat

Augmented Reality (AR) bukan lagi sekadar fiksi ilmiah, melainkan teknologi yang semakin meresap ke dalam kehidupan kita, mulai dari game hingga aplikasi utilitas. Android, dengan ekosistemnya yang luas, menjadi platform ideal untuk menghadirkan pengalaman AR yang memukau melalui ARCore. Sebagai instruktur senior dan pakar industri Android Studio, artikel ini akan memandu Anda, para developer, dalam mengintegrasikan ARCore untuk menciptakan aplikasi AR yang imersif dan inovatif.

Memahami Konsep Inti ARCore

Sebelum terjun ke implementasi, mari pahami fundamental ARCore. ARCore adalah platform Google untuk membangun pengalaman Augmented Reality. Ia bekerja dengan mendeteksi dan melacak posisi serta orientasi perangkat Anda di dunia nyata, memetakan lingkungan sekitar, dan memungkinkan Anda menempatkan objek virtual secara realistis.

Komponen utama ARCore yang perlu Anda ketahui:

  • Motion Tracking: ARCore menggunakan sensor perangkat (kamera, IMU) untuk memahami posisi dan orientasi perangkat Anda di dunia. Ini memungkinkan objek virtual untuk tetap berada di tempatnya saat Anda bergerak.
  • Environmental Understanding: ARCore mendeteksi fitur-fitur di lingkungan Anda, seperti permukaan datar (lantai, meja) dan titik-titik fitur (sudut dinding, tekstur). Informasi ini krusial untuk menempatkan objek virtual.
  • Light Estimation: ARCore menganalisis pencahayaan di dunia nyata dan menerapkannya pada objek virtual, membuatnya terlihat lebih menyatu dengan lingkungan.

Persiapan Lingkungan Pengembangan

Untuk memulai, pastikan Anda memiliki:

  1. Android Studio: Versi terbaru sangat direkomendasikan.
  2. Perangkat Android yang Kompatibel dengan ARCore: Perangkat Anda harus mendukung ARCore. Daftar perangkat yang didukung dapat ditemukan di situs resmi ARCore.
  3. Google Play Services for AR: Aplikasi ini perlu terinstal di perangkat Anda. Biasanya, ini diinstal secara otomatis saat Anda menjalankan aplikasi ARCore pertama kali.

Langkah-Langkah Integrasi ARCore di Android Studio

Mari kita mulai membangun aplikasi AR sederhana.

1. Membuat Proyek Baru

Buka Android Studio, pilih "Start a new Android Studio project". Pilih template "Empty Activity". Beri nama proyek Anda (misalnya, ARCoreDemo) dan klik "Finish".

2. Menambahkan Dependensi ARCore

Buka file build.gradle (app) dan tambahkan dependensi ARCore:

dependencies {
    // ... dependensi lain
    implementation 'com.google.ar:core-sdk-preview:1.30.0' // Ganti dengan versi terbaru jika tersedia
}

Sinkronkan proyek Anda dengan Gradle (File > Sync Project with Gradle Files).

3. Mengaktifkan ARCore di Manifest

Buka AndroidManifest.xml dan tambahkan elemen <uses-feature> untuk ARCore dan izin kamera:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <uses-permission android:name="android.permission.CAMERA" />

    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.ARCoreDemo"
        tools:targetApi="31">

        <meta-data
            android:name="com.google.ar.core"
            android:value="required" /> <!-- atau "optional" jika AR bukan fitur utama -->

        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>
  • android:value="required" berarti aplikasi Anda memerlukan ARCore agar bisa berjalan.
  • android:value="optional" memungkinkan aplikasi berjalan meskipun ARCore tidak tersedia, namun Anda perlu menangani kasus ini.

4. Menyiapkan GLSurfaceView

ARCore memerlukan GLSurfaceView untuk merender grafik. Buka layout activity Anda (activity_main.xml) dan tambahkan ArFragment atau GLSurfaceView kustom. Menggunakan ArFragment adalah cara termudah untuk memulai karena ia menangani banyak konfigurasi awal.

Tambahkan ArFragment ke layout:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <fragment
        android:id="@+id/arFragment"
        android:name="com.google.ar.core.codelab.common.ArFragment"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

Jika Anda menggunakan ArFragment, Anda tidak perlu mengkonfigurasi GLSurfaceView secara manual di MainActivity.

5. Menangani Izin Kamera dan Konfigurasi AR

Di MainActivity.java (atau Kotlin), Anda perlu meminta izin kamera jika belum diberikan dan menginisialisasi sesi AR.

Contoh Kode (Java):

package com.example.arcoredemo;

import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Bundle;
import android.widget.Toast;

import com.google.ar.core.ArCoreApk;
import com.google.ar.core.Session;
import com.google.ar.core.exceptions.CameraNotAvailableException;
import com.google.ar.core.exceptions.UnavailableApkTooOldException;
import com.google.ar.core.exceptions.UnavailableArcoreNotInstalledException;
import com.google.ar.core.exceptions.UnavailableSdkTooOldException;
import com.google.ar.core.exceptions.UnavailableUserDeclinedInstallationException;
import com.google.ar.sceneform.ArSceneView;

public class MainActivity extends AppCompatActivity {

    private static final int CAMERA_PERMISSION_CODE = 0;
    private ArSceneView arSceneView;
    private Session session;
    private boolean installRequested;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        arSceneView = findViewById(R.id.arSceneView); // Pastikan Anda memiliki ArSceneView di layout jika tidak pakai ArFragment

        // Memeriksa dan meminta izin kamera
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.CAMERA},
                    CAMERA_PERMISSION_CODE);
        } else {
            setupSession();
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
                == PackageManager.PERMISSION_GRANTED) {
            setupSession();
        } else {
            Toast.makeText(this, "Kamera diperlukan untuk pengalaman AR.", Toast.LENGTH_LONG).show();
            finish();
        }
    }

    private void setupSession() {
        try {
            // Periksa apakah ARCore sudah terinstal dan dapat digunakan
            ArCoreApk.Availability availability = ArCoreApk.checkAvailability(this);
            if (availability.isUnsupported()) {
                Toast.makeText(this, "Perangkat ini tidak mendukung AR.", Toast.LENGTH_LONG).show();
                finish();
                return;
            }

            if (availability.isTransient()) {
                // Coba lagi nanti jika statusnya sementara
                arSceneView.postDelayed(() -> setupSession(), 500);
                return;
            }

            // Buat sesi AR
            session = new Session(this);
            arSceneView.setupSession(session);

            // Tambahkan konfigurasi sesi AR, misalnya untuk melacak permukaan
            com.google.ar.core.Config config = new com.google.ar.core.Config(session);
            config.setPlaneFindingMode(com.google.ar.core.Config.PlaneFindingMode.HORIZONTAL_AND_VERTICAL); // Aktifkan deteksi permukaan
            session.configure(config);

            // Mulai sesi
            session.resume();
            arSceneView.resume();

        } catch (UnavailableArcoreNotInstalledException e) {
            Toast.makeText(this, "ARCore belum terinstal.", Toast.LENGTH_LONG).show();
            if (!installRequested) {
                ArCoreApk.requestInstall(this, !installRequested);
                installRequested = true;
            }
        } catch (UnavailableUserDeclinedInstallationException e) {
            Toast.makeText(this, "Instalasi ARCore ditolak oleh pengguna.", Toast.LENGTH_LONG).show();
            finish();
        } catch (UnavailableApkTooOldException e) {
            Toast.makeText(this, "Versi ARCore terlalu tua.", Toast.LENGTH_LONG).show();
            finish();
        } catch (UnavailableSdkTooOldException e) {
            Toast.makeText(this, "SDK Android terlalu tua.", Toast.LENGTH_LONG).show();
            finish();
        } catch (CameraNotAvailableException e) {
            Toast.makeText(this, "Kamera tidak tersedia.", Toast.LENGTH_LONG).show();
            finish();
        }
    }

    @Override
    protected void onResume() {
        super.onResume();
        if (session != null) {
            try {
                session.resume();
                arSceneView.resume();
            } catch (CameraNotAvailableException e) {
                Toast.makeText(this, "Kamera tidak tersedia.", Toast.LENGTH_LONG).show();
                session = null; // Reset sesi jika kamera tidak tersedia
            }
        }
    }

    @Override
    protected void onPause() {
        super.onPause();
        if (session != null) {
            session.pause();
            arSceneView.pause();
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (session != null) {
            session.close();
            session = null;
        }
    }
}

Catatan Penting:

  • Jika Anda menggunakan ArFragment, banyak dari kode di atas (setup sesi, konfigurasi, penanganan izin) sudah ditangani secara otomatis. Anda hanya perlu fokus pada apa yang ingin Anda tampilkan di AR.
  • ArSceneView dan Sceneform adalah pustaka yang sering digunakan bersama ARCore untuk mempermudah rendering objek 3D. Jika Anda tidak menggunakan ArFragment, Anda perlu menyiapkan ArSceneView dan Sceneform secara manual.

6. Menambahkan Objek Virtual (Menggunakan Sceneform)

Sceneform adalah pustaka di atas ARCore yang memudahkan penambahan dan manipulasi objek 3D. Jika Anda menggunakan ArFragment, Sceneform biasanya sudah terintegrasi.

Untuk menambahkan objek, Anda biasanya akan mendengarkan HitResult saat pengguna mengetuk layar. HitResult memberitahu Anda di mana di dunia nyata (berdasarkan data ARCore) ketukan pengguna terjadi.

// Dalam MainActivity atau fragment Anda, setelah setupSession()
ArFragment arFragment = (ArFragment) getSupportFragmentManager().findFragmentById(R.id.arFragment);

arFragment.setOnTapArPlaneListener((HitResult hitResult, Plane plane, MotionEvent motionEvent) -> {
    // Dapatkan anchor dari hit result
    Anchor anchor = hitResult.createAnchor();

    // Muat model 3D (misal, dari file .glb atau .gltf)
    // Anda perlu menyiapkan asset/model Anda di direktori 'assets'
    ModelRenderable.builder()
            .setSource(this, R.raw.your_3d_model) // Ganti your_3d_model dengan nama file model Anda
            .build()
            .thenAccept(renderable -> addModelToScene(renderable, anchor))
            .exceptionally(throwable -> {
                Toast.makeText(this, "Gagal memuat model", Toast.LENGTH_SHORT).show();
                return null;
            });
});

private void addModelToScene(ModelRenderable renderable, Anchor anchor) {
    // Buat node untuk objek 3D
    AnchorNode anchorNode = new AnchorNode(anchor);
    anchorNode.setRenderable(renderable);

    // Tambahkan node ke scene (ArFragment menyediakan akses ke Scene)
    arFragment.getArSceneView().getScene().addChild(anchorNode);
}

Format Model 3D: Sceneform mendukung format .glb dan .gltf. Anda perlu menempatkan file model 3D Anda di direktori assets di proyek Anda dan merujuknya menggunakan R.raw.nama_file_model.

Tips Praktis yang Jarang Diketahui Pemula

  • Optimalisasi Model 3D: Model 3D yang terlalu kompleks dapat memperlambat performa aplikasi AR. Gunakan alat seperti Blender untuk mengoptimalkan jumlah poligon dan ukuran tekstur.
  • Deteksi Permukaan yang Akurat: Pastikan aplikasi Anda memberikan umpan balik visual yang jelas kepada pengguna tentang kapan permukaan terdeteksi. Ini membantu pengguna menempatkan objek dengan benar.
  • Manajemen Sesi AR yang Efisien: Gunakan onResume() dan onPause() dengan benar untuk memulai dan menghentikan sesi AR. Ini menghemat daya baterai dan sumber daya perangkat.
  • Penanganan Kesalahan yang Baik: Selalu siapkan blok try-catch untuk menangani pengecualian yang mungkin terjadi saat bekerja dengan ARCore, seperti perangkat yang tidak kompatibel atau masalah kamera.
  • Gunakan ArFragment untuk Memulai: Meskipun memahami detail teknis itu penting, ArFragment adalah cara tercepat dan termudah untuk mulai membangun aplikasi AR tanpa kerumitan konfigurasi awal.
  • Uji di Perangkat Nyata: Simulator AR tidak dapat menggantikan pengujian pada perangkat ARCore yang sebenarnya. Selalu uji aplikasi Anda di berbagai perangkat untuk memastikan kompatibilitas dan performa.
  • AnchorNode untuk Stabilitas: Menggunakan AnchorNode yang terhubung ke Anchor yang dibuat dari HitResult akan membuat objek virtual tetap terikat pada titik di dunia nyata, bahkan saat perangkat bergerak.

Kesimpulan

Mengintegrasikan ARCore di Android Studio membuka gerbang menuju dunia pengalaman digital yang imersif. Dengan pemahaman yang kuat tentang konsep intinya, persiapan lingkungan yang tepat, dan implementasi langkah demi langkah, Anda siap untuk mulai menciptakan aplikasi AR yang menakjubkan. Ingatlah untuk terus berlatih, bereksperimen, dan memanfaatkan tips praktis untuk terus meningkatkan kualitas aplikasi Anda. Selamat membangun masa depan AR!

0.0

Berikan Rating

Komentar (0)

Silakan login untuk memberikan komentar.

Login Sekarang

Belum ada komentar. Jadilah yang pertama!

Kata Kunci

#ARCore #Android Studio #Augmented Reality #AR Android #Sceneform #Pengembangan AR #Tutorial ARCore #Aplikasi AR #Mobile AR #Pengalaman Imersif

Pembaca (3)

Fauzan A Mahanani
Fauzan A Mahanani (11x)
FAIRUZ AGHNA MULYA
FAIRUZ AGHNA MULYA (1x)
Zaenal Andhika Pratama
Zaenal Andhika Pratama (4x)