Interfejs Commissioning API na Androidzie obsługuje wielokrotne administrowanie (lub wieloadministrowanie) w przypadku Matter, co oznacza, że interfejs Commissioning API może pełnić funkcję głównego lub dodatkowego komisarza Matter i możesz dodać własnego komisarza:
Jako główny komisarz Matter:
- W tym trybie najpierw dodawana jest usługa Google przy użyciu interfejsu Google.
- Możesz dodać niestandardowego komisarza.
- Po dodaniu do urządzenia tkaniny Google dzwoni do osoby, która je obsługuje, a następnie ponownie otwiera się okno Matter konfiguracji.
- Jeśli z jakiegokolwiek powodu Google nie może najpierw przeprowadzić konfiguracji w swojej własnej sieci, Twoja niestandardowa usługa konfiguracji nie będzie działać.
Jako komisarz dodatkowy Matter:
- W tym trybie możesz wdrożyć własny interfejs użytkownika do obsługi prowizji i wdrożyć własną strukturę (lub inne struktury).
- Interfejs Google Commissioning API można wywołać później, gdy otwarte jest okno uruchamiania, aby dodać sieć Google. W tym trybie Google zdecydowanie zaleca, aby po przyznaniu przez użytkownika uprawnień do korzystania z interfejsów Home API aplikacja aktywnie zachęcała użytkowników do dodania sieci Google (za pomocą interfejsu Commissioning API) po zakończeniu procesu wprowadzania urządzenia.
Jak używać interfejsu Commissioning API jako głównego komisarza Matter
Poniższe kroki pokazują preferowany przez Google Matterw pełni funkcjonalny proces uruchamiania:
Użytkownik rozpoczyna proces konfiguracji w aplikacji. Na przykład klika przycisk o etykiecie Dodaj urządzenie.
Interfejs Google przejmuje kontrolę i wyświetla ekran Zeskanuj Matter kod QR, umożliwiając użytkownikowi zeskanowanie kodu QR w celu rozpoczęcia procesu konfiguracji.
Na ekranie Połącz to urządzenie ze swoim kontem Google użytkownik klika Zgadzam się, aby dodać urządzenie do ekosystemu Google. Jeśli użytkownik kliknie na tym ekranie Anuluj, cały proces wdrażania urządzenia zostanie natychmiast zakończony.
Na ekranie Wybierz dom użytkownik wybiera dom, z którego może sterować urządzeniem. Jeśli nie ma dostępnego domu, zostanie utworzony nowy. Jeśli w domu nie zostaną znalezione odpowiednie huby lub użytkownik nie będzie mieć uprawnień, proces konfiguracji zakończy się.
Następnie powinien pojawić się ekran Urządzenie połączone, a potem rozpocznie się proces MatterkonfiguracjiMatter. Na tym ekranie użytkownik może wybrać nazwę pomieszczenia i urządzenia.
Podczas rejestracji urządzenia w sieci Matter pojawi się ekran Przygotowuję urządzenie.
Aplikacja przejmuje kontrolę, a zarejestrowany komisarz niestandardowy jest teraz uruchamiany.
Jak korzystać z interfejsu Commissioning API jako dodatkowy komisarz Matter
Te kroki pokazują proces Matterwdrażania, w którym Twój proces wdrażania odbywa się przed procesem wdrażania Google:
Użytkownik rozpoczyna proces konfiguracji w aplikacji. Na przykład klika Dodaj urządzenie.
Proces UX dotyczący uruchamiania jest przeprowadzany w celu dodania urządzenia do Twojej sieci.
Po zakończeniu tego procesu możesz określić dalsze działania na podstawie swojej wiedzy o użytkowniku. Jeśli na przykład użytkownik wyraził zgodę na korzystanie z interfejsów Google Home API, co prawdopodobnie oznacza, że chce przekazać urządzenie do Google, możesz uruchomić proces przekazywania.
Proces wywołuje interfejs Commissioning API i przekazuje ładunek, który zawiera kod dostępu, dyskryminator i inne dostępne informacje.
Proces konfiguracji Google dodaje urządzenie do struktury Google.