Procesy rejestracji użytkowników na Androidzie

Ten przewodnik zawiera wskazówki dotyczące projektowania interfejsu użytkownika, które pomogą Ci zapewnić płynne działanie interfejsów Google Home API, uprawnień urządzenia i udostępniania w procesie wprowadzania użytkownika w Twojej aplikacji.

Główne tematy opisane w tym artykule to:

• Dlaczego warto udostępniać urządzenia w Google Home?
• Kluczowe etapy procesu udostępniania
• Implementacja techniczna
• Sprawdzone metody dotyczące wrażeń użytkowników

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

Aby korzystać z funkcji interfejsów Home API, użytkownicy muszą udostępniać swoje urządzenia Google Home, ponieważ:

• Jest to wymaganie techniczne, które umożliwia Google korzystanie z tych urządzeń w automatyzacjach.
• Pomaga to w zapewnieniu spójnego i elastycznego działania Google Home.
  • Zapewnienie spójnego wyświetlania urządzeń w aplikacjach obsługujących interfejs Home API jest kluczowe, aby uniknąć rozdrobnienia i dezorientacji użytkowników, którzy muszą przełączać się między aplikacjami, aby wykonywać podstawowe zadania.

Kluczowe komponenty procesu udostępniania

Komponent	Program	Opis
interfejsu Permissions API na Androidzie,	Interfejsy Home API dotyczące uprawnień na Androidzie	Wyświetla użytkownikom prośby o przyznanie uprawnień do aplikacji. Zanim zaczniesz korzystać z interfejsów Home API, Twoja aplikacja musi mieć uprawnienia dostępu do urządzeń w domu użytkownika (w interfejsie API nazywanych strukturą). Kolejność wykonania tego kroku zależy jednak od scenariusza dewelopera i jest uwzględniona w sekcji Implementacja techniczna.
Łączenie z chmury do chmury	Połączenie kont z chmury do chmury	Umożliwia rozpoczęcie procesu łączenia kont, aby udostępniać urządzenia połączone z chmurą w Google Home z poziomu aplikacji. Aby zmniejszyć trudności użytkowników, zalecamy korzystanie z funkcji precyzyjnych linków (dostępnej na Androidzie i iOS), która kieruje użytkowników bezpośrednio do konkretnej strony łączenia kont w GHA.
Commissioning API na Androidzie	Uruchamianie Matter	Chociaż ten interfejs API jest zwykle używany do uruchamiania nowych Matterurządzeń, możesz go też używać do dodawania sieci Google do Matterurzą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 przepływów udostępniania zależy od tego, które urządzenia chcesz udostępniać Google.

W przypadku poniższych scenariuszy zalecamy wykonanie czynności w podanej kolejności. Dzięki temu użytkownicy będą mogli wygodniej korzystać z usługi.

produkujesz tylko urządzenia Matter;

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

1. Wywołaj interfejs Permissions API na Androidzie.

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

   1. Udostępnianie Matter musi być wykonywane na każdym urządzeniu osobno, a wiele ekranów wymaga interakcji użytkownika. Dlatego zalecamy przeprowadzenie użytkownika przez ten proces w ten sposób:
      • 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;
      • Wracam do listy urządzeń Matter, pokazując użytkownikowi postęp zadania i stan udostępniania.

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

1. Wdróż Cloud-to-cloudprecyzyjne linki. Spowoduje to dodanie urządzeń do Home Graph.

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

2. Wywołaj interfejs Permissions API na Androidzie.

Produkujesz urządzenia działające w chmurze i urządzenia Matter.

1. Wdróż Cloud-to-cloudprecyzyjne linki.

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

2. Wywołaj interfejs Permissions API na Androidzie.

3. Wywołaj Commissioning API for Android na każdym Matter urządzeniu, które zostało wcześniej skonfigurowane w innej strukturze.

   1. Udostępnianie Matter musi być wykonywane na każdym urządzeniu osobno, a wiele ekranów wymaga interakcji użytkownika. Dlatego zalecamy przeprowadzenie użytkownika przez ten proces w ten sposób:
      • 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;
      • Wracam do listy urządzeń Matter, pokazując użytkownikowi postęp zadania i stan udostępniania.

