Procesy rejestracji użytkowników na Androidzie

Ten przewodnik zawiera wskazówki dotyczące UX, które pomogą Ci zaprojektować płynne uprawnienia i udostępnianie urządzeń za pomocą interfejsów API Google Home na potrzeby procesu wprowadzającego w aplikacji.

Główne tematy opisane w tym artykule:

• Dlaczego warto udostępniać urządzenia w Google Home?
• Kluczowe etapy procesu udostępniania
• Implementacja techniczna
• Sprawdzone metody na zapewnienie wygody użytkowania

Dlaczego warto udostępniać urządzenia Google Home?

Aby korzystać z możliwości, jakie dają interfejsy Home API, użytkownicy muszą udostępniać swoje urządzenia Google Home, ponieważ:

• Jest to wymaganie techniczne, aby Google mogło używać tych urządzeń w automatyzacjach.
• Pomaga to zapewnić spójne i elastyczne działanie Google Home.
  • Zapewnienie spójnego wyświetlania urządzeń w aplikacjach korzystających z Home API jest kluczowe, aby uniknąć rozdrobnienia i dezorientacji użytkowników, którzy musieliby przełączać się między aplikacjami, aby wykonywać podstawowe zadania.

Kluczowe elementy procesu udostępniania

Komponent	Program	Opis
interfejsu API uprawnień na Androidzie,	Interfejsy Home API dotyczące uprawnień na Androidzie	Prosi użytkowników o przyznanie uprawnień aplikacji. Zanim aplikacja będzie mogła korzystać z interfejsów Home API, musi mieć uprawnienia dostępu do urządzeń w domu użytkownika (w interfejsie API nazywanym strukturą). Kolejność, w jakiej ten krok jest wykonywany, zależy jednak od scenariusza dewelopera i jest opisana w sekcji Wdrażanie techniczne.
Łączenie z chmury do chmury	Z chmury do chmury na potrzeby łączenia kont	Umożliwia rozpoczęcie procesu łączenia kont, aby udostępniać urządzenia połączone z chmurą w Google Home z poziomu aplikacji. Aby ułatwić użytkownikom korzystanie z tej funkcji, zalecamy użycie precyzyjnego linku (dostępnego zarówno na Androidzie, jak i na iOS), który przekierowuje użytkowników bezpośrednio na stronę łączenia kont w GHA.
Commissioning API na Androidzie	Uruchamianie Matter	Interfejs API jest zwykle postrzegany jako interfejs do uruchamiania nowych urządzeń Matter, ale można go też używać do dodawania sieci Google do urządzeń Matter, które zostały już uruchomione w innej sieci. Dlatego jest to przydatne narzędzie w procesie wprowadzania.

Implementacja techniczna

Sposób tworzenia procesów udostępniania zależy od tego, które urządzenia planujesz udostępnić Google.

W przypadku poniższych scenariuszy zalecamy wykonanie czynności w podanej kolejności. Dzięki temu użytkownicy mogą liczyć na lepsze wrażenia.

Produkujesz tylko urządzenia Matter

Produkujesz urządzenia obsługujące standard Matter, które chcesz dodać do Google Home.

1. Wywołaj interfejs API uprawnień na Androidzie.

2. Wywołaj interfejs Commissioning API na Androidzie na każdym urządzeniu Matter, które zostało wcześniej dodane do innej sieci.

   1. Udostępnianie Matter musi być wykonywane dla każdego urządzenia osobno, a wiele ekranów wymaga danych wejściowych użytkownika. Dlatego zalecamy przeprowadzenie użytkownika przez ten proces:
      • udostępnianie użytkownikom listy urządzeń Matter, które nie są udostępniane Google;
      • umożliwienie użytkownikom rozpoczęcia procesu udostępniania urządzenia (za pomocą interfejsu Commissioning API) przez kliknięcie urządzeń na tej liście.
      • Powrót do listy urządzeń Matter, na której użytkownik widzi postęp zadania i stan udostępniania.

Produkujesz tylko urządzenia udostępniane Google za pomocą interfejsów Cloud-to-cloud API.

1. Zastosuj Cloud-to-cloudprecyzyjne linki. Spowoduje to dodanie urządzeń do Google Home Graph.

   1. Zalecamy najpierw przeprowadzić łączenie Cloud-to-cloud, aby uniknąć potencjalnie mylących sytuacji, takich jak wyświetlenie użytkownikowi listy zawierającej urządzenia udostępniane Google i urządzenia nieudostępniane Google.

2. Wywołaj interfejs API uprawnień na Androidzie.

Produkujesz zarówno urządzenia połączone z chmurą, jak i urządzenia Matter

1. Zastosuj Cloud-to-cloudprecyzyjne linki.

   1. Zalecamy najpierw przeprowadzić łączenie Cloud-to-cloud, aby uniknąć potencjalnie mylących sytuacji, takich jak wyświetlenie użytkownikowi listy zawierającej urządzenia udostępniane Google i urządzenia nieudostępniane Google.

2. Wywołaj interfejs API uprawnień na Androidzie.

3. Wywołaj interfejs Commissioning API na Androida na każdym urządzeniu Matter, które zostało wcześniej dodane do innej sieci.

   1. Udostępnianie Matter musi być wykonywane dla każdego urządzenia osobno, a wiele ekranów wymaga danych wejściowych użytkownika. Dlatego zalecamy przeprowadzenie użytkownika przez ten proces:
      • udostępnianie użytkownikom listy urządzeń Matter, które nie są udostępniane Google;
      • umożliwienie użytkownikom rozpoczęcia procesu udostępniania urządzenia (za pomocą interfejsu Commissioning API) przez kliknięcie urządzeń na tej liście.
      • Powrót do listy urządzeń Matter, na której użytkownik widzi postęp zadania i stan udostępniania.

