Menambahkan lingkungan spasial ke aplikasi

Di Jetpack XR SDK, lingkungan spasial adalah lingkungan imersif yang dapat Anda tambahkan ke aplikasi untuk menyesuaikan latar belakang tampilan virtual. Lingkungan spasial hanya terlihat saat aplikasi berada dalam Ruang Penuh.

Ringkasan lingkungan spasial

SpatialEnvironment digunakan untuk mengelola preferensi lingkungan spasial aplikasi. Ini adalah gabungan dari gambar skybox mandiri dan geometri yang ditentukan glTF. Hanya satu gambar skybox dan satu file geometri glTF yang dapat ditetapkan sekaligus.

Skybox mewakili gambar yang dilihat pengguna di sekelilingnya dalam tampilan virtual, sehingga menciptakan ilusi lingkungan latar belakang yang jauh, seperti langit, pegunungan, atau lanskap kota. Pengguna tidak dapat berinteraksi dengan atau mendekati skybox. Jetpack XR SDK mendukung skybox sferis dalam standar OpenEXR. Selain memberikan latar belakang yang imersif untuk aplikasi Anda, skybox EXR juga memberikan pencahayaan berbasis gambar (IBL) ke model 3D yang dimuat oleh aplikasi Anda. Untuk informasi selengkapnya, lihat panduan untuk menggunakan model 3D.

Lingkungan spasial juga dapat menyertakan konten geometri 3D dalam standar glTF. Geometri lingkungan yang dimuat dengan cara ini akan otomatis disejajarkan dengan lantai dunia nyata. Geometri lingkungan adalah cara yang bagus untuk menambahkan realisme ke lingkungan Anda melalui elemen latar depan dan tengah yang menyatu dengan skybox dengan efek paralaks.

Dalam panduan desain untuk lingkungan spasial, Anda dapat mempelajari berbagai jenis aset yang dapat digunakan untuk membuat lingkungan spasial dan cara membuat lingkungan spasial yang aman dan menyenangkan.

Anda dapat menetapkan lingkungan spasial aplikasi ke salah satu dari tiga konfigurasi berikut:

  • Kombinasi gambar skybox dan geometri glTF.
  • Platform passthrough, dengan lingkungan yang ditampilkan adalah feed live dari kamera yang menghadap ke luar perangkat. Pada opasitas penuh, permukaan passthrough ini sepenuhnya menutupi skybox dan geometri.
  • Konfigurasi campuran, dengan permukaan passthrough tidak memiliki opasitas penuh, atau opasitas nol. Dalam hal ini, permukaan passthrough menjadi semi-transparan dan alfa menyatu dengan skybox dan geometri di belakangnya.

Kemampuan spasial untuk lingkungan spasial

Mengimpor dan memuat resource lingkungan spasial

Resource glTF dan EXR untuk lingkungan spasial dimuat secara asinkron dengan menggunakan class Session.

Membuat resource glTF

Resource glTF dapat dibuat sebagai GltfModel, tempat glTF dimuat dari file lokal. GltfModel dapat digunakan sebagai bagian dari lingkungan aplikasi spasial.

val environmentGeometryFuture = GltfModel.create(session, "DayGeometry.glb")
val environmentGeometry = environmentGeometryFuture.await()
Environments.kt

Membuat resource gambar EXR

Resource gambar EXR dapat dibuat sebagai ExrImage, dengan EXR dimuat dari file lokal. ExrImage dapat digunakan dengan cmgen untuk membuat file ZIP IBL untuk skybox Anda. Lihat panduan kami tentang mengoptimalkan aset lingkungan untuk mengetahui detail selengkapnya.

val lightingForSkybox = ExrImage.create(session, "BlueSkyboxLighting.zip")
Environments.kt

Menetapkan SpatialEnvironmentPreference untuk aplikasi Anda

setSpatialEnvironmentPreference digunakan untuk menetapkan lingkungan spasial yang diinginkan untuk aplikasi. Metode ini hanya menetapkan preferensi dan tidak menyebabkan perubahan langsung kecuali jika isSpatialEnvironmentPreferenceActive sudah benar. Setelah perangkat memasuki status tempat latar belakang XR dapat diubah dan kemampuan SpatialCapabilities.SPATIAL_CAPABILITY_APP_ENVIRONMENT tersedia, lingkungan spasial yang diinginkan untuk aplikasi akan ditampilkan secara otomatis.

Menetapkan preferensi ke null akan menonaktifkan lingkungan spasial pilihan untuk aplikasi, yang berarti lingkungan sistem default akan ditampilkan.

Jika SpatialEnvironmentPreference yang diberikan bukan null, tetapi semua propertinya bernilai null, lingkungan spasial akan terdiri dari skybox hitam dan tidak ada geometri.

Untuk mendapatkan notifikasi tentang perubahan pada status SpatialEnvironment, gunakan addOnSpatialEnvironmentChangedListener.

