Komponen yang dispasialisasi

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

Jetpack Compose untuk XR menyertakan berbagai komponen spasial untuk membantu Anda membangun UI dan tata letak spasial untuk aplikasi.

Composable Subspace

Composable subruang adalah jenis khusus komponen spasial yang hanya dapat dirender dalam subruang dan harus diapit dalam Subspace sebelum ditempatkan dalam tata letak 2D. SubspaceModifier memungkinkan Anda menambahkan atribut seperti kedalaman, offset, dan pemosisian ke composable subruang.

Komponen spasial lainnya

Komponen spasial lainnya tidak perlu dipanggil di dalam subruang. Aplikasi ini terdiri dari elemen 2D konvensional yang digabungkan dalam penampung spasial. Elemen ini dapat digunakan dalam tata letak 2D atau 3D jika ditentukan untuk keduanya. Jika spasialisasi tidak diaktifkan, fitur spasialnya akan diabaikan dan akan kembali ke versi 2D-nya.

Komponen spasial dapat ditempatkan di mana saja dalam hierarki UI aplikasi Anda. Elemen ini dapat digunakan kembali di UI 2D Anda, dan atribut spasialnya hanya terlihat saat kemampuan spasial diaktifkan. Hal ini memungkinkan Anda menambahkan elevasi ke menu, dialog, dan komponen lainnya tanpa perlu menulis kode dua kali. Berikut beberapa contoh bagaimana berbagai komponen spasial mengubah perilakunya saat spasialisasi diaktifkan atau tidak:

Komponen spasial

Saat spasialisasi diaktifkan

Di lingkungan 2D

SpatialDialog

Panel sedikit didorong ke belakang dalam kedalaman z untuk menampilkan dialog yang ditinggikan

Kembali ke 2D Dialog.

SpatialPopup

Panel sedikit didorong ke belakang dalam kedalaman z untuk menampilkan pop-up yang ditinggikan

Akan beralih ke Popup 2D.

SpatialElevation

SpatialElevationLevel dapat ditetapkan untuk menambahkan elevasi.

Menampilkan tanpa elevasi spasial.

Panduan

Bagian ini mencakup panduan developer berikut: