Proces uruchamiania w aplikacji za pomocą interfejsu Commissioning API można zainicjować na 2 sposoby: bezpośrednio w aplikacji lub za pomocą selektora aplikacji w ramach procesu Fast Pair. W tej sekcji omawiamy wrażenia użytkowników związane z każdą z nich.
Zainicjowane przez aplikację
W tym scenariuszu użytkownik rozpoczyna konfigurowanie w aplikacji, zazwyczaj z wezwania do działania „Dodaj urządzenie”. Zalecamy wyświetlanie przycisku Dodaj urządzenie w taki sposób:
- Gdzie użytkownicy widzą wszystkie swoje urządzenia, np. na stronie Ustawienia
- Miejsce, w którym użytkownicy mogą zarządzać stroną główną, np. strona Ustawienia
- strona Główna aplikacji;
Po zakończeniu konfiguracji zalecamy przekierowanie użytkownika na stronę główną aplikacji lub do miejsca w aplikacji, które pokazuje właśnie skonfigurowany kontroler urządzenia lub pełną listę wszystkich urządzeń, w tym właśnie skonfigurowanego.
Wygoda użytkownika jest zilustrowana na rysunku 2:
Użytkownik aplikacji klika Dodaj urządzenie.
Użytkownik skanuje kod QR lub wpisze kod parowania.
Użytkownik musi wyrazić zgodę na dodanie urządzenia do platformy Google (odpowiada to elementowi „Zgoda + metadane” na rysunku 1) i wybrać konto Google, którego ma używać.
Jeśli użytkownik ma więcej niż 1 dom, pojawi się prośba o wybranie domu. Jeśli nie mają skonfigurowanego Domu, zostanie automatycznie utworzony Dom o nazwie „Dom”.
Interfejs Commissioning API łączy się z urządzeniem.
Użytkownik zostaje poproszony o wybranie pokoju, w którym znajduje się urządzenie.
Użytkownik zostanie poproszony o zmianę nazwy urządzenia.
Interfejs Commissioning API generuje dane logowania Matter, sprawdza połączenie z siecią, a następnie przeprowadza proces uruchamiania, łącząc urządzenie z wybraną siecią.
Jeśli użytkownik udzielił już uprawnień do swojej struktury i urządzeń, urządzenie powinno pojawić się w domu wraz z innymi urządzeniami w tym domu i można nim sterować za pomocą aplikacji.
Jeśli nie przyznano jeszcze uprawnień do struktury ani urządzeń użytkownika, urządzenie nie powinno być widoczne ani dostępne w aplikacji. Wymagane jest uprawnienie do uzyskiwania dostępu do urządzenia i sterowania nim w aplikacji.
Zainicjowane przez Szybkie parowanie
Zamówienie można też rozpocząć za pomocą Szybkiego parowania na Androidzie. Po zeskanowaniu kodu QR Matter urządzenia użytkownik zostanie poproszony o wybranie aplikacji, aby kontynuować proces uruchamiania. Wybranie aplikacji powoduje użycie przez nią interfejsu Commissioning API, jak pokazano na rysunku 3.
Jeśli użytkownik nie ma aplikacji zainstalowanej na urządzeniu mobilnym, przed kontynuacją zostanie poproszony o jej zainstalowanie. Od ekranu zgody wrażenia użytkownika są takie same jak na rysunku 2.
Użytkownik zostanie poproszony o zeskanowanie kodu QR.
Użytkownik skanuje kod QR Matter urządzenia.
Użytkownik musi wybrać aplikację, aby kontynuować proces zlecania.
Jeśli aplikacja nie jest jeszcze zainstalowana, użytkownik zobaczy prośbę o jej zainstalowanie.
Aplikacja jest pobierana ze Sklepu Google Play.
Aplikacja jest zainstalowana.
Po zainstalowaniu aplikacji użytkownik otrzyma prośbę o dalsze działanie.
Użytkownik musi wyrazić zgodę na dodanie urządzenia do platformy Google (odpowiada to elementowi „Zgoda + metadane” na rysunku 1) i wybrać konto Google, którego ma używać.
Jeśli użytkownik ma więcej niż 1 dom, pojawi się prośba o wybranie domu. Jeśli nie mają skonfigurowanego Domu, zostanie automatycznie utworzony Dom o nazwie „Dom”.
Interfejs Commissioning API łączy się z urządzeniem.
Użytkownik zostaje poproszony o wybranie pokoju, w którym znajduje się urządzenie.
Użytkownik zostanie poproszony o zmianę nazwy urządzenia.
Interfejs Commissioning API generuje Matterdane logowania, sprawdza łączność z siecią, a następnie wykonuje proces inicjalizacji, łącząc urządzenie z wybraną platformą.
Jeśli użytkownik udzielił już uprawnień do swojej struktury i urządzeń, urządzenie powinno pojawić się w domu wraz z innymi urządzeniami w tym domu i można nim sterować za pomocą aplikacji.
Jeśli nie masz jeszcze uprawnień do struktury ani urządzeń użytkownika, urządzenie nie powinno być widoczne ani możliwe do sterowania w aplikacji. Wymagane jest uprawnienie do korzystania z aplikacji i sterowania urządzeniem.
Selektor aplikacji
Aplikacja może wyświetlać się w selektorze aplikacji na 2 sposoby:
- Na ekranie Wybierz aplikację.
- Jeśli użytkownicy klikną Wybierz inną aplikację, pojawi się ona na ekranie Inne zainstalowane aplikacje.
Sugerowane aplikacje
Selektor aplikacji wyświetla 2 polecane aplikacje.
- Pierwszy jest zawsze Google Home app (GHA).
- Drugi to preferowana aplikacja producenta urządzenia, jeśli jest zdefiniowana w projekcie Google Home Developer Console powiązanym z identyfikatorem VID lub PID urządzenia. (ta opcja nie dotyczy deweloperów aplikacji, którzy nie tworzą aplikacji na urządzenia Matter).
Aplikacje na ekranie Wybierz aplikację mogą się tam znaleźć w 2 sytuacjach.
- Zainstalowana – Google Play services sprawdź, czy aplikacja obsługuje filtr intencji
ACTION_COMMISSION_DEVICE. Jeśli brakuje filtra intencji, użytkownik zostanie przekierowany do Sklepu Play, aby zaktualizować aplikację. - Nie zainstalowana – użytkownik jest przekierowywany do Sklepu Play, aby zainstalować aplikację, zanim będzie można kontynuować.