Nie masz urządzeń, którym możesz udostępniać dane Google

Wywołaj interfejs Permissions API.

Sprawdzone metody dotyczące wygody użytkowania

W tej sekcji znajdziesz najważniejsze ścieżki użytkowników, które warto wziąć pod uwagę podczas tworzenia aplikacji korzystającej z interfejsów Home API.

Gdzie w aplikacji można wprowadzić udostępnianie urządzeń

Nie jest to pełna lista. Możesz znaleźć inne możliwości przedstawienia użytkownikom Google Home i udostępnienia im tej usługi.

Nie wykluczają się one wzajemnie i mają 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 sposób działania.

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

Podczas korzystania z urządzeń w automatyzacjach uruchamianych przez Google

Na karcie Automatyzacje użytkownicy mogą kliknąć punkt wejścia do procesu udostępniania, zapoznać się z ekranem propozycji wartości, który jasno wyjaśnia korzyści z dalszego działania, a następnie szybko przejść przez proces przyznawania uprawnień.

Tylko z prowizji

Ten scenariusz jest przeznaczony głównie dla partnerów, którzy produkują tylko urządzenia Matter (bez urządzeń Cloud-to-cloud) i nie mają własnej Matter. Punkt wejścia dla użytkownika może pojawić się bezpośrednio po ekranie typu „po wyjęciu z pudełka”, na którym udostępnianie MatterurządzeńMatter (za pomocą interfejsu Commissioning API) i przyznawanie uprawnień aplikacji (za pomocą interfejsu Permissions API) są częścią tego samego procesu związanego z wrażeniami użytkownika.

Logika udostępniania

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

• Zazwyczaj należy prosić użytkowników o wykonanie tylko tych czynności, które są niezbędne do rozpoczęcia korzystania z platformy. Na przykład wieloletni klienci mogą już udostępniać urządzenia OEM Google. W takim przypadku wystarczy, że przejdą proces przyznawania uprawnień interfejsom API Home, aby przyznać aplikacji dostęp do 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 łączenie Cloud-to-cloud nie powinno być warunkiem wstępnym wyświetlania prośby o uprawnienia interfejsów Home API.

Sugestie dotyczące projektowania wizualnego

• Wyraźna korzyść z wprowadzenia do Google Home (np. „Twórz zaawansowane automatyzacje oparte na Google Home” lub „Steruj urządzeniami za pomocą wybranych aplikacji”).

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

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

• W przypadku Matter, jeśli 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 w Google Home podczas wdrażania nowych urządzeń. Możesz na przykład dodać Matterurządzenie do 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 przynosi im korzyści. Umożliwiaj użytkownikom podejmowanie świadomych decyzji na podstawie informacji, w tym kompromisów.

Ton krytyczny

Użytkownicy nie będą nadal udostępniać urządzeń, jeśli nie będą widzieć w tym korzyści.

• Zwróć szczególną uwagę na sposób pozycjonowania oferty.
• Niech będzie zachęcający, ale nie obiecuj za dużo.
• Jeśli użytkownik potrzebuje urządzenia, o którym wspominasz w swojej propozycji, wyraźnie to zaznacz, aby nie napotkał nieoczekiwanych przeszkód.
• Możesz mieć tylko jedną szansę na pozyskanie tych użytkowników, więc wykorzystaj ją jak najlepiej.

Sprawdzone metody

1. Zacznij od punktu widzenia użytkownika, czyli od pytania „Co z tego będę mieć?”.
2. W bloku sekcji nie pisz więcej niż 4 wierszy treści. Większa liczba słów może odwrócić uwagę użytkownika. Jednak przejrzystość i zrozumiałość mogą być ważniejsze niż zwięzłość.
3. Automatyzacja to świetna zabawa! Jeśli masz miejsce, wybierz ciekawy, ale przydatny przykład.
4. Jeśli pasuje to do Twojej ogólnej strategii, spróbuj używać zabawnego języka i tonu.
5. Używaj wyrażeń zachęcających do działania, np. „Rozpocznij”.