Android XR: Artırılmış deneyimler için uygulama kalitesi yönergeleri ve politikaları

Uygun XR cihazlar
Bu kılavuz, bu tür XR cihazları için deneyimler geliştirmenize yardımcı olur.
Ses ve
Görüntü Arabirimli Gözlük

Akıllı gözlükler için uygulama kalitesi yönergeleri, temel temel uygulama kalitesi mobil standartlarını genişletir.

Bu uygulama kalitesi yönergeleri ve politikaları, uyumluluk katmanı tanımlarında, kontrol listelerinde ve yalnızca ses deneyimlerine yönelik politikalarda belirtildiği gibi, akıllı gözlüklerde Android XR platformuna özgü önemli, çok formatlı etkileşimlere odaklanır. Uygulamanızın sesli ve görüntülü gözlüklerde mükemmel bir kullanıcı deneyimi sunduğunu doğrulamak için bu bölümleri inceleyin.

Artırılmış deneyimler: mobil uygulama uyumluluk katmanı tanımları

Uygulamanızın gözlüklerdeki artırılmış gerçeklik deneyimleri için sunduğu destek düzeyini anlamak üzere aşağıdaki uyumluluk katmanı tanımlarını inceleyin.

Uyumlu

Uyumlu bir mobil uygulama, geliştiricinin ek çaba harcamasına gerek kalmadan gözlüklerde artırılmış bir deneyim sunar. Bu, gözlükler için değiştirilmemiş Bluetooth bağlantısı da dahil olmak üzere mevcut bir Android mobil uygulamasını temsil eder. Android XR platformu, desteklenmeyen donanım özelliklerini kullanmadığı sürece bu tür uygulamaları otomatik olarak destekler.

Bu özelliği sunmak için platform, standart Android sistem yüzeylerini gözlüğe sorunsuz bir şekilde genişletir. Örneğin, bildirimler otomatik olarak kullanıcının görüş alanında gösterilir veya sesli olarak okunur (ses arabirimli gözlükler için). Böylece kullanıcı, telefonunu çıkarmadan kritik ve hızlıca göz atabileceği görevleri tamamlayabilir.

Farklılaştırılmış

Farklılaştırılmış artırılmış deneyim, Jetpack XR SDK'nın tüm özelliklerinden ve form faktörünün benzersiz donanımından yararlanarak gözlükler için özel olarak tasarlanmıştır.

Bu dönüştürücü artırılmış deneyimleri oluşturmak için aşağıdaki kitaplıkları kullanın:

  • Jetpack Compose Glimmer: Optik şeffaf ekranlar için optimize edilmiş, minimal ve okunaklı arayüzler oluşturmak amacıyla kullanılan bir Compose kullanıcı arayüzü araç setidir.
  • Jetpack Projected: Kaynakları yönetin ve tamamlayıcı telefon (ana makine) ile gözlük (yansıtılan cihaz) arasında sorunsuz bir şekilde işlevsellik köprüsü oluşturun.
  • Jetpack XR için ARCore: Cihaz Takibi ve Geospatial API gibi gelişmiş algılama özelliklerine erişin. Bu özellikler, yerelleştirme ve yaya navigasyonu gibi bağlama duyarlı özellikler sağlar.

Artırılmış deneyimler: Mobil uygulama kalitesi kontrol listesi

Uygulamanızın artırılmış deneyimler için mükemmel bir kullanıcı deneyimi sunduğundan emin olmak için aşağıdaki uyumluluk listelerini ve testlerini inceleyin.

Bu kontrol listeleri ve testler, çoğu Android uygulaması türü için kapsamlı bir kalite şartları grubu tanımlar.

Uyumlu

Uyumlu uygulamalar, standart Android yüzeylerinden (ör. standart ve canlı haberler bildirimleri) yararlanarak gözlüklerde otomatik olarak çalışan mevcut Android mobil uygulamalarıdır. Bu uyumluluk katmanı için gözlüğe özel kod gerekmez.

