Procesy rejestracji użytkowników na Androidzie

W tym przewodniku znajdziesz wskazówki dotyczące tworzenia interfejsu użytkownika, który umożliwi bezproblemowe korzystanie z interfejsów API Google Home, uprawnień urządzeń i udostępniania w ramach procesu wdrażania aplikacji.

Główne tematy opisane w tym artykule to:

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

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

  • Jest to wymagane ze względów technicznych, aby Google mogło używać tych urządzeń w automatyzacjach.
  • Pomaga to zachować spójne i elastyczne działanie Google Home.
    • Upewnij się, że urządzenia są wyświetlane w sposób spójny w aplikacjach obsługujących interfejs Home API. Dzięki temu unikniesz tworzenia fragmentarycznego i niejasnego interfejsu, w którym użytkownicy muszą przełączać się między aplikacjami, aby wykonać podstawowe czynności.

Najważniejsze elementy procesu udostępniania

Komponent Program Opis
interfejs API Permissions na Androidzie, Interfejsy API usługi Dom dotyczące uprawnień na Androidzie Prośba o przyznanie uprawnień aplikacji. Zanim użyjesz któregokolwiek z interfejsów API Home, Twoja aplikacja musi mieć uprawnienia dostępu do urządzeń w domu użytkownika (nazywanych w interfejsie API strukturą). Kolejność wykonywania tego kroku zależy jednak od scenariusza dewelopera i jest opisana w sekcji Implementacja techniczna.
Łączenie z chmurą Połączenie kont z chmury do chmury Umożliwia rozpoczęcie procesu łączenia kont w celu udostępniania urządzeń połączonych z chmurą z Google Home z poziomu aplikacji. Aby zmniejszyć trudności użytkowników, zalecamy użycie funkcji precyzyjnych linków (dostępnej zarówno na Androida, jak i na iOS), która przekierowuje użytkowników bezpośrednio na konkretną stronę łączenia kont w Google Home.
Commissioning API na Androidzie Komendowanie sprawy Chociaż interfejs API jest zwykle używany do tworzenia nowych urządzeń Matter, możesz go też używać do dodawania komponentu Google do urządzeń Matter, które zostały już zainstalowane z użyciem innego komponentu. Jest to przydatne narzędzie podczas procesu wdrażania.

Implementacja techniczna

Sposób tworzenia procesów udostępniania zależy od tego, z jakich urządzeń chcesz udostępniać dane Google.

W tych scenariuszach zalecamy wykonanie czynności w podanej kolejności. Dzięki temu użytkownicy będą mogli korzystać z lepszej wersji usługi.

produkujesz tylko urządzenia Matter;

produkujesz urządzenia obsługujące standard Matter, które chcesz udostępnić w Google Home.

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

  2. Zadzwoń do interfejsu Commissioning API na Androidzie na każdym urządzeniu Matter, które zostało wcześniej zlecone innemu dostawcy.

    1. Udostępnianie Matter musi być wykonywane osobno na każdym urządzeniu, a ponieważ wiele ekranów wymaga podania przez użytkownika danych, zalecamy, aby poprowadzić go przez ten proces:
      • Udostępnianie użytkownikom listy urządzeń Matter, które nie są udostępniane Google.
      • zezwalanie użytkownikom na rozpoczęcie procesu udostępniania urządzenia (za pomocą interfejsu Commissioning API) przez kliknięcie urządzeń na tej liście;
      • Wraca do listy urządzeń Matter, pokazując użytkownikowi postępy w wykonaniu zadania i stan udostępniania.

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

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

    1. Zalecamy najpierw wykonanie Cloud-to-cloud, aby uniknąć potencjalnie mylących sytuacji, takich jak wyświetlenie użytkownikowi listy zawierającej urządzenia udostępnione Google i urządzenia, których nie udostępniono Google.

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

