Interfejs Commissioning API na Androidzie obsługuje wielokrotne zarządzanie (lub wielu administratorów) w przypadku Matter, co oznacza, że interfejs Commissioning API może pełnić rolę głównego lub dodatkowego administratora Matter i możesz dodać własnego administratora:
Jako główny komisarz Matter:
- W tym trybie najpierw dodawana jest usługa Google przy użyciu interfejsu Google.
- Możesz dodać niestandardowego komisarza.
- Twój zleceniodawca zostanie powiadomiony po dodaniu usługi Google Fabric do urządzenia, a następnie ponownie otwarte zostanie okno uruchomieniowe Matter.
- Jeśli z jakiegokolwiek powodu Google nie może najpierw przeprowadzić procesu wprowadzania do eksploatacji w swojej własnej sieci, Twoja niestandardowa usługa wprowadzania do eksploatacji nie będzie działać.
Jako komisarz pomocniczy Matter:
- W tym trybie możesz wdrożyć własny interfejs użytkownika (UX) i zintegrować go z własną strukturą (lub z innymi strukturami).
- 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 udzieleniu przez użytkownika końcowego uprawnień do korzystania z interfejsów API Home aplikacja aktywnie wyświetlała użytkownikom monit o dodanie struktury Google (za pomocą interfejsu API Commissioning) po zakończeniu procesu uruchamiania.
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 zamiast tego kliknie Anuluj na tym ekranie, cały proces konfiguracji 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 i 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 uruchamiany.
Jak używać interfejsu Commissioning API jako dodatkowego komisarza Matter
Poniższe kroki przedstawiają Matterproces uruchamiania, w którym Twój proces uruchamiania odbywa się przed procesem uruchamiania Google:
Użytkownik rozpoczyna proces konfiguracji w aplikacji. Na przykład klika Dodaj urządzenie.
Proces UX dotyczący uruchamiania jest uruchamiany w celu dodania urządzenia do struktury.
Po zakończeniu tego procesu możesz określić dalsze działanie, opierając je na 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 włączania urządzenia do sieci Google dodaje je do sieci Google.