Uygulamanız aşağıdaki temel şartları karşılamalıdır:

  • Bildirimler: İşlem yapılabilir ve zamana duyarlı tüm bildirimlerin standart Android NotificationManager API'lerini kullandığından emin olun. Böylece platform, bildirimleri sesli okumalara (ses cihazları) veya minimalist görsel yer paylaşımlarına (ekran cihazları) doğru şekilde dönüştürebilir.
  • Canlı haberler: Uygulamada devam eden bir etkinlik (ör. ilerlemeyle ilgili görevler) varsa platformun bu bilgileri eller serbest şekilde göz atılabilir olarak gösterebilmesi için standart canlı haber bildirimleri çerçevesini kullanması gerekir.
  • Google Play: Uygulama, geçerli tüm Android ve Google Play politikalarına uymalıdır. Uyumluluk, manifest beyanlarına ve özellik gereksinimlerine göre otomatik olarak belirlenir.

Farklılaştırılmış

Farklılaştırılmış uygulamalar, çevreye duyarlı ve son derece optimize edilmiş bir kullanıcı deneyimi sunmak veya benzersiz artırılmış özellikler kullanmak için Jetpack XR SDK (Jetpack Compose Glimmer, Jetpack Projected ve Jetpack XR için ARCore gibi kitaplıklarla) kullanılarak özel olarak oluşturulur. Uygulamanız için geçerli olan şartları inceleyin.

Kategori Alan Rehberlik

Temel İşlevler

Gözlük etkinliğini başlatma Deneyimler doğrudan mobil uygulamadan başlatılabilmeli ve kontrol edilebilmelidir. Bu, özellikle ilk kurulum veya daha az kullanıcı deneyimi özelliğine sahip sesli ve görüntülü gözlüklere geçmeden önce yoğun bilgileri incelemek için önemlidir.
Uygulama açma komutu Deneyimler, Gemini özellikli gözlüklerde sıfır başlatma durumuyla yapılandırılmalıdır. Böylece, kullanıcı "[Uygulama]'yı aç" komutu verdiğinde uygulama, geleneksel menüleri atlayarak hemen harekete geçmeye hazır bir ses deneyimine (ör. yalnızca sesli arka plan modu, canlı dinleme durumu veya anında sesli uyarı) geçer.
Kamerayı başlatma Kamera erişimi, mobil giriş noktasından veya etkinlikten ya da cihazdaki kamera işlemi hareketini kullanarak doğrudan girişten başlatılabilir. Kamera erişimi mobil platformdan başlatılırsa kullanıcı, kamera görüntü akışı başlamadan önce bir geri sayım duymalıdır.
Netlik ve Tutarlılık (Hareketler) Hareketler (ses, dokunma veya kaydırma gibi) net ve tutarlı bir şekilde uygulanmalı, yaygın etkileşimler için kullanıcı beklentileriyle uyumlu olmalıdır. Temel hareket politikaları, ilgili sonraki bölümlerde açıklanmıştır.

Performans ve Kararlılık

