Mengakses sesi untuk membuat UI dan entitas yang dispatialisasi

Perangkat XR yang kompatibel
Panduan ini membantu Anda membangun pengalaman untuk jenis perangkat XR ini.
Mempelajari jenis perangkat XR →
Headset XR
Kacamata XR Berkabel
Mempelajari jenis perangkat XR →

Session menyediakan antarmuka utama untuk fungsi spasial bagi aplikasi Anda. Setiap Activity spasial harus membuat dan menyimpan instance Session. Setelah membuat sesi, aplikasi Anda dapat menggunakan antarmuka Session untuk membuat entity konten spasial seperti panel atau model 3D, serta menetapkan lingkungan spasial, mengidentifikasi posisi pengguna, dan menautkan konten ke dunia nyata.

Mengakses sesi dari Jetpack Compose untuk XR

Saat menggunakan Jetpack Compose untuk XR, sesi akan dibuat untuk Anda dan dapat diakses menggunakan LocalSession.current. Lihat contoh berikut:

@Composable
fun ComposableUsingSession() {
    val session = LocalSession.current
}

Mengakses sesi dari Jetpack XR Runtime

Jika membuat entity spasial dari library Jetpack SceneCore, Anda harus membuat sesi.

Untuk membuat sesi, teruskan [Context] ke create() metode. Ini Context dapat berupa Activity di perangkat XR Imersif atau perangkat seluler, atau konteks yang diproyeksikan.

Membuat sesi ARCore dapat menjadi tugas yang mahal, dan harus di proses di latar belakang, seperti yang ditunjukkan dalam contoh berikut:

when (val result = Session.create(context)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}

Saat aktivitas sesi dihancurkan, semua UI spasial dan konten 3D yang terkait dengan sesi tersebut akan dihancurkan dan sesi tidak lagi valid.

Lihat juga