Android XR: Pedoman Kualitas Aplikasi untuk pengalaman augmented

Perangkat XR yang kompatibel
Panduan ini membantu Anda membangun pengalaman untuk jenis perangkat XR ini.
Kacamata Pintar dengan Layar
& Audio

Pedoman kualitas aplikasi untuk kacamata AI memperluas standar seluler kualitas aplikasi inti dasar.

Pedoman dan kebijakan kualitas aplikasi ini berfokus pada interaksi multimodal yang penting dan unik untuk platform Android XR di kacamata cerdas, seperti yang diuraikan dalam definisi tingkat kompatibilitas, checklist, dan kebijakan untuk pengalaman khusus audio. Tinjau bagian ini untuk memastikan bahwa aplikasi Anda memberikan pengalaman pengguna yang luar biasa di kacamata audio dan kacamata pintar dengan layar.

Pengalaman augmented: definisi tingkat kompatibilitas aplikasi seluler

Tinjau definisi tingkat kompatibilitas berikut untuk memahami tingkat dukungan yang diberikan aplikasi Anda untuk pengalaman augmented di kacamata.

Kompatibel

Aplikasi seluler yang kompatibel memberikan pengalaman augmented pada kacamata tanpa upaya developer tambahan. Ini mewakili aplikasi seluler Android yang ada, termasuk konektivitas Bluetooth yang belum dimodifikasi untuk kacamata. Platform Android XR otomatis mendukung jenis aplikasi ini, asalkan tidak mengandalkan fitur hardware yang tidak didukung.

Untuk mencapai kemampuan ini, platform ini memperluas platform sistem Android standar dengan lancar ke kacamata. Misalnya, notifikasi otomatis ditampilkan di garis pandang pengguna atau dibacakan (untuk kacamata audio), sehingga pengguna dapat menyelesaikan tugas penting yang dapat dilihat sekilas tanpa perlu mengeluarkan ponsel.

Diferensiasi

Pengalaman augmented yang berbeda dirancang khusus untuk kacamata, dengan memanfaatkan kemampuan penuh Jetpack XR SDK dan hardware unik faktor bentuk.

Untuk membangun pengalaman augmented yang transformatif ini, gunakan library berikut:

  • Jetpack Compose Glimmer: Toolkit UI Compose untuk membuat antarmuka minimalis dan mudah dibaca yang dioptimalkan untuk layar tembus pandang optik.
  • Jetpack Projected: Mengelola resource dan menjembatani fungsi dengan lancar antara ponsel pendamping (host) dan kacamata (perangkat yang diproyeksikan).
  • ARCore untuk Jetpack XR: Akses kemampuan persepsi lanjutan seperti Pelacakan Perangkat dan Geospatial API, yang memungkinkan fitur pelokalan dan peka konteks seperti navigasi pejalan kaki.

Pengalaman augmented: checklist kualitas aplikasi seluler

Untuk memastikan aplikasi Anda memberikan pengalaman pengguna yang baik untuk pengalaman augmented, tinjau checklist dan pengujian kompatibilitas berikut.

Checklist dan pengujian ini menentukan serangkaian persyaratan kualitas yang komprehensif untuk sebagian besar jenis aplikasi Android.

Kompatibel

Aplikasi yang kompatibel adalah aplikasi seluler Android yang sudah ada dan berfungsi secara otomatis di kacamata dengan memanfaatkan platform Android standar (misalnya, notifikasi standar dan Live Update). Tidak diperlukan kode khusus kacamata untuk tingkat kompatibilitas ini.

Aplikasi Anda harus memenuhi persyaratan inti berikut:

  • Notifikasi: Pastikan semua notifikasi yang dapat ditindaklanjuti dan sensitif terhadap waktu menggunakan API NotificationManager Android standar sehingga dapat dikonversi dengan benar oleh platform menjadi pembacaan audio (perangkat audio) atau overlay visual minimalis (perangkat layar).
  • Live Update: Jika aplikasi memiliki aktivitas berkelanjutan (seperti tugas terkait progres), aplikasi harus menggunakan framework notifikasi Live Update standar agar platform dapat menampilkan informasi ini secara sekilas dan handsfree.
  • Google Play: Aplikasi harus mematuhi semua kebijakan Android dan Google Play yang berlaku. Kompatibilitas ditentukan secara otomatis berdasarkan deklarasi manifes dan persyaratan fitur.

Diferensiasi

Aplikasi yang berbeda dibuat secara khusus menggunakan Jetpack XR SDK (dengan library seperti Jetpack Compose Glimmer, Jetpack Projected, dan ARCore untuk Jetpack XR) untuk memberikan pengalaman pengguna yang sangat dioptimalkan dan memahami dunia atau menggunakan kemampuan augmented yang unik. Lihat persyaratan yang sesuai untuk aplikasi Anda.