produkujesz urządzenia zarówno z usługą Cloud-to-cloud, jak i z Matter;

  1. Wykonaj Cloud-to-cloudprecyzyjne linkowanie.

    1. Zalecamy najpierw wykonanie Cloud-to-cloud, aby uniknąć potencjalnie mylących sytuacji, takich jak wyświetlenie użytkownikowi listy zawierającej urządzenia udostępnione Google i urządzenia, których nie udostępniono Google.

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

  3. Wywołaj interfejs Commissioning API dla Androida na każdym urządzeniu Matter, które zostało wcześniej zlecone innemu dostawcy.

    1. Udostępnianie Matter musi być wykonywane osobno na każdym urządzeniu, a ponieważ wiele ekranów wymaga podania przez użytkownika danych, zalecamy, aby poprowadzić go przez ten proces:
      • Udostępnianie użytkownikom listy urządzeń Matter, które nie są udostępniane Google.
      • zezwalanie użytkownikom na rozpoczęcie procesu udostępniania urządzenia (za pomocą interfejsu Commissioning API) przez kliknięcie urządzeń na tej liście;
      • Wraca do listy urządzeń Matter, pokazując użytkownikowi postępy w wykonaniu zadania i stan udostępniania.

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

Wywołaj interfejs API uprawnień.

Sprawdzone metody dotyczące wrażeń użytkowników

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

Gdzie wprowadzić udostępnianie urządzenia w aplikacji

Ta lista nie jest wyczerpująca. Możesz znaleźć inne sposoby na przedstawienie użytkownikom aktualnych informacji o Google Home i udostępnianie ich.

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

W menu Ustawienia

Menu ustawień jako punkt wejścia
Rysunek 1. Menu ustawień jako punkt wejścia

Użytkownicy są przyzwyczajeni do konfigurowania połączeń z ekosystemami Google Home za pomocą menu ustawień, więc ta metoda pozwala im zachować tę samą metodę.

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

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

Na karcie Automatyzacje użytkownicy mogli 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 potem szybko przejść przez proces udzielania uprawnień.

Punkt wejścia zautomatyzowanego procesu opartego na Google
Rysunek 2. Punkt wejścia z automatyzacji prowadzonej przez Google

Tylko z komisji

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

Punkt wejścia tylko z poziomu Uruchomienia
Rysunek 3. Punkt dostępu tylko z poziomu konfiguracji

Udostępnianie logiki

Oto kilka sugestii dotyczących próśb kierowanych do użytkownika:

  • Zazwyczaj należy poprosić użytkowników o wykonanie tylko brakujących kroków wymaganych do zainstalowania platformy. Na przykład długoletni klienci mogą już udostępniać urządzenia OEM Google. W takim przypadku muszą tylko przejść proces przyznawania uprawnień interfejsów API Google Home, aby umożliwić aplikacji dostęp do Google Home.

  • Strukturę Google Home może udostępniać wielu administratorów Google Home. W niektórych przypadkach do udostępniania urządzeń Google może być używane tylko jedno konto. W rezultacie dodanie Cloud-to-cloud nie powinno być warunkiem wyświetlenia prośby o uprawnienia interfejsów API Home.

Sugerowane rozwiązania wizualne

pomysły dotyczące projektu wizualnego;
Rysunek 4. Propozycje dotyczące projektu wizualnego

  • wyraźne korzyści płynące z wdrożenia Google Home (np. „Tworzenie zaawansowanych automatyzacji za pomocą Google Home” lub „Sterowanie urządzeniami za pomocą wybranych aplikacji”).

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

  • Jeśli jest na to miejsce, wyjaśnienie, co stanie się, 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 API Home, możesz udostępnić urządzenia w jego domu urządzeniom Google Home podczas uruchamiania nowych urządzeń. Możesz na przykład dodać urządzenie Matterdo swojej usługi fabric, a potem poprosić użytkownika o dodanie tego urządzenia do usługi fabric Google.

Sugerowane treści

Użytkownicy chętniej ufają temu, co rozumieją i co ma wartość. Ułatwić użytkownikom podejmowanie świadomych decyzji, w tym dotyczących kompromisów.

Krytyczny pitch

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

  • Zwróć szczególną uwagę na sposób pozycjonowania oferty.
  • Zrób to w sposób zachęcający, ale nie obiecuj za dużo.
  • Jeśli użytkownik potrzebuje urządzenia, które jest wymienione w Twoim opisie, wyraźnie to zaznacz, aby nie spotkał go niespodziewany problem.
  • 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 – podejścia „co mi to da?”.
  2. Nie pisz więcej niż 4 wiersze treści w bloku sekcji. Więcej słów może spowodować utratę uwagi użytkownika. 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, wybierz ciekawy i przydatny przykład.
  4. Jeśli pasuje to do Twojej ogólnej strategii, użyj wesołego głosu i tonu.
  5. Używaj zwrotów zachęcających do działania, np. „Zacznij”.