Jetpack XR SDK mencakup semua alat dan library yang Anda perlukan untuk membangun pengalaman imersif dan augmented untuk perangkat Android XR.
Membangun pengalaman yang sepenuhnya imersif
Menargetkan perangkat khusus dengan fidelitas tinggi seperti headset XR dan kacamata XR berkabel. Gunakan alat developer Android modern seperti Kotlin dan Compose, serta alat generasi sebelumnya seperti Java dan View. Anda dapat membuat UI spasial, memuat dan merender model 3D, serta memahami dunia nyata secara semantik.
Jika Anda sudah memiliki aplikasi seluler atau layar besar di Android, Jetpack XR SDK akan membawa aplikasi Anda ke dimensi baru dengan membuat tata letak yang ada menjadi spasial dan meningkatkan pengalaman Anda dengan model 3D dan lingkungan imersif. Lihat pedoman kualitas kami untuk mengetahui rekomendasi kami tentang cara melakukan spasialisasi pada aplikasi Android yang sudah ada.
Membangun pengalaman yang ditingkatkan dan bermanfaat
Menargetkan kacamata pintar audio dan kacamata pintar dengan layar yang ringan dan bergaya. Gunakan alat developer Android modern seperti Kotlin dan Jetpack Compose Glimmer. Gunakan API yang memfasilitasi pengalaman aplikasi yang diproyeksikan dari ponsel ke kacamata.
Menggunakan library Jetpack
Library Jetpack XR SDK menyediakan toolkit komprehensif untuk membangun pengalaman imersif yang kaya, pengalaman augmented yang ringan, dan semuanya di antaranya. Library berikut adalah bagian dari Jetpack XR SDK:
- Jetpack Compose untuk XR: Mem-build tata letak UI spasial secara deklaratif yang memanfaatkan kemampuan spasial Android XR.
- Desain Material untuk XR: Bangun dengan komponen dan tata letak Material yang disesuaikan untuk XR.
- Jetpack SceneCore: Mem-build dan memanipulasi grafik scene Android XR dengan konten 3D.
- ARCore untuk Jetpack XR: Menghadirkan konten digital ke dunia nyata dengan kemampuan persepsi.
- Jetpack Compose Glimmer: Toolkit UI untuk membangun pengalaman Android XR yang ditingkatkan, yang dioptimalkan untuk kacamata pintar dengan layar.
- Jetpack Projected: API yang memfasilitasi pengalaman aplikasi yang diproyeksikan dari ponsel ke kacamata pintar audio atau kacamata pintar dengan layar.
Pengembangan API selama Pratinjau Developer
Library Jetpack XR SDK adalah bagian dari Pratinjau Developer Android XR, dan API ini masih dalam pengembangan. Lihat catatan rilis library untuk mengetahui masalah umum:
- Catatan Rilis Jetpack Compose untuk XR
- Catatan Rilis ARCore untuk Jetpack XR
- Catatan Rilis Jetpack SceneCore
- Catatan Rilis Runtime XR
- Catatan Rilis Jetpack Compose Glimmer
- Catatan Rilis Jetpack Projected
Jika Anda mengalami masalah yang tidak ada dalam salah satu daftar ini, laporkan bug atau kirimkan masukan.
Jetpack Compose untuk XR
Dengan Jetpack Compose untuk XR, Anda dapat menggunakan komponen spasial seperti baris dan kolom untuk membangun UI dan tata letak spasial menggunakan model Compose deklaratif yang sudah dikenal.
Library ini juga menyediakan subspace composable, seperti panel
spasial dan orbiter, yang memungkinkan Anda menempatkan UI berbasis View atau Compose 2D yang ada dalam tata letak spasial. Composable subruang lainnya menangani jenis
kasus penggunaan spasial lainnya, seperti SceneCoreEntity yang memungkinkan Anda menempatkan
entity seperti model 3D yang terkait dengan UI Anda.
Anda dapat menggunakan Jetpack Compose untuk XR, baik saat melakukan spasialisasi aplikasi Android yang sudah ada maupun membuat aplikasi XR baru dari awal.
Untuk mengetahui informasi selengkapnya, lihat panduan developer untuk UI spasial dan dokumentasi referensi library dan API.
Desain Material untuk XR
Desain Material menyediakan komponen dan tata letak yang disesuaikan untuk XR. Jika Anda mem-build dengan tata letak adaptif. Pelajari lebih lanjut cara menerapkan Desain Material untuk XR.
Jetpack SceneCore
Library Jetpack SceneCore memungkinkan Anda menempatkan dan mengatur konten 3D, yang ditentukan oleh entity, secara relatif satu sama lain dan lingkungan Anda. Dengan SceneCore, Anda dapat:
- Menetapkan lingkungan spasial
- Membuat instance
PanelEntity - Menempatkan dan menganimasikan model 3D
- Menentukan sumber audio spasial
- Menambahkan Komponen ke entity yang membuatnya dapat dipindahkan, diubah ukurannya, dan dapat ditambatkan ke dunia nyata
Library Jetpack SceneCore juga menyediakan dukungan untuk memspasialkan aplikasi yang dibuat menggunakan View. Lihat panduan kami untuk menggunakan tampilan guna mengetahui detail selengkapnya.
Lihat referensi API untuk mengetahui informasi yang lebih mendetail.
ARCore untuk Jetpack XR
Terinspirasi oleh library ARCore yang ada, library ARCore untuk Jetpack XR menyediakan kemampuan untuk memadukan konten digital dengan dunia nyata. Library ini mencakup pelacakan gerakan, anchor persisten, hit testing, dan identifikasi bidang dengan pelabelan semantik (misalnya, lantai, dinding, dan permukaan meja). Library ini memanfaatkan stack persepsi yang mendasarinya yang didukung oleh OpenXR, yang memastikan kompatibilitas dengan berbagai perangkat dan membantu aplikasi siap menghadapi masa depan.
Lihat Bekerja dengan ARCore untuk Jetpack XR untuk mengetahui informasi selengkapnya.
Jetpack Compose Glimmer
Jetpack Compose Glimmer adalah toolkit UI untuk membangun pengalaman Android XR yang ditingkatkan, yang dioptimalkan untuk kacamata pintar dengan layar. Bangun UI yang indah, minimalis, dan nyaman untuk perangkat yang dipakai sepanjang hari.
- Dibuat agar mudah dilihat dan dibaca: Tidak seperti ponsel, kanvas utama adalah layar tembus pandang optik—layar ini transparan. Jetpack Compose Glimmer menyediakan tema khusus kacamata, palet warna yang disederhanakan, dan tipografi untuk membuat konten Anda mudah dibaca, cepat diproses, dan tidak pernah mengganggu.
- Dioptimalkan untuk interaksi khusus perangkat wearable: Kami telah mengoptimalkan model interaksi untuk cara orang menggunakan kacamata. Komponen Glimmer Jetpack Compose menampilkan status fokus yang jelas, seperti garis batas yang dioptimalkan, bukan efek riak yang mengganggu, dan dibuat untuk menangani input fisik umum seperti ketukan, geser pada bingkai, dan tentu saja, suara.
- Menggunakan pola UI deklaratif yang sudah dikenal: Karena Jetpack Compose Glimmer dibangun sepenuhnya di Jetpack Compose, Anda dapat menggunakan semua yang sudah Anda ketahui tentang pembuatan UI deklaratif di Android. Kami menyediakan serangkaian lengkap fungsi Composable bawaan inti—seperti Text, Icon, Button, dan komponen khusus seperti TitleChip—semuanya dioptimalkan untuk lingkungan kacamata.
Jetpack Projected
Saat Anda mem-build untuk kacamata pintar audio dan kacamata pintar dengan layar, aplikasi Anda akan berjalan di perangkat host pendamping, seperti ponsel Android, yang memproyeksikan pengalaman XR aplikasi Anda. Jetpack Projected memungkinkan perangkat host Android ini berkomunikasi dengan kacamata audio atau kacamata pintar dengan layar jika perangkat host memiliki kemampuan proyeksi XR.
- Mengakses hardware perangkat yang diproyeksikan: Konteks perangkat yang terkait dengan perangkat yang diproyeksikan (kacamata pintar audio atau kacamata pintar dengan layar). Konteks yang diproyeksikan ini memberikan akses ke hardware perangkat yang diproyeksikan, seperti kamera. Aktivitas khusus yang dibuat khusus untuk ditampilkan di kacamata audio atau kacamata pintar dengan layar sudah berfungsi sebagai konteks yang diproyeksikan. Jika bagian lain dari aplikasi Anda (seperti aktivitas ponsel atau layanan) perlu mengakses hardware kacamata, bagian tersebut dapat memperoleh konteks yang diproyeksikan.
- Menyederhanakan permintaan izin: Kacamata pintar audio dan kacamata pintar dengan layar mengikuti model izin Android standar, dengan izin khusus kacamata yang harus diminta saat runtime sebelum aplikasi Anda dapat mengakses hardware perangkat, seperti kamera. Helper izin menyederhanakan mekanisme permintaan izin ini di antarmuka ponsel dan kacamata untuk memberikan pengalaman permintaan yang konsisten.
- Memeriksa kemampuan perangkat dan layar: Periksa apakah perangkat yang diproyeksikan memiliki layar dan status layar untuk menampilkan visual. Sesuaikan aplikasi Anda berdasarkan kemampuan perangkat. Misalnya, Anda mungkin ingin memberikan lebih banyak konteks audio jika perangkat tidak memiliki layar atau layar nonaktif.
- Mengakses tindakan kamera aplikasi: Aplikasi Anda dapat mengakses tindakan kamera pengguna, misalnya untuk mengaktifkan atau menonaktifkan kamera di aplikasi streaming video.
Menguji pengalaman aplikasi XR dengan Emulator Android XR
Android XR Emulator adalah versi khusus Android Emulator yang dirancang untuk pengembangan aplikasi XR. Dengan emulator ini, Anda dapat menguji dan men-debug aplikasi XR dalam lingkungan Android Studio yang sudah dikenal. Buat perangkat virtual untuk semua jenis perangkat Android XR, mulai dari perangkat imersif seperti headset XR dan kacamata XR berkabel, hingga kacamata pintar seperti kacamata audio dan kacamata pintar dengan layar.
Jika Anda sudah siap menjalankan dan men-debug aplikasi, lihat panduan berikut untuk memulai:
- Membuat perangkat virtual untuk headset XR dan kacamata XR
- Membuat perangkat virtual untuk kacamata pintar audio dan kacamata pintar dengan layar
OpenXR™ dan logo OpenXR adalah merek dagang yang dimiliki oleh The Khronos Group Inc. dan terdaftar sebagai merek dagang di China, Uni Eropa, Jepang, dan Inggris Raya.