Kategori Area Panduan

Fungsi Inti

Memulai aktivitas kacamata Pengalaman harus dapat diluncurkan dan dikontrol langsung dari aplikasi seluler, terutama untuk penyiapan awal atau menavigasi informasi yang padat sebelum beralih ke kacamata audio dan kacamata pintar dengan layar yang memiliki kemampuan UX lebih terbatas.
Perintah Buka Aplikasi Pengalaman harus dikonfigurasi dengan status tanpa peluncuran di kacamata dengan Gemini sehingga saat pengguna memberikan perintah "Buka [Aplikasi]" , aplikasi akan mengabaikan menu tradisional dan langsung beralih ke pengalaman audio yang siap digunakan, seperti mode latar belakang khusus audio, status mendengarkan langsung, atau isyarat audio langsung.
Inisiasi kamera Akses kamera dapat dimulai dari titik entri atau aktivitas seluler, atau dari input langsung menggunakan gestur tindakan kamera di perangkat. Jika akses kamera dimulai dari perangkat seluler, pengguna akan mendengar hitung mundur sebelum memulai streaming kamera.
Kejelasan dan Konsistensi (Gestur) Gestur (seperti suara, ketukan, atau geser) harus diterapkan dengan cara yang jelas dan konsisten, sesuai dengan ekspektasi pengguna untuk interaksi umum. Kebijakan gestur inti diuraikan di bagian berikutnya yang sesuai.

Performa & Stabilitas

Baterai Optimalkan proses latar belakang dengan mengikuti batasan tugas latar belakang Android dan minimalkan penggunaan sensor yang menguras daya (seperti feed kamera) saat tidak digunakan secara aktif.
Kecepatan frame & resolusi kamera Akses feed kamera harus dikonfigurasi untuk menggunakan konfigurasi yang paling efisien (kecepatan frame dan resolusi terendah) untuk kasus penggunaan tertentu. Untuk mengetahui informasi selengkapnya tentang konfigurasi yang direkomendasikan per kasus penggunaan, lihat panduan developer.
Keamanan Keamanan Pengalaman harus dirancang berdasarkan tindakan yang dimulai oleh pengguna dan sangat meminimalkan gangguan terhadap pengguna dari lingkungan sekitarnya, terutama selama pergerakan atau di ruang publik.
Privasi & Keamanan Izin Aplikasi harus meminta izin khusus kacamata untuk akses hardware (seperti kamera atau mikrofon) menggunakan API permintaan izin yang diproyeksikan dan menangani pengalihan ke perangkat host untuk mendapatkan izin pengguna.

Kebijakan Umum

Aksesibilitas Pertimbangkan pengguna dengan beragam kebutuhan dan pastikan metode input alternatif tersedia (misalnya, menggunakan perintah suara sebagai pengganti gestur touchpad) jika sesuai.
Pengujian Uji secara menyeluruh semua implementasi gestur dan visual di berbagai skenario pengguna, pencahayaan, dan kondisi lingkungan yang ramai, menggunakan Android XR Emulator dan pratinjau composable.
Google Play Kebijakan Patuhi semua kebijakan Google Play, termasuk kebijakan khusus kacamata yang diuraikan di bagian berikutnya yang membantu melindungi privasi dan kesehatan pengguna.

Pengalaman Audio

Peringatan suara

Pemberitahuan suara harus ringkas dan hanya memberikan informasi yang paling relevan dan dapat ditindaklanjuti. Notifikasi suara untuk kondisi error akan berfungsi terlepas dari konektivitas internet.

Tindak lanjut dan percakapan yang lebih mendalam harus secara eksplisit diharapkan menggunakan agen dalam aplikasi atau Gemini.

Fokus audio Fokus audio sangat terkait dengan fokus input. Aplikasi harus meminta dan melepaskan fokus audio sebagaimana mestinya dan sesuai dengan panduan Android.
Kebijakan Audio Gestur dan perilaku LED harus mematuhi semua kebijakan untuk pengalaman khusus audio.

Kebijakan untuk pengalaman khusus audio

Semua aplikasi harus mematuhi persyaratan dalam kebijakan berikut untuk mempromosikan pengalaman khusus audio yang aman dan sopan di kacamata AI.

Keamanan aplikasi

Sebagai pengingat, semua aplikasi yang didistribusikan melalui Google Play harus mematuhi semua Kebijakan Developer Google Play.

Aktivitas berikut sangat dilarang, dan aplikasi tidak boleh memfasilitasi atau mempromosikan aktivitas ini:

  • Penyebaran informasi pribadi
  • Pengenalan wajah atau identifikasi biometrik
  • Pengawasan
  • Pembuatan atau penyebaran Penggambaran Adegan Intim Non-Konsensual (NCII)

