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 Audio &
Tampilan
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

Menargetkan perangkat khusus dengan fidelitas tinggi seperti headset XR dan kacamata XR berkabel. Gunakan alat pengembangan Android modern seperti Kotlin dan Compose, serta alat generasi sebelumnya seperti Java dan View. Anda dapat menspasialisasi 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 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 rekomendasi kami tentang menempatkan aplikasi Android yang ada di ruang 3D.

Membangun pengalaman yang ditingkatkan dan bermanfaat

Menargetkan kacamata audio yang ringan dan bergaya serta kacamata layar. 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: Bangun dengan komponen dan tata letak Material yang beradaptasi untuk XR.
  • Jetpack SceneCore: Buat dan manipulasi grafik adegan 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 di-augmentasi, yang dioptimalkan untuk kacamata tampilan.
  • Jetpack Projected: API yang memfasilitasi pengalaman aplikasi yang diproyeksikan dari ponsel ke kacamata audio atau kacamata tampilan.

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 kirim 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 Anda mem-porting aplikasi 2D yang ada ke XR atau membuat aplikasi XR baru dari awal.

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

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

Mengembangkan contoh umum pengorbit komponen XR UI

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

Pelajari cara menspasialisasi 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 entitas, relatif satu sama lain dan lingkungan Anda. Dengan SceneCore, Anda dapat:

Library Jetpack SceneCore juga memberikan dukungan untuk aplikasi spasialisasi yang dibangun menggunakan View. Lihat panduan kami untuk menggunakan tampilan untuk 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 audio, kacamata 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 pelabelan semantik (misalnya, lantai, dinding, dan permukaan meja). Library ini memanfaatkan stack persepsi dasar yang didukung oleh OpenXR, yang memastikan kompatibilitas dengan berbagai perangkat dan membantu aplikasi tetap relevan di masa mendatang.

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

Jetpack Compose Glimmer

Perangkat XR yang kompatibel: Kacamata tampilan

Jetpack Compose Glimmer adalah toolkit UI untuk membangun pengalaman XR Android yang disempurnakan, yang dioptimalkan untuk kacamata tampilan. Buat UI yang menarik, minimal, dan nyaman untuk perangkat yang dipakai sepanjang hari.

  • Dibuat agar mudah dilihat dan dibaca: Tidak seperti ponsel, kanvas utama adalah layar tembus pandang optik—layarnya 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 luar yang dioptimalkan, bukan efek riak yang mengganggu, dan dibuat untuk menangani input fisik umum seperti ketukan, gesekan pada bingkai, dan tentu saja, suara.
  • Menggunakan pola UI deklaratif yang sudah dikenal: Karena Jetpack Compose Glimmer dibuat sepenuhnya di Jetpack Compose, Anda dapat menggunakan semua yang sudah Anda ketahui tentang pembuatan UI deklaratif di Android. Kami menyediakan serangkaian lengkap fungsi Composable inti yang telah dibuat sebelumnya—seperti Text, Icon, Button, dan komponen khusus seperti TitleChip—yang semuanya dioptimalkan untuk lingkungan kacamata.
Mengembangkan contoh umum pengorbit komponen XR UI

Jetpack yang Diproyeksikan

Perangkat XR yang kompatibel: Kacamata audio, kacamata layar

Saat Anda membangun untuk kacamata audio dan kacamata tampilan, aplikasi Anda 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 tampilan jika perangkat host memiliki kemampuan proyeksi XR.

  • Mengakses hardware perangkat yang diproyeksikan: Konteks perangkat yang terkait dengan perangkat yang diproyeksikan (kacamata audio atau kacamata tampilan). Konteks yang diproyeksikan ini memberikan akses ke hardware perangkat yang diproyeksikan, seperti kamera. Aktivitas khusus yang dibuat untuk ditampilkan di kacamata audio atau 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 mendapatkan konteks yang diproyeksikan.
  • Menyederhanakan permintaan izin: Kacamata audio dan kacamata tampilan 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.
  • Periksa kemampuan perangkat dan tampilan: Periksa apakah perangkat yang diproyeksikan memiliki tampilan dan status tampilan untuk menampilkan visual. Sesuaikan aplikasi Anda berdasarkan kemampuan perangkat. Misalnya, Anda mungkin ingin memberikan konteks audio yang lebih banyak jika perangkat tidak memiliki layar atau layar dinonaktifkan.
  • 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.