Wytyczne dotyczące jakości aplikacji na inteligentne okulary rozszerzają podstawowe standardy mobilne dotyczące ogólnej jakości aplikacji.
Te wskazówki i zasady dotyczące jakości aplikacji koncentrują się na kluczowych interakcjach multimodalnych, które są unikalne dla platformy Android XR na inteligentnych okularach, zgodnie z opisem w definicjach poziomów zgodności, listach kontrolnych i zasadach dotyczących treści tylko audio. Zapoznaj się z tymi sekcjami, aby sprawdzić, czy Twoja aplikacja zapewnia użytkownikom dobre wrażenia na okularach audio i okularach z wyświetlaczem.
Rozszerzone funkcje: definicje poziomów zgodności aplikacji mobilnych
Zapoznaj się z poniższymi definicjami poziomów zgodności, aby dowiedzieć się, jaki poziom obsługi zapewnia Twoja aplikacja w przypadku rozszerzonych funkcji na okularach.
Zgodny
Zgodna aplikacja mobilna zapewnia lepsze wrażenia na okularach bez dodatkowego wysiłku ze strony dewelopera. Jest to istniejąca aplikacja mobilna na Androida, która obsługuje połączenie Bluetooth i nie została zmodyfikowana pod kątem okularów. Platforma Android XR automatycznie obsługuje ten typ aplikacji, o ile nie korzysta ona z nieobsługiwanych funkcji sprzętowych.
Aby to umożliwić, platforma płynnie rozszerza standardowe interfejsy systemu Android na okulary. Na przykład powiadomienia są automatycznie wyświetlane w polu widzenia użytkownika lub odczytywane na głos (w przypadku okularów audio), dzięki czemu użytkownik może wykonywać ważne zadania bez konieczności wyjmowania telefonu.
Zróżnicowane
Zróżnicowane środowisko rozszerzone jest specjalnie zaprojektowane dla okularów i wykorzystuje pełne możliwości pakietu Jetpack XR SDK oraz unikalny sprzęt o tym formacie.
Aby tworzyć te przełomowe rozwiązania, użyj tych bibliotek:
- Jetpack Compose Glimmer: zestaw narzędzi interfejsu Compose do tworzenia minimalistycznych i czytelnych interfejsów zoptymalizowanych pod kątem wyświetlaczy optycznych.
- Jetpack Projected: zarządzaj zasobami i płynnie łącz funkcje telefonu towarzyszącego (hosta) i okularów (urządzenia, na które jest wyświetlany obraz).
- ARCore dla Jetpack XR: dostęp do zaawansowanych funkcji percepcji, takich jak śledzenie urządzenia i Geospatial API, które umożliwiają lokalizację i funkcje zależne od kontekstu, takie jak nawigacja piesza.
Ulepszone funkcje: lista kontrolna jakości aplikacji mobilnej
Aby zapewnić użytkownikom doskonałe wrażenia podczas korzystania z rozszerzonych funkcji, zapoznaj się z poniższymi listami kontrolnymi i testami zgodności.
Te listy kontrolne i testy określają kompleksowy zestaw wymagań dotyczących jakości dla większości typów aplikacji na Androida.
Zgodny
Zgodne aplikacje to istniejące aplikacje mobilne na Androida, które działają automatycznie na okularach dzięki wykorzystaniu standardowych interfejsów Androida (np. standardowych powiadomień i aktualizacji na żywo). W przypadku tego poziomu zgodności nie jest wymagany żaden kod przeznaczony dla okularów.
Aplikacja musi spełniać te podstawowe wymagania:
- Powiadomienia: upewnij się, że wszystkie powiadomienia wymagające działania i pilne powiadomienia korzystają ze standardowych interfejsów API
NotificationManagerAndroida, dzięki czemu mogą być prawidłowo konwertowane przez platformę na odczyty audio (urządzenia audio) lub minimalistyczne nakładki wizualne (urządzenia z wyświetlaczem). - Aktualizacje na żywo: jeśli aplikacja ma trwającą aktywność (np. zadania związane z postępem), musi używać standardowej platformy powiadomień o aktualizacjach na żywo, aby platforma mogła wyświetlać te informacje w sposób czytelny i obsługiwany bez użycia rąk.
- Google Play: aplikacja musi być zgodna ze wszystkimi obowiązującymi zasadami dotyczącymi Androida i Google Play. Zgodność jest określana automatycznie na podstawie deklaracji w pliku manifestu i wymagań dotyczących funkcji.
Zróżnicowane
Aplikacje zróżnicowane są tworzone specjalnie przy użyciu pakietu Jetpack XR SDK (z bibliotekami takimi jak Jetpack Compose Glimmer, Jetpack Projected i ARCore dla Jetpack XR), aby zapewniać wysoce zoptymalizowane wrażenia użytkownika z uwzględnieniem otoczenia lub korzystać z unikalnych funkcji rozszerzonych. Sprawdź wymagania, które dotyczą Twojej aplikacji.
| Kategoria | Obszar | Wskazówki |
|---|---|---|
Główna funkcjonalność |
Rozpocznij aktywność na okularach | Funkcje powinny być uruchamiane i sterowane bezpośrednio z aplikacji mobilnej, zwłaszcza w przypadku początkowej konfiguracji lub przeglądania dużej ilości informacji przed przekazaniem ich do okularów z wyświetlaczem i funkcjami audio, które mają mniejszy zestaw funkcji UX. |
| Polecenie otwarcia aplikacji | Funkcje powinny być skonfigurowane tak, aby po uruchomieniu na okularach z Gemini nie wymagały żadnych działań. Dzięki temu, gdy użytkownik wyda polecenie „Otwórz [aplikację]”, aplikacja pominie tradycyjne menu i natychmiast przejdzie do trybu audio, np. trybu tła tylko z dźwiękiem, stanu słuchania na żywo lub natychmiastowego sygnału dźwiękowego. | |
| Uruchamianie aparatu | Dostęp do aparatu można uzyskać z poziomu punktu wejścia lub aktywności na urządzeniu mobilnym albo bezpośrednio za pomocą gestu działania aparatu na urządzeniu. Jeśli dostęp do kamery jest inicjowany z urządzenia mobilnego, użytkownik powinien usłyszeć odliczanie przed rozpoczęciem transmisji z kamery. | |
| Przejrzystość i spójność (gesty) | Gesty (takie jak głos, kliknięcia lub przesunięcia palcem) powinny być zaimplementowane w jasny i spójny sposób, zgodnie z oczekiwaniami użytkowników dotyczącymi typowych interakcji. Zasady dotyczące podstawowych gestów są opisane w odpowiednich sekcjach poniżej. | |
Wydajność i stabilność |
Bateria | Zoptymalizuj procesy w tle zgodnie z ograniczeniami dotyczącymi zadań w tle na Androidzie i ogranicz korzystanie z czujników, które zużywają dużo energii (np. przekazu z kamery), gdy nie są aktywnie używane. |
| Liczba klatek i rozdzielczość kamery | Dostęp do przekazu z kamery powinien być skonfigurowany tak, aby używać najbardziej wydajnej konfiguracji (najniższa liczba klatek i rozdzielczość) w danym przypadku użycia. Więcej informacji o zalecanych konfiguracjach w przypadku poszczególnych zastosowań znajdziesz w wskazówkach dla deweloperów. | |
| Bezpieczeństwo | Bezpieczeństwo | Funkcje powinny być zaprojektowane wokół działań inicjowanych przez użytkownika i w jak najmniejszym stopniu odwracać jego uwagę od otoczenia, zwłaszcza podczas ruchu lub w przestrzeni publicznej. |
| Prywatność i bezpieczeństwo | Uprawnienia | Aplikacja musi poprosić o uprawnienia dotyczące okularów, aby uzyskać dostęp do sprzętu (np. aparatu lub mikrofonu). W tym celu musi użyć interfejsu API do wyświetlania próśb o uprawnienia i obsłużyć przekierowanie na urządzenie hosta, aby uzyskać zgodę użytkownika. |
Zasady ogólne |
Ułatwienia dostępu | Weź pod uwagę użytkowników o różnych potrzebach i w stosownych przypadkach zapewnij alternatywne metody wprowadzania danych (np. polecenia głosowe jako alternatywę dla gestów na touchpadzie). |
| Testowanie | Dokładnie przetestuj wszystkie implementacje gestów i elementów wizualnych w różnych scenariuszach użytkownika, warunkach oświetleniowych i środowiskach o dużym natężeniu ruchu, korzystając z emulatora Androida XR i podglądów funkcji kompozycyjnych. | |
| Google Play | Zasady | Przestrzegaj wszystkich zasad Google Play, w tym zasad dotyczących okularów opisanych w kolejnych sekcjach, które pomagają chronić prywatność i dobrostan użytkowników. |
Wrażenia dźwiękowe |
Alerty głosowe | Alerty głosowe muszą być zwięzłe i zawierać tylko najważniejsze, przydatne informacje. Alerty głosowe o błędach powinny działać niezależnie od połączenia z internetem. Dalsze pytania i bardziej szczegółowe rozmowy powinny być wyraźnie oczekiwane przy użyciu agenta w aplikacji lub Gemini. |
| Aktywność audio | Aktywność audio jest ściśle powiązana z zaznaczeniem pola wpisywania. Aplikacje powinny prosić o fokus audio i rezygnować z niego zgodnie ze wskazówkami dotyczącymi Androida. | |
| Zasady dotyczące dźwięku | Gesty i zachowania diod LED powinny być zgodne ze wszystkimi zasadami dotyczącymi funkcji tylko audio. |
Zasady dotyczące treści audio
Wszystkie aplikacje muszą spełniać wymagania określone w poniższych zasadach, aby promować bezpieczne i pełne szacunku korzystanie z funkcji audio na inteligentnych okularach.
Bezpieczeństwo aplikacji
Przypominamy, że wszystkie aplikacje rozpowszechniane w Google Play muszą być zgodne ze wszystkimi zasadami dla deweloperów w Google Play.
Te działania są surowo zabronione, a aplikacje nie mogą ich ułatwiać ani promować:
- Doxing
- rozpoznawanie twarzy lub identyfikacja biometryczna;
- Nadzór
- tworzenie lub rozpowszechnianie zdjęć o charakterze erotycznym uzyskanych, rozpowszechnianych i powielanych bez zgody osoby, którą przedstawiają;
W przypadku wszystkich aplikacji wymagane są te zabezpieczenia osób postronnych:
Bezpieczeństwo aparatu
Aplikacje, które mają dostęp do czujników aparatu w urządzeniach do noszenia, muszą szanować prywatność osób postronnych i spełniać te wymagania:
Ograniczenie dotyczące filmów i zdjęć
Dozwolone interakcje |
Opis |
|---|---|
Rozmowy wideo |
Aplikacje mogą używać czujników aparatu na urządzeniu do noszenia na potrzeby rozmów wideo. |
Rozpoznawanie sceny i wykrywanie otoczenia |
Aplikacje mogą używać czujników aparatu w urządzeniach do noszenia na potrzeby wykrywania przez kamerę lub rozpoznawania sceny. |
Niedozwolone interakcje |
Opis |
|---|---|
Transmisje na żywo w mediach społecznościowych i publiczne transmitowanie na żywo |
Aplikacje nie mogą używać czujników aparatu w urządzeniach do noszenia do transmitowania na żywo w mediach społecznościowych, co obejmuje transmisje na żywo w czasie rzeczywistym, transmisje publiczne lub przesyłanie do publicznych kanałów i kanałów otwartych. |
Identyfikacja twarzy w czasie rzeczywistym i doxxing |
Aplikacje nie mogą używać czujników aparatu do rozpoznawania twarzy w celu ujawniania informacji umożliwiających identyfikację osób postronnych. na przykład imiona i nazwiska, adresy domowe, numery telefonów lub nazwy pracodawców. |
Generowanie zdjęć o charakterze erotycznym uzyskanych, rozpowszechnianych i powielanych bez zgody osoby, którą przedstawiają, lub treści niezgodnych z prawem |
Aplikacje nie mogą używać czujników aparatu do ułatwiania tworzenia zdjęć o charakterze erotycznym uzyskiwanych, rozpowszechnianych i powielanych bez zgody osoby, którą przedstawiają, ani do generowania jakichkolwiek treści niezgodnych z prawem (np. materiałów związanych z wykorzystywaniem seksualnym dzieci). |
Bezpieczeństwo dźwięku
Aplikacje korzystające z mikrofonu macierzowego powinny szanować prywatność osób postronnych i muszą spełniać te wymagania:
Niedozwolone interakcje |
Opis |
|---|---|
Ciągłe podsłuchiwanie |
Aplikacje nie mogą stale nagrywać dźwięku ani tworzyć transkrypcji w tle, gdy użytkownik nie korzysta aktywnie z aplikacji w ramach zadania zainicjowanego przez użytkownika. |
Identyfikacja mowy |
Aplikacje nie mogą używać mikrofonu macierzowego do identyfikowania głosów osób, które nie noszą urządzenia, ani osób postronnych. |
Automatyczne pomijanie lub modyfikowanie |
Aplikacje nie mogą zmieniać ani wyłączać systemowych funkcji redukcji szumów. Aplikacje nie mogą też zachęcać użytkowników do zmiany lub wyłączenia funkcji redukcji szumów ani ich do tego nakłaniać. |
Gesty i wprowadzanie danych
Te zasady określają wymagania dotyczące implementacji zdarzeń gestów na okularach podczas korzystania z funkcji tylko audio. Przestrzegaj tych wytycznych, aby zapewnić spójne i intuicyjne wrażenia użytkownika w różnych aplikacjach i na urządzeniach z Androidem XR. Wszystkie dane wejściowe powinny działać, jeśli aplikacja ma fokus audio, niezależnie od jej stanu na pierwszym planie.
1. Gest dotknięcia
Gest kliknięcia to szybkie, pojedyncze dotknięcie obszaru wprowadzania na touchpadzie. Dotknięcie to sposób, w jaki użytkownik wykonuje działanie na okularach. Może to spowodować odtworzenie dźwięku, np. w celu przekazania informacji na podstawie stanu użytkownika lub powtórzenia ostatniej wiadomości głosowej. Jeśli odtwarzany jest dźwięk, dotknięcie może wstrzymać lub zatrzymać odtwarzanie.
Przykłady
| Dozwolone interakcje | Opis |
|---|---|
Odtwarzanie odpowiedniego prompta |
Podaj użytkownikowi istotne informacje, takie jak:
Kliknięcie podczas odtwarzania dźwięku spowoduje jego zatrzymanie. |
Włącz lub wyłącz wyciszenie mikrofonu |
Zezwalaj użytkownikom na wyciszanie i wyłączanie wyciszenia mikrofonu za pomocą gestu dotknięcia, gdy korzystają z funkcji, która wymaga użycia mikrofonu. Gdy mikrofon jest wyciszony lub wyłączone jest wyciszenie, powinna być odtwarzana informacja dźwiękowa. |
| Niedozwolone interakcje | Opis |
|---|---|
nieistotne informacje lub reklamy, |
Nie używaj gestu dotknięcia do wyświetlania reklam ani informacji, które nie są istotne dla bieżącego stanu fizycznego lub kontekstu użytkownika. |
Dane wejściowe w grach i szybkie, ciągłe działania |
Gest kliknięcia jest przeznaczony do szybkich działań wykonywanych jednym dotknięciem. Nie może być używany jako kontroler ciągły w grach interaktywnych ani do zadań wymagających częstego wprowadzania danych, które zakłócają standardowe sterowanie systemem. |
Umożliwianie przestępstw, przemocy lub samookaleczania |
Gest kliknięcia nie może nigdy wywoływać instrukcji, które ułatwiają działania nielegalne lub szkodliwe, takie jak rekrutacja do organizacji ekstremistycznych, tworzenie broni czy samookaleczanie. |
2. Gest działania aparatu
Gest działania aparatu polega na dwukrotnym szybkim naciśnięciu przycisku aparatu. Aplikacje, które mają dostęp do aparatu, muszą traktować to zdarzenie jako działanie aparatu, które dostarcza dane z czujnika bezpośrednio do aplikacji.
Przykłady
| Dozwolone interakcje | Opis |
|---|---|
Aktywuj aparat w aplikacji |
uruchomienie strumienia z kamery w aplikacji, w tym aktywowanie strumienia z kamery w celu robienia zdjęć, nagrywania filmów lub umożliwienia przetwarzania obrazu z kamery przy użyciu przekazu z kamery; Korzystanie ze strumienia z kamery musi być zgodne ze wszystkimi zasadami Androida dotyczącymi nagrywania obrazu z kamery i dźwięku z mikrofonu oraz z zasadami dotyczącymi danych użytkownika opisanymi w Centrum zasad dla deweloperów w Google Play. Ponadto zasady dotyczące dręczenia i nękania zabraniają publikowania aplikacji, które służą do doxxingu lub publicznego wykorzystywania innych osób. |
| Niedozwolone interakcje | Opis |
|---|---|
Niestandardowe dane wejściowe i ponowne mapowanie |
Gest dwukrotnego naciśnięcia przycisku aparatu musi być używany wyłącznie do aktywowania strumienia z kamery i przekazywania danych z czujnika bezpośrednio do aplikacji. Nie wolno zmieniać mapowania tego gestu sprzętowego na funkcje niezwiązane z aparatem, niestandardowe skróty ani alternatywne wrażenia użytkownika aplikacji. |
używanie odłączonego lub fałszywego czujnika; |
Aplikacje, które przechwytują gest dwukrotnego naciśnięcia przycisku kamery, muszą traktować go jako autentyczną prośbę o dane z czujnika wizualnego. Nie możesz zarejestrować zdarzenia dwukrotnego naciśnięcia, aby przejąć przycisk na urządzeniu, jednocześnie celowo ignorując, odrzucając lub blokując przekaz z kamery. |
Brak informacji lub wprowadzające w błąd wykorzystanie |
Jeśli do aktywowania aparatu używany jest gest dwukrotnego naciśnięcia, musisz wcześniej wyraźnie poinformować użytkownika o tym, jak dokładnie aparat jest używany, w procesie aplikacji mobilnej podczas początkowego przyznawania uprawnień lub konfigurowania aplikacji. Przykłady prawidłowych zastosowań to transmitowanie na żywo, robienie zdjęć lub przetwarzanie danych przez AI. Strumień z kamery nie może być używany do funkcji, na którą użytkownik nie wyraził wyraźnej zgody. |
3. Gest przesunięcia wstecz jednym palcem
Gest przesunięcia wstecz jednym palcem polega na ciągłym ruchu wstecz po obszarze wprowadzania na touchpadzie. System obsługuje ten gest nawet podczas odtwarzania samego dźwięku, wywołując funkcję onBack(). Aplikacja powinna obsłużyć to zdarzenie, zamykając bieżący widok lub przywracając poprzedni stan aplikacji.
| Niedozwolone interakcje | Opis |
|---|---|
Przejęcie polecenia wyjścia |
Gest przesunięcia palcem wstecz musi zawsze wywoływać funkcję |
fałszywe wyjścia (podsłuchiwanie), |
Po wywołaniu tego gestu aplikacje muszą rzeczywiście zakończyć działanie lub zawiesić korzystanie z głównego czujnika. Nie symuluj wyjścia, jednocześnie potajemnie utrzymując aktywne czujniki w tle w celu nadzoru. |
Zachowanie diod LED
Aplikacja nie może zmieniać działania diody LED systemu na podstawie dostępu do mikrofonu i aparatu.
| Niedozwolone interakcje | Opis |
|---|---|
Automatyczne pomijanie lub modyfikowanie |
Aplikacje nie mogą zmieniać, przyciemniać ani wyłączać wymuszanego przez system działania diod LED skierowanych na świat i dla użytkownika, które są powiązane z dostępem do mikrofonu i kamery. Aplikacje nie mogą też zachęcać użytkowników do zmiany, przyciemniania lub wyłączania diod LED ani ich do tego nakłaniać. |
Omijanie wykrywania prób udaremnienia i manipulacji |
Aplikacje nie mogą omijać ani zakłócać działania algorytmów wykrywania przeszkód na urządzeniu, które mają na celu programowe zatrzymanie nagrywania, jeśli dioda LED skierowana na świat jest fizycznie zakryta lub uszkodzona. Nie mogą też zachęcać użytkowników do takich działań ani ich do nich kierować. |