Proces uruchamiania w aplikacji za pomocą interfejsu Commissioning API można rozpocząć na 2 sposoby: bezpośrednio w aplikacji lub za pomocą selektora aplikacji w procesie szybkiego parowania. W tej sekcji omówiono doświadczenie użytkownika (UX) dla każdego z nich.
Zainicjowane przez aplikację
W tym scenariuszu użytkownik rozpoczyna proces wprowadzania urządzenia w aplikacji, zwykle klikając wezwanie do działania „Dodaj urządzenie”. Zalecamy umieszczenie przycisku Dodaj urządzenie w ten sposób:
- W miejscu, w którym użytkownicy widzą wszystkie swoje urządzenia, np. na stronie Sterowanie.
- Miejsce, w którym użytkownicy mogą zarządzać domem, np. strona Ustawienia.
- strona Główna w aplikacji;
Po zakończeniu procesu uruchamiania zalecamy przekierowanie użytkownika na stronę główną aplikacji lub do miejsca w aplikacji, w którym widać kontroler urządzenia, który właśnie skonfigurował, albo pełną listę wszystkich urządzeń, w tym tego, które właśnie skonfigurował.
Ilustracja interfejsu użytkownika na rysunku 2:
Użytkownik aplikacji klika Dodaj urządzenie.
Użytkownik skanuje kod QR lub wprowadza kod parowania.
Użytkownik jest proszony o wyrażenie zgody na dodanie urządzenia do struktury Google (odpowiada to opcji „Zgoda + Metadane” na Rysunku 1) i wybranie konta Google, z którego chce korzystać.
Jeśli użytkownik ma więcej niż 1 dom, pojawi się prośba o wybranie domu. Jeśli nie mają skonfigurowanego domu, automatycznie utworzymy dom o nazwie „Dom”.
Interfejs API służący do uruchamiania łączy się z urządzeniem.
Pojawi się prośba o wybranie pomieszczenia, w którym znajduje się urządzenie.
Użytkownik jest proszony o zmianę nazwy urządzenia.
Interfejs Commissioning API generuje Matterdane logowania, sprawdza połączenie sieciowe, a następnie przeprowadza proces uruchamiania, łącząc urządzenie z wybraną strukturą.
Jeśli uprawnienia dotyczące struktury i urządzeń użytkownika zostały już nadane, urządzenie powinno pojawić się w Domu wraz z innymi urządzeniami w tym Domu i można będzie nim sterować za pomocą aplikacji.
Jeśli uprawnienia dotyczące struktury i urządzeń użytkownika nie zostały jeszcze udzielone, urządzenie nie powinno być jeszcze widoczne ani możliwe do sterowania w aplikacji. Wymagane jest pozwolenie na dostęp do urządzenia i sterowanie nim za pomocą aplikacji.
Zainicjowane przez Szybkie parowanie
Uruchomienie można również zainicjować za pomocą funkcji Fast Pair w systemie Android. Po zeskanowaniu kodu QR Matter urządzenia użytkownik zostanie poproszony o wybranie aplikacji, aby kontynuować proces uruchamiania. Wybierając aplikację, korzystasz z interfejsu API Commissioning w aplikacji, jak pokazano na rysunku 3.
Jeśli użytkownik nie ma zainstalowanej aplikacji na urządzeniu mobilnym, przed kontynuowaniem zostanie poproszony o jej zainstalowanie. Dalsze działanie użytkownika od ekranu zgody jest takie samo jak na ilustracji 2.
Użytkownik zobaczy prośbę o zeskanowanie kodu QR.
Użytkownik skanuje Matterkod QR urządzenia.
Użytkownik jest proszony o wybranie aplikacji, aby kontynuować proces uruchamiania.
Jeśli aplikacja nie jest jeszcze zainstalowana, użytkownik zostanie poproszony o jej zainstalowanie.
Aplikację można pobrać ze sklepu Google Play.
Aplikacja jest zainstalowana.
Po pomyślnym zainstalowaniu aplikacji użytkownik zostanie poproszony o kontynuację.
Użytkownik jest proszony o wyrażenie zgody na dodanie urządzenia do struktury Google (odpowiada to opcji „Zgoda + Metadane” na Rysunku 1) i wybranie konta Google, z którego chce korzystać.
Jeśli użytkownik ma więcej niż 1 dom, pojawi się prośba o wybranie domu. Jeśli nie mają skonfigurowanego domu, automatycznie utworzymy dom o nazwie „Dom”.
Interfejs Commissioning API łączy się z urządzeniem.
Pojawi się prośba o wybranie pomieszczenia, w którym znajduje się urządzenie.
Użytkownik jest proszony o zmianę nazwy urządzenia.
Interfejs API uruchamiania generuje dane uwierzytelniające Matter, sprawdza łączność sieciową, a następnie wykonuje proces uruchamiania, łącząc urządzenie z wybraną infrastrukturą.
Jeśli uprawnienia do struktury i urządzeń użytkownika zostały już przyznane, 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 uprawnienia dotyczące struktury i urządzeń użytkownika nie zostały jeszcze udzielone, urządzenie nie powinno być jeszcze widoczne ani możliwe do sterowania w aplikacji. Wymagane jest pozwolenie na dostęp do urządzenia i sterowanie nim za pomocą aplikacji.
Selektor aplikacji
Podczas procesu uruchamiania Twoja aplikacja może być wyświetlana w selektorze aplikacji na dwa sposoby:
- Na ekranie Wybierz aplikację.
- Jeśli użytkownicy wybiorą opcję Wybierz inną aplikację, zostanie ona wyświetlona na ekranie Inne zainstalowane aplikacje.
Sugerowane aplikacje
W selektorze aplikacji wyświetlane są dwie sugerowane aplikacje.
- Pierwszy jest zawsze Google Home app (GHA).
- Drugi dotyczy preferowanej aplikacji producenta urządzenia, jeśli jest ona zdefiniowana w projekcie powiązanym z identyfikatorem VID lub PID urządzenia.Google Home Developer Console (Ta opcja nie dotyczy deweloperów aplikacji, którzy nie tworzą urządzeń Matter).
Gdy aplikacje znajdują się na ekranie Wybierz aplikację, możliwe są 2 scenariusze.
- Zainstalowana – Google Play services sprawdź, czy aplikacja obsługuje
ACTION_COMMISSION_DEVICEfiltr intencji. Jeśli filtr intencji nie jest dostępny, użytkownik zostanie przekierowany do Sklepu Play, aby zaktualizować aplikację. - Nie zainstalowano – użytkownik jest przekierowywany do Sklepu Play, aby zainstalować aplikację przed kontynuowaniem.