Procesy rejestracji użytkowników na Androidzie

Ten przewodnik zawiera wskazówki dotyczące projektowania interfejsów Google Home API, uprawnień urządzenia i udostępniania w celu zapewnienia płynnego procesu wprowadzania użytkownika w 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 zachować spójność i elastyczność 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 elementy 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 nazywanym 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 nowych użytkowników.

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 korzystać z usługi w wygodniejszy sposób.

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 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.

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

Wywołaj interfejs Permissions API.

Sprawdzone metody dotyczące wygody użytkownika

Ta sekcja zawiera 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ądzenia

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 ekosystemem 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 (Cloud-to-cloud łączenie i Matter interfejs Commissioning API) 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 dotyczy głównie 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 znajdować 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 dla użytkowników:

• 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 umożliwić 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 ukończenie łączenia Cloud-to-cloud nie powinno być warunkiem wstępnym wyświetlania prośby o uprawnienia do interfejsów API Home.

Sugestie dotyczące projektowania wizualnego

• Wyraźna korzyść z wdrożenia 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 wystarczająco dużo miejsca, 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.

Krytyczny ton

Użytkownicy nie będą kontynuować udostępniania urządzeń, jeśli nie będzie to dla nich korzystne.

• Zwróć szczególną uwagę na sposób pozycjonowania oferty.
• Niech będzie zachęcająca, 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ł nieoczekiwanej przeszkody.
• 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żyć zabawnego tonu.
5. Używaj wyrażeń zachęcających do działania, np. „Rozpocznij”.