Pil Android arka plan görevi kısıtlamalarına uyarak arka plan işlemlerini optimize edin ve aktif olarak kullanılmadığında yüksek enerji tüketen sensörlerin (ör. kamera feed'i) kullanımını en aza indirin.
Kamera kare hızı ve çözünürlüğü Kamera feed'i erişimi, belirli bir kullanım alanı için en verimli yapılandırmayı (en düşük kare hızı ve çözünürlük) kullanacak şekilde yapılandırılmalıdır. Kullanım alanına göre önerilen yapılandırmalar hakkında daha fazla bilgi için geliştirici kılavuzunu inceleyin.
Güvenlik Güvenlik Deneyimler, kullanıcı tarafından başlatılan eylemlere göre tasarlanmalı ve özellikle hareket halindeyken veya halka açık alanlarda kullanıcının dikkatini dağıtacak unsurlar en aza indirilmelidir.
Gizlilik ve Güvenlik İzinler Uygulama, yansıtılan izin isteği API'sini kullanarak ve kullanıcı rızası için ana cihaza yönlendirmeyi yöneterek donanım erişimi (ör. kamera veya mikrofon) için gözlüğe özel izinler istemelidir.

Genel Politika

Erişilebilirlik Farklı ihtiyaçları olan kullanıcıları göz önünde bulundurun ve uygun durumlarda alternatif giriş yöntemlerinin (ör. dokunmatik alan hareketleri için yedek olarak sesli komutlar kullanma) kullanılabilir olduğundan emin olun.
Test Android XR Emülatörü ve composable önizlemeleri kullanarak tüm hareket ve görsel uygulamaları çeşitli kullanıcı senaryolarında, ışıklandırmada ve yoğun ortam koşullarında kapsamlı bir şekilde test edin.
Google Play Politikalar Kullanıcının gizliliğini ve sağlığını korumaya yardımcı olan, sonraki bölümlerde açıklanan gözlüklere özel politikalar da dahil olmak üzere tüm Google Play politikalarına uyun.

Ses Deneyimi

Sesli uyarılar

Sesli uyarılar kısa olmalı ve yalnızca en alakalı, uygulanabilir bilgileri sağlamalıdır. Hata durumları için sesli uyarılar, internet bağlantısı olmasa da çalışmalıdır.

Takip ve daha ayrıntılı sohbetler için uygulama içi temsilci veya Gemini kullanılmalıdır.

Ses odağı Ses odağı, giriş odağıyla yakından ilişkilidir. Uygulamalar, Android yönergelerine uygun şekilde ses odağı istemeli ve bırakmalıdır.
Ses Politikaları Hareketler ve LED davranışları, yalnızca sesli deneyimlerle ilgili tüm politikalara uygun olmalıdır.

Yalnızca sesli deneyimlerle ilgili politikalar

Akıllı gözlüklerde güvenli ve saygılı salt ses deneyimleri sunmak için tüm uygulamaların aşağıdaki politikalarda yer alan şartlara uyması gerekir.

Uygulama güvenliği

Google Play aracılığıyla dağıtılan tüm uygulamaların tüm Google Play Geliştirici Politikaları'na uyması gerektiğini hatırlatmak isteriz.

Aşağıdaki faaliyetler kesinlikle yasaktır ve uygulamalar bu faaliyetleri kolaylaştırmamalı veya teşvik etmemelidir:

  • Kişisel bilgi toplama
  • Yüz tanıma veya biyometrik kimlik tespiti
  • Güvenlik izleme
  • İzinsiz oluşturulan/yayınlanan mahrem görüntülerin (NCII) oluşturulması veya yayılması

Aşağıdaki üçüncü taraf korumaları tüm uygulamalar için zorunludur:

Kamera güvenliği

Giyilebilir kamera sensörlerine erişen uygulamalar, çevredeki kişilerin gizliliğine saygı göstermeli ve aşağıdakilere uymalıdır:

Video ve fotoğraf kısıtlaması

İzin verilen etkileşimler

Açıklama

Video görüşmeleri

Uygulamaların, görüntülü görüşme amacıyla giyilebilir kamera sensörlerini kullanmasına izin verilir.

Sahne anlama ve ortam algılama

Uygulamaların, ortam kamerası algılama veya sahne algılama için giyilebilir kamera sensörlerini kullanmasına izin verilir.

Yasaklanan etkileşimler

Açıklama

Sosyal medyada canlı video yayını ve herkese açık yayın yapma

Uygulamalar, giyilebilir kamera sensörlerini Video Sosyal Canlı Yayın için kullanmamalıdır. Buna her türlü gerçek zamanlı, bire çok canlı yayın, herkese açık yayın veya herkese açık feed'lere ve açık kanallara yayın dahildir.

Anlık yüz tanıma ve kişisel bilgi toplama

Uygulamalar, üçüncü şahısların kimliği tanımlayabilecek bilgilerini (PII) ortaya çıkarmak için kamera sensörlerini kullanarak yüz tanıma işlemi yapmamalıdır. Örneğin: adlar, ev adresleri, telefon numaraları veya işverenleri.

İzinsiz oluşturulan/yayınlanan mahrem görüntü (NCII) veya yasa dışı içerik üretimi

Uygulamalar, izinsiz oluşturulan/yayınlanan mahrem görüntülerin (NCII) veya yasa dışı içeriklerin (ör. CSAM) oluşturulmasını kolaylaştırmak için kamera sensörlerini kullanmamalıdır.

Ses güvenliği

Mikrofon dizisini kullanan uygulamalar, çevredeki kişilerin gizliliğine saygı göstermeli ve aşağıdaki şartlara uymalıdır:

Yasaklanan etkileşimler

Açıklama

Kalıcı gizlice dinleme

Uygulamalar, kullanıcı tarafından başlatılan bir görevde kullanıcı uygulamayla aktif olarak etkileşimde değilken kalıcı, arka planda ses kaydı veya transkript oluşturma işlemi yapmamalıdır.

Konuşma tanıma

Uygulamalar, mikrofon dizisini kullanarak cihazı takmayan kişilerin veya etraftakilerin seslerini tanımlamamalıdır.

Programatik engelleme veya değişiklik

Uygulamalar, sistem tarafından uygulanan ses gürültü gidericileri değiştirmemeli veya devre dışı bırakmamalıdır. Uygulamalar ayrıca kullanıcıları ses gürültü gidericilerini değiştirmeye veya devre dışı bırakmaya teşvik etmemeli ya da yönlendirmemelidir.

Hareketler ve giriş

Bu politikalar, yalnızca sesli deneyimler sırasında gözlüklerde hareket etkinliklerinin uygulanmasına ilişkin şartları özetler. Farklı uygulamalarda ve Android XR cihazlarda tutarlı ve sezgisel bir kullanıcı deneyimi sunmak için bu yönergelere uyun. Uygulamanızın ses odağı varsa ön plan durumundan bağımsız olarak tüm girişlerin çalışması beklenir.

1. Dokunma hareketi

Dokunma hareketi, dokunmatik alan giriş alanına hızlı ve tek bir dokunuştur. Kullanıcılar, gözlükte işlem yapmak için dokunma hareketini kullanır. Bu, kullanıcının durumuna göre bilgi sağlamak veya son sesli mesajı tekrarlamak gibi sesli oynatmayı başlatabilir. Ses çalınıyorsa dokunarak ses çıkışını duraklatabilir veya durdurabilirsiniz.

Örnekler
İzin verilen etkileşimler Açıklama

Alakalı bir istem oynatma

Kullanıcıya aşağıdaki gibi alakalı bilgiler verin:

  • Kullanıcı izinleri isteniyor.
  • Kullanıcının mevcut durumuna dayalı bilgiler. Örneğin, "Sağınızda Golden Gate Köprüsü var" diyebilir.
  • Kullanıcıya verilen son sesli mesajı tekrarlama.

Ses çalınırken dokunursanız ses durdurulur.

Mikrofonun sesini kapatır veya açar

Kullanıcıların, mikrofon girişi alan bir deneyim sırasında dokunma hareketiyle mikrofonlarının sesini kapatmasına veya açmasına izin verin.

Mikrofonun sesi kapatıldığında veya açıldığında sesli geri bildirim sağlanmalıdır.

Yasaklanan etkileşimler Açıklama

Alakasız bilgiler veya reklamlar

Dokunma hareketini reklam yayınlamak veya kullanıcının mevcut fiziksel durumu ya da bağlamıyla alakasız bilgiler sağlamak için kullanmayın.

Oyun girişleri ve hızlı sürekli işlemler

Dokunma hareketi, hızlı ve tek dokunuşlu işlemler için tasarlanmıştır. Standart sistem kontrollerini kesintiye uğratan etkileşimli oyunlar veya yüksek frekanslı giriş görevleri için sürekli bir kontrol cihazı olarak yeniden kullanılmamalıdır.

Suç, şiddet veya kendine zarar vermeyi teşvik etme

Dokunma hareketi, aşırılık yanlısı keşif, silah üretimi veya kendine zarar verme gibi yasa dışı ya da zararlı eylemleri kolaylaştıran uygulanabilir talimatları hiçbir zaman tetiklememelidir.

2. Kamera işlemi hareketi

Kamera hareketi, kamera düğmesine arka arkaya iki kez basmayı içerir. Kameraya erişen uygulamalar, bu etkinliği doğrudan uygulamaya sensör verileri sağlayan bir kamera işlemi olarak ele almalıdır.

Örnekler
İzin verilen etkileşimler Açıklama

Uygulamada kamerayı etkinleştirme

Uygulamada kamera görüntü akışını başlatma. Bu, fotoğraf veya video çekmek için kamera görüntü akışını etkinleştirmeyi ya da kamera feed'ini kullanarak ortam kamerası işlemeye izin vermeyi içerir.

Kamera görüntü akışı kullanımı, kamera ve mikrofon kayıtlarıyla ilgili tüm Android politikalarına ve Google Play Geliştirici Politika Merkezi'ndeki Kullanıcı Verileri Politikası'na uygun olmalıdır. Ayrıca Zorbalık ve Taciz Politikası, başkalarının kişisel bilgilerini ifşa eden veya başkalarını herkesin önünde istismar eden uygulamalara izin vermez.

Yasaklanan etkileşimler Açıklama

Özel girişler ve yeniden eşleme

Kameraya iki kez basma hareketi, yalnızca kamera görüntü akışını etkinleştirmek ve sensör verilerini doğrudan uygulamaya sağlamak için kullanılmalıdır. Bu donanım hareketini kamera dışı işlevlere, özel kısayollara veya alternatif uygulama deneyimlerine yeniden eşlememelisiniz.

Bağımsız veya yapay sensör kullanımı

Kamerayı açmak için iki kez basma hareketini algılayan uygulamalar, bu hareketi görsel sensör verileri için gerçek bir istek olarak değerlendirmelidir. Kamera feed'ini kasıtlı olarak yok sayarken, silerken veya bastırırken donanım düğmesini ele geçirmek için iki kez basma etkinliğini kaydedemezsiniz.

Açıklama eksikliği veya yanıltıcı kullanım

Kamerayı etkinleştirmek için kameraya iki kez basma hareketi kullanıldığında, ilk izin verme veya uygulama kurulumu sırasında mobil uygulama akışında kameranın tam olarak ne için kullanıldığı konusunda kullanıcıyı açıkça bilgilendirmeniz gerekir. Örneğin, canlı yayın, fotoğraf çekme veya yapay zeka işlemi geçerli kullanım alanları olabilir. Kamera görüntü akışı, kullanıcının açıkça kabul etmediği bir işlev için kesinlikle kullanılmamalıdır.

3. Tek parmakla geri kaydırma hareketi

Tek parmakla geri kaydırma hareketi, dokunmatik alan giriş alanı boyunca sürekli bir geri hareketi içerir. Sistem, onBack() yöntemini çağırarak yalnızca sesli deneyimler sırasında bile bu hareketi destekler. Uygulamanız, mevcut deneyimden çıkarak veya kullanıcıyı önceki bir uygulama durumuna döndürerek bu etkinliği işlemelidir.

Yasaklanan etkileşimler Açıklama

Çıkış komutunu ele geçirme

Geri kaydırma hareketi, deneyimden çıkmak veya kullanıcıyı önceki bir uygulama durumuna döndürmek için her zaman onBack() yöntemini çağırmalıdır. Özel işlemlere, yeni medya lansmanlarına veya reklamlara hiçbir zaman eşlenmemelidir.

Sahte çıkışlar (gizli dinleme)

Bu hareket çağrıldığında uygulamalar gerçekten çıkış yapmalı veya birincil sensör kullanımlarını askıya almalıdır. Arka planda gizlice aktif sensörler bulundurarak çıkış simülasyonu yapmayın.

LED davranışları

Uygulamanız, mikrofon ve kamera erişimine göre LED sistem davranışını değiştirmemelidir.

Yasaklanan etkileşimler Açıklama

Programatik engelleme veya değişiklik

Uygulamalar, mikrofon ve kamera erişimine göre sistem tarafından zorunlu kılınan dışa bakan LED ve kullanıcılara yönelik LED davranışını değiştirmemeli, karartmamalı veya devre dışı bırakmamalıdır. Uygulamalar ayrıca kullanıcıları LED'lerin davranışını değiştirmeye, karartmaya veya devre dışı bırakmaya teşvik etmemeli ya da yönlendirmemelidir.

Engelleme ve sabotaj algılamayı atlatma

Uygulamalar, cihazın engelleme algılama algoritmalarını atlamamalı veya bunlara müdahale etmemeli ya da kullanıcıları bu yönde teşvik etmemeli veya yönlendirmemelidir. Bu algoritmalar, dışarıya bakan LED fiziksel olarak kapatılırsa veya hasar görürse kaydı programatik olarak durduracak şekilde tasarlanmıştır.