W tym przewodniku znajdziesz wskazówki dotyczące tworzenia interfejsu użytkownika, który umożliwi płynne korzystanie z interfejsów API Google Home, uprawnień urządzeń i udostępniania w ramach procesu wdrażania aplikacji.
Główne tematy omówione w tym artykule to:
- Dlaczego warto udostępniać urządzenia w Google Home?
- Kluczowe etapy procesu udostępniania
- Implementacja techniczna
- Sprawdzone metody dotyczące UX
Dlaczego warto udostępniać urządzenia Google Home?
Aby korzystać z możliwości 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.
Kluczowe elementy procesu udostępniania
| Komponent | Program | Opis |
|---|---|---|
| Permissions API | Interfejsy API dotyczące uprawnień | Prośba o przyznanie uprawnień aplikacji. Zanim użyjesz 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ć utrudnienia dla użytkowników, zalecamy korzystanie z funkcji precyzyjnych linków (dostępnych zarówno na Androida, jak i iOS), która przekierowuje użytkowników bezpośrednio na konkretną stronę łączenia kont w Google Home. |
| Commissioning API | Uruchamianie Matter | Chociaż interfejs API jest zwykle używany do uruchamiania nowych urządzeń Matter, możesz go też użyć do dodania komponentu Google do urządzeń Matter, które zostały już uruchomione z użyciem innego komponentu. Jest to przydatne narzędzie podczas procesu wprowadzania. |
Implementacja techniczna
Sposób tworzenia procesów udostępniania zależy od tego, z jakimi urządzeniami chcesz udostępniać dane Google.
W tych sytuacjach zalecamy wykonanie czynności w podanej kolejności. Dzięki temu użytkownicy będą mogli korzystać z lepszych funkcji.
produkujesz tylko urządzenia Matter;
produkujesz urządzenia obsługujące standard Matter, które chcesz udostępnić w Google Home.
Wywołaj interfejs API uprawnień.
Wywołaj interfejs Google Commissioning API na każdym urządzeniu Matter, które zostało wcześniej zlecone innemu procesowi.
- 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;
- Wracanie do listy urządzeń Matter, wyświetlanie postępu zadania i stanu udostępniania użytkownikowi.
- 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:
produkujesz tylko urządzenia udostępniane Google za pomocą interfejsów Cloud-to-Cloud API;
Wykonaj Cloud-to-cloudprecyzyjne linki. Spowoduje to dodanie urządzeń do Google Home Graph.
- 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óre nie są udostępnione Google.
Wywołaj interfejs API uprawnień.
produkujesz urządzenia z usługą „z chmury do chmury” i z Matter;
Wykonaj Cloud-to-cloudprecyzyjne linki.
- 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óre nie są udostępnione Google.
Wywołaj interfejs API uprawnień.
Wywołaj interfejs Google Commissioning API na każdym urządzeniu Matter, które zostało wcześniej zlecone innemu procesorowi.
- 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 przeprowadzić 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;
- Wracanie do listy urządzeń Matter, wyświetlanie postępu zadania i stanu udostępniania użytkownikowi.
- 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 przeprowadzić go przez ten proces:
Nie masz urządzeń do udostępniania Google
Wywołaj interfejs API uprawnień.
Sprawdzone metody dotyczące wygody użytkownika
Ta sekcja zawiera najważniejsze ścieżki użytkownika, które należy 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 opcje nie wykluczają się wzajemnie, a dostęp do nich jest możliwy na kilka sposobów:
Z menu Ustawienia
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świetlać im 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ń.
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 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.
Udostępnianie reguł
Oto kilka sugestii dotyczących promptów dla użytkowników:
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, a w niektórych przypadkach do udostępniania urządzeń Google może być używane tylko jedno konto. W rezultacie Cloud-to-cloud nie musi być warunkiem wyświetlenia prośby o uprawnienia interfejsów API Home.
Sugerowane rozwiązania wizualne
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 pozwala na to miejsce, wyjaśnienie tego, 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 Google fabric.
Sugerowane treści
Użytkownicy chętniej ufają temu, co jest zrozumiałe i przydatne. Ułatwiać użytkownikom podejmowanie świadomych decyzji, w tym dotyczących kompromisów, poprzez dostarczanie im informacji.
Krytyczny pitch
Użytkownicy nie będą udostępniać urządzeń, jeśli nie będą w stanie uzyskać z tego korzyści.
- Zwróć szczególną uwagę na sposób pozycjonowania oferty.
- Zrób to w sposób zachęcający, ale nie obiecuj zbyt wiele.
- Jeśli użytkownik potrzebuje urządzenia, które jest wymienione w Twoim opisie, wyraźnie to zaznacz, aby nie spotkał go nieoczekiwana przeszkoda.
- Możesz mieć tylko jedną szansę na pozyskanie tych użytkowników, więc wykorzystaj ją jak najlepiej.
Sprawdzone metody
- Zacznij od punktu widzenia użytkownika – zastanów się, „co mi to da?”.
- 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.
- Automatyzacje to świetna zabawa. Jeśli pozwala na to miejsce, wybierz ciekawy i przydatny przykład.
- Jeśli pasuje to do Twojej ogólnej strategii, użyj wesołego głosu i tonu.
- Używaj zwrotów zachęcających do działania, np. „Zacznij”.