Mengembangkan dengan Jetpack XR SDK

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

Jetpack XR SDK mencakup semua alat dan library yang Anda butuhkan untuk membangun pengalaman imersif dan augmented untuk perangkat Android XR.

Membangun pengalaman yang sepenuhnya imersif

Targetkan perangkat khusus dan berkualitas tinggi seperti headset XR dan kacamata XR berkabel. Gunakan alat pengembangan Android modern seperti Kotlin dan Compose, serta alat generasi sebelumnya seperti Java dan Views. Anda dapat membuat efek spasial pada UI, 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 efek spasial pada tata letak yang ada dan meningkatkan pengalaman Anda dengan model 3D dan lingkungan imersif. Lihat panduan kualitas kami untuk mengetahui rekomendasi kami tentang cara membuat efek spasial pada aplikasi Android yang ada.

Membangun pengalaman augmented dan bermanfaat

Targetkan kacamata pintar audio dan kacamata pintar dengan layar yang ringan dan bergaya. Gunakan alat pengembangan 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 semua hal di antaranya. Library berikut adalah bagian dari Jetpack XR SDK:

  • Jetpack Compose untuk XR: Membangun tata letak UI spasial secara deklaratif yang memanfaatkan kemampuan spasial Android XR.
  • Desain Material untuk XR: Membangun dengan komponen dan tata letak Material yang beradaptasi untuk XR.
  • Jetpack SceneCore: Membangun dan memanipulasi grafik scene Android XR dengan konten 3D.
  • ARCore untuk Jetpack XR: Membawa konten digital ke dunia nyata dengan kemampuan persepsi.
  • Jetpack Compose Glimmer: Toolkit UI untuk membangun pengalaman Android XR augmented, 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:

Jika Anda mengalami masalah yang tidak ada dalam salah satu daftar ini, harap laporkan bug atau kirimkan masukan.

Jetpack Compose untuk XR

Perangkat XR yang kompatibel: Headset XR, kacamata XR berkabel

Dengan Jetpack Compose untuk XR, Anda dapat menggunakan konsep Compose yang sudah dikenal seperti baris dan kolom untuk membuat tata letak UI spasial di XR, baik saat Anda mem-porting aplikasi 2D yang ada ke XR maupun membuat aplikasi XR baru dari awal.

Library ini menyediakan composable subruang, seperti panel spasial dan orbiter, yang memungkinkan Anda menempatkan UI berbasis Compose 2D atau Views yang ada dalam tata letak spasial.

Lihat Mengembangkan UI dengan Jetpack Compose untuk XR guna mendapatkan panduan mendetail.

Mengembangkan contoh umum orbiter komponen XR UI

Compose untuk XR memperkenalkan composable subruang SceneCoreEntity, yang memungkinkan Anda menempatkan entity, seperti model 3D, relatif terhadap UI.

Pelajari cara membuat efek spasial pada aplikasi Android yang ada atau lihat referensi API untuk mengetahui informasi yang lebih mendetail.

Desain Material untuk XR

Perangkat XR yang kompatibel: Headset XR, kacamata XR berkabel

Desain Material menyediakan komponen dan tata letak yang beradaptasi untuk XR. Jika Anda membangun dengan tata letak adaptif. Pelajari lebih lanjut cara menerapkan Desain Material untuk XR.

Jetpack SceneCore

Perangkat XR yang kompatibel: Headset XR, kacamata XR berkabel

Library Jetpack SceneCore memungkinkan Anda menempatkan dan mengatur konten 3D, yang ditentukan oleh entity, relatif terhadap satu sama lain dan lingkungan Anda. Dengan SceneCore, Anda dapat:

Library Jetpack SceneCore juga menyediakan dukungan untuk membuat efek spasial pada aplikasi yang dibangun menggunakan Views. Lihat panduan kami untuk menggunakan tampilan guna mengetahui detail selengkapnya.

Lihat referensi API untuk mengetahui informasi yang lebih mendetail.

ARCore untuk Jetpack XR

Perangkat XR yang kompatibel: Headset XR, kacamata XR berkabel, kacamata pintar audio, kacamata pintar dengan layar

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, pengujian hit, dan identifikasi bidang dengan pemberian label semantik (misalnya, lantai, dinding, dan meja). Library ini memanfaatkan stack persepsi dasar yang didukung oleh OpenXR, yang memastikan kompatibilitas dengan berbagai perangkat dan membantu aplikasi agar tetap relevan di masa mendatang.

Lihat Bekerja dengan ARCore untuk Jetpack XR guna mengetahui informasi yang lebih mendetail.

Jetpack Compose Glimmer

Perangkat XR yang kompatibel: Kacamata pintar dengan layar

Jetpack Compose Glimmer adalah toolkit UI untuk membangun pengalaman Android XR augmented, yang dioptimalkan untuk kacamata pintar dengan layar. Buat UI yang indah, minimalis, dan nyaman untuk perangkat yang dipakai sepanjang hari.

  • Dibuat untuk kemudahan dilihat dan dibaca: Tidak seperti ponsel, kanvas utama adalah layar optik tembus pandang—transparan. Jetpack Compose Glimmer menyediakan tema khusus kacamata, palet warna yang disederhanakan, dan tipografi untuk membuat konten Anda mudah dibaca, cepat diproses, dan tidak mengganggu.
  • Dioptimalkan untuk interaksi khusus perangkat wearable: Kami telah mengoptimalkan model interaksi untuk cara orang menggunakan kacamata. Komponen Jetpack Compose Glimmer menampilkan status fokus yang jelas, seperti garis luar 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 kumpulan lengkap fungsi Composable inti yang telah dibuat sebelumnya—seperti Teks, Ikon, Tombol, dan komponen khusus seperti TitleChip—semuanya dioptimalkan untuk lingkungan kacamata.
Mengembangkan contoh umum orbiter komponen XR UI

Jetpack Projected

Perangkat XR yang kompatibel: Kacamata pintar audio, kacamata pintar dengan layar

Saat Anda membangun 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 pintar audio atau kacamata pintar dengan layar jika perangkat host memiliki kemampuan proyeksi XR.

  • Mengakses hardware perangkat yang diproyeksikan: Konteks perangkat yang terikat ke 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 secara khusus untuk ditampilkan di kacamata pintar 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 seluruh 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 mati.
  • Mengakses tindakan kamera aplikasi: Aplikasi Anda dapat mengakses tindakan kamera pengguna, misalnya untuk mengaktifkan atau menonaktifkan kamera di aplikasi streaming video.

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.