Penggunaan dasar

Cuplikan kode ini membuat geometri lingkungan dan resource skybox, lalu menetapkan preferensi lingkungan spasial. Preferensi ini akan diingat, dan akan diterapkan saat aplikasi memiliki kemampuan untuk menetapkan lingkungannya sendiri.

val spatialEnvironmentPreference =
    SpatialEnvironment.SpatialEnvironmentPreference(lightingForSkybox, environmentGeometry)
val preferenceResult =
    session.scene.spatialEnvironment.setSpatialEnvironmentPreference(spatialEnvironmentPreference)
if (preferenceResult == SpatialEnvironment.SetSpatialEnvironmentPreferenceChangeApplied()) {
    // The environment was successfully updated and is now visible, and any listeners
    // specified using addOnSpatialEnvironmentChangedListener will be notified.
} else if (preferenceResult == SpatialEnvironment.SetSpatialEnvironmentPreferenceChangePending()) {
    // The environment is in the process of being updated. Once visible, any listeners
    // specified using addOnSpatialEnvironmentChangedListener will be notified.
}
Environments.kt

Penggunaan lanjutan

Untuk kasus penggunaan lanjutan yang memerlukan kontrol yang lebih baik atas lingkungan, Anda dapat menggabungkan pemeriksaan SpatialCapabilities dan menerapkan addOnSpatialEnvironmentChangedListener untuk menentukan kapan Anda ingin menetapkan preferensi lingkungan spasial.

Menetapkan PassthroughOpacityPreference untuk lingkungan spasial untuk aplikasi Anda

Salah satu komponen latar belakang virtual imersif aplikasi adalah platform passthrough. Dalam hal ini, latar belakang yang ditampilkan adalah feed live dari kamera yang menghadap ke luar perangkat.

setPassthroughOpacityPreference digunakan untuk menetapkan opasitas passthrough yang diinginkan untuk aplikasi. Metode ini hanya menetapkan preferensi dan tidak menyebabkan perubahan langsung kecuali jika kemampuan SpatialCapabilities.SPATIAL_CAPABILITY_PASSTHROUGH_CONTROL tersedia. Setelah perangkat memasuki status saat opasitas passthrough dapat diubah, dan kemampuan SpatialCapabilities.SPATIAL_CAPABILITY_PASSTHROUGH_CONTROL tersedia, opasitas passthrough yang diinginkan untuk aplikasi akan otomatis diterapkan.

Nilai untuk preferensi opasitas passthrough berkisar dari 0.0f (opasitas nol, saat platform passthrough tidak terlihat) hingga 1.0f (opasitas penuh, saat platform passthrough menyembunyikan lingkungan spasial). Parameter setPassthroughOpacityPreference adalah float nullable. Menetapkan nilai ke null menunjukkan bahwa aplikasi tidak memiliki preferensi opasitas passthrough, dan akan menampilkan kontrol passthrough ke sistem.

Penggunaan dasar

Cuplikan kode ini menetapkan preferensi opasitas passthrough. Preferensi ini akan diingat, dan akan diterapkan saat aplikasi memiliki kemampuan untuk menetapkan opasitas passthrough.

val preferenceResult = session.scene.spatialEnvironment.setPassthroughOpacityPreference(1.0f)
if (preferenceResult == SpatialEnvironment.SetPassthroughOpacityPreferenceChangeApplied()) {
    // The passthrough opacity request succeeded and should be visible now, and any listeners
    // specified using addOnPassthroughOpacityChangedListener will be notified
} else if (preferenceResult == SpatialEnvironment.SetPassthroughOpacityPreferenceChangePending()) {
    // The passthrough opacity preference was successfully set, but not
    // immediately visible. The passthrough opacity change will be applied
    // when the activity has the
    // SpatialCapabilities.SPATIAL_CAPABILITY_PASSTHROUGH_CONTROL capability.
    // Then, any listeners specified using addOnPassthroughOpacityChangedListener
    // will be notified
}
Environments.kt

Penggunaan lanjutan

Untuk kasus penggunaan lanjutan yang memerlukan kontrol yang lebih baik atas opasitas passthrough, Anda dapat menggabungkan pemeriksaan SpatialCapabilities dan menambahkan pemroses menggunakan addOnPassthroughOpacityChangedListener untuk menentukan kapan Anda ingin menetapkan preferensi opasitas passthrough.

Pengoptimalan aset

Saat membuat aset untuk menetapkan SpatialEnvironment pengguna, pastikan aset Anda mencapai resolusi berkualitas tinggi sekaligus mempertahankan ukuran file yang wajar. Untuk mempelajari lebih lanjut, lihat panduan kami tentang mengoptimalkan aset Lingkungan.

Menentukan opasitas passthrough saat ini

val currentPassthroughOpacity = session.scene.spatialEnvironment.getCurrentPassthroughOpacity()
Environments.kt

Lihat juga