Perlindungan pengamat berikut diperlukan untuk semua aplikasi:

Keamanan kamera

Aplikasi yang mengakses sensor kamera wearable harus menghormati privasi orang di sekitar dan harus mematuhi hal berikut:

Pembatasan video dan foto

Interaksi yang diizinkan

Deskripsi

Panggilan video

Aplikasi diizinkan menggunakan sensor kamera wearable untuk tujuan panggilan video.

Pemahaman adegan & sensor ruangan

Aplikasi diizinkan menggunakan sensor kamera wearable untuk deteksi visual ruangan atau pemahaman suasana.

Interaksi yang dilarang

Deskripsi

Live streaming sosial video & penyiaran publik

Aplikasi tidak boleh menggunakan sensor kamera wearable untuk Live Streaming Sosial Video yang mencakup live streaming real-time, live streaming satu ke banyak, siaran publik, atau transmisi ke feed publik dan saluran terbuka.

Identifikasi wajah & doxxing real-time

Aplikasi tidak boleh menggunakan sensor kamera untuk menjalankan identifikasi wajah guna menampilkan Informasi Identitas Pribadi (PII) orang di sekitar. Misalnya: nama, alamat rumah, nomor telepon, atau perusahaan tempat mereka bekerja.

Pembuatan konten ilegal atau penggambaran adegan intim non-konsensual (NCII)

Aplikasi tidak boleh menggunakan sensor kamera untuk memfasilitasi pembuatan penggambaran adegan intim non-konsensual (NCII) atau pembuatan konten ilegal apa pun (misalnya, CSAM).

Keamanan audio

Aplikasi yang menggunakan susunan mikrofon harus menghormati privasi orang di sekitar dan harus mematuhi hal berikut:

Interaksi yang dilarang

Deskripsi

Penyadapan persisten

Aplikasi tidak boleh mempertahankan perekaman atau transkripsi audio latar belakang yang persisten saat pengguna tidak secara aktif berinteraksi dengan aplikasi dalam tugas yang dimulai pengguna.

Identifikasi ucapan

Aplikasi tidak boleh menggunakan susunan mikrofon untuk mengidentifikasi suara orang yang tidak memakai perangkat atau orang di sekitar.

Penghapusan atau modifikasi terprogram

Aplikasi tidak boleh mengubah atau menonaktifkan peredam bising audio yang diterapkan sistem. Aplikasi juga tidak boleh mendorong atau mengarahkan pengguna untuk mengubah atau menonaktifkan pengurang derau audio.

Gestur dan input

Kebijakan ini menguraikan persyaratan untuk menerapkan peristiwa gestur pada kacamata pintar selama pengalaman khusus audio. Patuhi panduan ini untuk memberikan pengalaman pengguna yang konsisten dan intuitif di berbagai aplikasi dan perangkat Android XR. Semua input diharapkan berfungsi jika aplikasi Anda memiliki fokus audio, terlepas dari status latar depannya.

1. Gestur ketuk

Gestur ketuk adalah sentuhan cepat satu kali pada area input touchpad. Ketukan adalah cara pengguna mengambil tindakan pada kacamata. Tindakan ini dapat memulai pemutaran audio, seperti untuk memberikan informasi berdasarkan status pengguna atau untuk mengulangi pesan terakhir yang terdengar. Jika audio sedang diputar, ketukan dapat menjeda atau menghentikan output audio.

Contoh
Interaksi yang diizinkan Deskripsi

Memutar perintah yang relevan

Berikan informasi yang relevan kepada pengguna seperti:

  • Meminta izin pengguna.
  • Informasi berdasarkan status pengguna saat ini. Misalnya, mengucapkan "Di sebelah kanan Anda adalah Jembatan Golden Gate".
  • Mengulangi pesan audio terakhir yang diberikan kepada pengguna.

Mengetuk saat audio diputar akan menghentikan audio.

Membisukan atau membunyikan mikrofon

Memungkinkan pengguna membisukan atau membunyikan mikrofon mereka dengan gestur ketuk saat berada dalam pengalaman yang menggunakan input mikrofon.

Respons audio harus diberikan saat mikrofon dibisukan atau diaktifkan.

Interaksi yang dilarang Deskripsi

Informasi atau iklan yang tidak relevan

Jangan gunakan gestur ketuk untuk menayangkan iklan atau memberikan informasi yang tidak relevan dengan status fisik atau konteks pengguna saat ini.

Input game dan tindakan berkelanjutan yang cepat

Gestur ketuk dirancang untuk tindakan cepat dengan sekali sentuh. Perangkat tidak boleh digunakan kembali sebagai pengontrol berkelanjutan untuk game interaktif atau tugas input frekuensi tinggi yang mengganggu kontrol sistem standar.