Nie masz urządzeń, które możesz udostępnić Google

Wywołaj interfejs Permissions API.

Sprawdzone metody na zapewnienie wygody użytkowania

Ta sekcja zawiera kilka głównych ścieżek użytkownika, które warto wziąć pod uwagę podczas tworzenia aplikacji korzystającej z interfejsów Home API.

Gdzie wprowadzić udostępnianie urządzenia w aplikacji

Ta lista nie jest wyczerpująca i możesz znaleźć inne okazje do przedstawienia użytkownikom Google Home i udostępniania im treści.

Te opcje nie wykluczają się wzajemnie i istnieje wiele punktów wejścia:

W menu Ustawienia

Użytkownicy są prawdopodobnie przyzwyczajeni do konfigurowania połączeń z ekosystemami Google Home za pomocą menu ustawień, więc ta metoda pozwala im kontynuować ten schemat.

Możesz oddzielić udostępnianie urządzeń (łączenie Cloud-to-cloud i interfejs API Matter Commissioning) od uprawnień aplikacji (interfejs API Permissions). Dzięki temu użytkownicy mogą kontrolować, które kroki wykonują, a Ty możesz wyświetlać im stan połączenia.

Korzystanie z urządzeń w automatyzacjach uruchamianych przez Google

Na karcie Automatyzacje użytkownicy mogą kliknąć punkt wejścia do procesu udostępniania, przeczytać ekran z propozycją wartości, który jasno wyjaśnia korzyści płynące z kontynuowania, a następnie szybko przejść przez proces przyznawania uprawnień.

Tylko z poziomu uruchamiania

Ten scenariusz dotyczy głównie partnerów, którzy produkują tylko urządzenia Matter (bez urządzeń Cloud-to-cloud) i nie mają własnej sieci Matter. Punkt wejścia dla użytkownika może pojawić się zaraz po ekranie typu „out-of-box”, na którym udostępnianie urządzeń Matter (za pomocą interfejsu Commissioning API) i przyznawanie uprawnień aplikacji (za pomocą interfejsu Permissions API) są częścią tego samego procesu.

Logika udostępniania

Oto kilka sugestii dotyczących promptów użytkownika:

• Zasadniczo należy prosić użytkowników o wykonanie tylko brakujących kroków wymaganych do wprowadzenia na platformę. Na przykład klienci, którzy od dawna korzystają z usług, mogą już udostępniać Google urządzenia OEM. W takim przypadku muszą tylko przejść przez proces przyznawania uprawnień interfejsom Home API, aby aplikacja miała dostęp do ich Google Home.

• Wielu administratorów Google Home może udostępniać strukturę Google Home, a w niektórych przypadkach do udostępniania urządzeń Google może być używane tylko jedno konto. W związku z tym ukończenie połączenia z Cloud-to-cloud nie powinno być warunkiem koniecznym do wyświetlenia prośby o przyznanie uprawnień do interfejsów API Google Home.

Sugestie dotyczące projektowania wizualnego

• Wyraźna korzyść z rejestracji w Google Home (np. „Twórz zaawansowane automatyzacje dzięki Google Home” lub „Steruj urządzeniami za pomocą wybranych aplikacji”).

• wezwanie do działania (np. „Rozpocznij”) i sposób anulowania, jeśli użytkownik nie chce kontynuować.

• Jeśli jest na to miejsce, wyjaśnienie, co się stanie, gdy użytkownik przejdzie przez ekrany.

• W przypadku Matter, gdy użytkownik wcześniej przyznał Ci dostęp do swojego domu za pomocą interfejsów Home API, możesz umożliwić udostępnianie urządzeń w jego domu Google Home podczas dodawania nowych urządzeń. Możesz na przykład dodać urządzenie Matter do swojej sieci, a następnie poprosić użytkownika o dodanie tego urządzenia do sieci Google.

Sugerowane treści

Użytkownicy łatwiej ufają temu, co rozumieją i co stanowi dla nich wartość dodaną. Zapewnij użytkownikom informacje, które pozwolą im podejmować świadome decyzje, w tym informacje o kompromisach.

Kluczowa prezentacja

Użytkownicy nie będą kontynuować udostępniania urządzeń, jeśli nie będzie w tym silnej propozycji wartości.

• Zwróć szczególną uwagę na to, jak pozycjonujesz ofertę.
• Zadbaj o to, aby był atrakcyjny, ale nie obiecuj za dużo.
• Jeśli użytkownik potrzebuje urządzenia, o którym mowa w Twojej prezentacji, upewnij się, że jest to wyraźnie zaznaczone, aby nie napotkał nieoczekiwanej przeszkody.
• Możesz mieć tylko jedną szansę na przyciągnięcie tych użytkowników, więc wykorzystaj ją.

Sprawdzone metody

1. Zacznij od punktu widzenia użytkownika – podejścia „co ja z tego będę mieć?”.
2. Nie pisz więcej niż 4 wierszy treści w bloku sekcji. Więcej słów może spowodować, że użytkownik straci zainteresowanie. Ważne, aby informacje były przedstawione w sposób przejrzysty i zrozumiały, niekoniecznie zwięzły.
3. Automatyzacje to świetna zabawa. Jeśli pozwala na to miejsce, podaj ciekawy, ale przydatny przykład.
4. Jeśli pasuje to do Twojej ogólnej strategii, spróbuj użyć żartobliwego tonu.
5. Używaj sformułowań zachęcających do działania, takich jak „Rozpocznij”.