Session
menyediakan antarmuka utama untuk fungsi spasial
untuk aplikasi. Setiap Aktivitas yang di-spatialisasi harus membuat dan menyimpan instance
Sesi. Setelah dibuat, aplikasi dapat menggunakan antarmuka Sesi untuk
membuat entitas konten spasial seperti panel atau model 3D, serta
menetapkan lingkungan spasial,
mengidentifikasi posisi pengguna,
dan mengikat konten ke dunia nyata.
Mengakses Sesi dari Jetpack Compose untuk XR
Saat menggunakan Jetpack Compose untuk XR, sesi dibuat untuk Anda dan dapat
diakses menggunakan LocalSession.current
. Lihat contoh berikut:
import androidx.xr.compose.platform.LocalSession
class myActivity : Activity() {
val xrSession = checkNotNull(LocalSession.current)
}
Mengakses Sesi dari Jetpack SceneCore
Jika membuat entity yang di-spatialisasi dari library SceneCore, Anda harus membuat instance sesi sendiri.
Pembuatan sesi hanya didukung di perangkat Android XR. Saat ini, jika
Anda membuat Session
dan mencoba menggunakannya di perangkat non-Android XR, Anda akan mendapatkan
NullPointerException
.
Anda hanya dapat membuat satu sesi per aktivitas. Untuk membuat sesi, teruskan
aktivitas ke metode create
, seperti yang ditunjukkan dalam contoh berikut.
Mencoba membuat sesi di perangkat yang tidak kompatibel dapat menampilkan error
runtime.
import androidx.xr.scenecore.Session
class myActivity : Activity() {
val xrSession = Session.create(this)
}
Saat aktivitas sesi dihancurkan, semua UI spasial dan konten 3D yang terkait dengan sesi tersebut akan dihancurkan dan sesi tidak lagi valid.
Lihat juga
- Memeriksa kemampuan spasial
- Transisi antara HSM dan FSM
- Menambahkan lingkungan spasial ke aplikasi Anda
- Menambahkan model 3D ke aplikasi Anda