Memungkinkan kejahatan, kekerasan, atau tindakan menyakiti diri sendiri

Gestur ketuk tidak boleh memicu petunjuk yang dapat ditindaklanjuti yang memfasilitasi tindakan ilegal atau berbahaya, seperti pengintaian ekstremis, pembuatan senjata, atau tindakan menyakiti diri sendiri.

2. Gestur tindakan kamera

Gestur tindakan kamera melibatkan penekanan tombol kamera dua kali secara cepat berturut-turut. Aplikasi yang mengakses kamera harus memperlakukan peristiwa ini sebagai tindakan kamera yang memberikan data sensor langsung ke aplikasi.

Contoh
Interaksi yang diizinkan Deskripsi

Mengaktifkan kamera untuk aplikasi

Memulai streaming kamera ke dalam aplikasi. Hal ini termasuk mengaktifkan streaming kamera untuk mengambil foto, video, atau memungkinkan pemrosesan kamera ambien menggunakan feed kamera.

Penggunaan streaming kamera harus sesuai dengan semua kebijakan Android terkait pengambilan gambar dan suara, serta kebijakan Data Pengguna di Pusat Kebijakan Developer Play. Selain itu, kebijakan Penindasan dan Pelecehan melarang aplikasi yang menyebarkan informasi pribadi atau mengeksploitasi orang lain secara publik.

Interaksi yang dilarang Deskripsi

Input kustom dan pemetaan ulang

Gestur tekan dua kali kamera harus digunakan secara eksklusif untuk mengaktifkan streaming kamera dan memberikan data sensor langsung ke aplikasi. Anda tidak boleh memetakan ulang gestur hardware ini ke fungsi non-kamera, pintasan kustom, atau pengalaman aplikasi alternatif.

Penggunaan sensor terpisah atau tiruan

Aplikasi yang menangkap gestur tekan dua kali pada kamera harus memperlakukannya sebagai permintaan asli untuk data sensor visual. Anda tidak dapat mendaftarkan peristiwa tekan dua kali untuk membajak tombol fisik sambil sengaja mengabaikan, menghapus, atau menyembunyikan feed kamera.

Kurangnya pengungkapan atau penggunaan yang menipu

Jika gestur tekan dua kali kamera digunakan untuk mengaktifkan kamera, Anda harus secara eksplisit memberi tahu pengguna tentang penggunaan kamera sebelumnya dalam alur aplikasi seluler selama pemberian izin awal atau penyiapan aplikasi. Misalnya, beberapa kasus penggunaan yang valid mungkin adalah live streaming, mengambil foto, atau pemrosesan AI. Streaming kamera tidak boleh digunakan untuk fungsi yang tidak disetujui secara eksplisit oleh pengguna.

3. Gestur geser kembali dengan satu jari

Gestur geser kembali dengan satu jari melibatkan gerakan mundur terus-menerus di seluruh area input touchpad. Sistem mendukung gestur ini bahkan selama pengalaman khusus audio dengan memanggil onBack(). Aplikasi Anda harus menangani peristiwa ini dengan keluar dari pengalaman saat ini atau mengembalikan pengguna ke status aplikasi sebelumnya.

Interaksi yang dilarang Deskripsi

Membajak perintah keluar

Gestur geser kembali harus selalu memanggil onBack() untuk keluar dari pengalaman atau mengembalikan pengguna ke status aplikasi sebelumnya. Tombol ini tidak boleh dipetakan ke tindakan kustom, peluncuran media baru, atau iklan.

Keluar palsu (penyadapan rahasia)

Aplikasi harus benar-benar keluar atau menangguhkan penggunaan sensor utamanya saat gestur ini dipanggil. Jangan menyimulasikan keluar sambil diam-diam mempertahankan sensor aktif di latar belakang untuk pengawasan.

Perilaku LED

Aplikasi Anda tidak boleh mengubah perilaku sistem LED berdasarkan akses mikrofon dan kamera.

Interaksi yang dilarang Deskripsi

Penghapusan atau modifikasi terprogram

Aplikasi tidak boleh mengubah, meredupkan, atau menonaktifkan perilaku LED yang menghadap ke dunia dan LED yang ditampilkan kepada pengguna yang diterapkan sistem berdasarkan akses mikrofon dan kamera. Aplikasi juga tidak boleh mendorong atau mengarahkan pengguna untuk mengubah, meredupkan, atau menonaktifkan perilaku LED.

Mengabaikan deteksi gangguan dan perusakan

Aplikasi tidak boleh mengabaikan atau mengganggu, atau mendorong atau mengarahkan pengguna untuk melakukannya, algoritma deteksi penghalang perangkat, yang dirancang untuk menghentikan perekaman secara terprogram jika LED yang menghadap ke dunia tertutup atau rusak secara fisik.