Procesy rejestracji użytkowników na Androidzie

Ten przewodnik zawiera wskazówki dotyczące projektowania interfejsu użytkownika w zakresie uprawnień do urządzeń i udostępniania w interfejsach Google Home API na potrzeby procesu wdrażania w aplikacji.

Główne tematy opisane w tym dokumencie:

• 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 w Google Home?

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

• Jest to wymóg techniczny, aby Google mogło używać tych urządzeń w automatyzacjach.
• Pomaga to utrzymać spójne i elastyczne działanie Google Home.
  • Aby uniknąć fragmentacji i dezorientacji użytkowników, którzy muszą przełączać się między aplikacjami, aby wykonywać podstawowe zadania, ważne jest, aby urządzenia były prezentowane w spójny sposób we wszystkich aplikacjach obsługujących interfejsy Home API.

Kluczowe komponenty procesu udostępniania

Komponent	Program	Opis
Permissions API na Androidzie	Home APIs for Permissions na Androidzie	Prosi użytkowników o przyznanie uprawnień Twojej 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ść wykonywania tego kroku zależy jednak od scenariusza dewelopera i jest uwzględniona w implementacji technicznej.
Łączenie z chmury do chmury	Łączenie z chmury do chmury na potrzeby łączenia kont	Umożliwia rozpoczęcie procesu łączenia konta w celu udostępniania urządzeń połączonych z chmurą w Google Home z poziomu aplikacji. Aby zmniejszyć niedogodności dla użytkowników, zalecamy korzystanie z funkcji precyzyjnych linków (dostępnej zarówno na Androidzie, jak i iOS), która kieruje użytkowników bezpośrednio na Twoją stronę łączenia kont w GHA.
Commissioning API na Androidzie	Commissioning Matter	Chociaż ten interfejs API jest zwykle uważany za interfejs do uruchamiania nowych Matter urządzeń, możesz go też używać do dodawania sieci Google do Matter urządzeń które zostały już uruchomione w innej sieci. Dlatego jest to przydatne narzędzie w procesie wdrażania.

Implementacja techniczna

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

W tych scenariuszach zalecamy wykonanie czynności w podanej kolejności. Pomaga to zapewnić użytkownikom lepsze ogólne wrażenia.

Produkujesz tylko urządzenia Matter

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

1. Wywołaj Permissions API na Androidzie.

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

   1. Udostępnianie Matter musi być wykonywane osobno dla każdego urządzenia, a użytkownik musi wprowadzić dane na wielu ekranach. Dlatego zalecamy, aby przeprowadzić użytkownika przez ten proces:
      • Podaj użytkownikom listę urządzeń Matter, które nie są udostępniane w Google.
      • Umożliw użytkownikom rozpoczęcie procesu udostępniania urządzenia (za pomocą Commissioning API) przez kliknięcie urządzeń na tej liście.
      • Wróć do listy urządzeń Matter, pokazując użytkownikowi postęp zadania i stan udostępniania.

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

1. Wykonaj Cloud-to-cloud precyzyjne linkowanie. Spowoduje to dodanie urządzeń do grafu Google Home.

   1. Aby uniknąć potencjalnie mylących sytuacji, takich jak wyświetlanie użytkownikowi listy zawierającej urządzenia udostępniane w Google i urządzenia nieudostępniane w Google, zalecamy najpierw wykonanie Cloud-to-cloud łączenia.

2. Wywołaj Permissions API na Androidzie.

Produkujesz urządzenia zarówno z chmury do chmury, jak i Matter

1. Wykonaj Cloud-to-cloud precyzyjne linkowanie.

   1. Aby uniknąć potencjalnie mylących sytuacji, takich jak wyświetlanie użytkownikowi listy zawierającej urządzenia udostępniane w Google i urządzenia nieudostępniane w Google, zalecamy najpierw wykonanie Cloud-to-cloud łączenia.

2. Wywołaj Permissions API na Androidzie.

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

   1. Udostępnianie Matter musi być wykonywane osobno dla każdego urządzenia, a użytkownik musi wprowadzić dane na wielu ekranach. Dlatego zalecamy, aby przeprowadzić użytkownika przez ten proces:
      • Podaj użytkownikom listę urządzeń Matter, które nie są udostępniane w Google.
      • Umożliw użytkownikom rozpoczęcie procesu udostępniania urządzenia (za pomocą Commissioning API) przez kliknięcie urządzeń na tej liście.
      • Wróć do listy urządzeń Matter, pokazując użytkownikowi postęp zadania i stan udostępniania.

Nie masz urządzeń do udostępniania w Google

Wywołaj Permissions API.

Sprawdzone metody na zapewnienie wygody użytkowania

Ta sekcja zawiera kilka ważnych ścieżek użytkownika, które należy wziąć pod uwagę podczas tworzenia aplikacji korzystającej z interfejsów Home API.

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

Ta lista nie jest wyczerpująca. Możesz znaleźć inne możliwości, aby w odpowiednim momencie przedstawić użytkownikom Google Home i udostępnianie.

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

Możesz oddzielić udostępnianie urządzeń (Cloud-to-cloud łączenie i Matter Commissioning API) od uprawnień aplikacji (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, przeczytać ekran z propozycją wartości, który jasno wyjaśnia korzyści z dalszego działania, a następnie szybko przejść przez proces przyznawania uprawnień.

Tylko z uruchamiania

Ten scenariusz dotyczy głównie partnerów, którzy produkują tylko urządzenia Matter (bez Cloud-to-cloud urządzeń) i nie mają własnej Matter sieci. 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 Matter urządzeń (za pomocą Commissioning API) i uprawnienia aplikacji (za pomocą Permissions API) są częścią tego samego procesu.

Logika udostępniania

Oto kilka sugestii dotyczących komunikatów dla użytkowników:

• Zasadniczo należy prosić użytkowników o wykonanie tylko tych brakujących kroków, które są wymagane do wdrożenia platformy. Na przykład długoletni klienci mogą już udostępniać urządzenia OEM w Google. W takim przypadku muszą tylko przejść przez proces przyznawania uprawnień interfejsom Home API, 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ń w Google może być używane tylko jedno konto. W związku z tym wykonanie Cloud-to-cloud łączenia nie powinno być warunkiem wstępnym do wyświetlania prośby o uprawnienia do interfejsów Home API.

Sugestie dotyczące projektu wizualnego

• Jasna korzyść z wdrożenia w 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śnienie, co się stanie, gdy użytkownik będzie przechodzić przez kolejne ekrany.

• W przypadku Matter jeśli użytkownik przyznał Ci wcześniej 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 uruchamiania nowych urządzeń. Możesz na przykład dodać Matter urządzenie do swojej sieci, a następnie poprosić użytkownika o dodanie tego urządzenia do sieci Google.

Sugerowane treści

Użytkownicy łatwiej ufają czemuś, co rozumieją i co przynosi im korzyści. Umożliw użytkownikom podejmowanie świadomych decyzji, w tym decyzji dotyczących kompromisów, poprzez dostarczanie im informacji.

Krytyczna propozycja

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

• Zwróć szczególną uwagę na to, jak pozycjonujesz ofertę.
• Zadbaj o to, aby była atrakcyjna, 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ą.

Sprawdzone metody

1. Zacznij od punktu widzenia użytkownika – podejścia „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. Automatyzacje to świetna zabawa. Jeśli jest miejsce, wybierz ciekawy, ale przydatny przykład.
4. Jeśli jest to zgodne z Twoją ogólną strategią, spróbuj użyć zabawnego języka i tonu.
5. Używaj fraz zachęcających do działania, takich jak „Rozpocznij”.