Interfejs Commissioning API na Androidzie obsługuje administrację wieloma użytkownikami (lub administrację wieloma) w przypadku Matter, co oznacza, że interfejs Commissioning API może pełnić rolę głównego lub dodatkowego komisarza Matter oraz że możesz dodać własnego komisarza:
Jako główny Matter komisarz:
- W tym trybie najpierw dodawana jest struktura Google za pomocą interfejsu Google.
- Możesz dodać niestandardowego komisarza.
- Twój komisarz jest wywoływany po dodaniu struktury Google do urządzenia, a następnie ponownie otwierane jest okno konfiguracji.Matter
- Jeśli z jakiegoś powodu Google nie może najpierw przeprowadzić konfiguracji we własnej strukturze, Twoja niestandardowa usługa konfiguracji nie zostanie uruchomiona.
Jako dodatkowy Matter komisarz:
- W tym trybie możesz zaimplementować własny interfejs konfiguracji i dołączyć do własnej struktury (lub innych struktur).
- Interfejs Google Commissioning API można wywołać później z otwartym oknem konfiguracji, aby dodać strukturę 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 struktury Google (za pomocą interfejsu Commissioning API) po zakończeniu procesu konfiguracji.
Jak używać interfejsu Commissioning API jako głównego komisarza Matter
Te czynności pokazują preferowany przez Google Matter proces konfiguracji Matter z pełnym zakresem funkcji:
Użytkownik rozpoczyna proces konfiguracji w aplikacji. Na przykład klika przycisk 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ła konfiguracja urządzenia zostanie natychmiast zakończona.
Na ekranie Wybierz dom użytkownik wybiera dom, z którego może sterować urządzeniem. Jeśli nie ma dostępnego domu, tworzony jest nowy dom. Jeśli w domu nie zostaną znalezione odpowiednie huby lub użytkownik nie ma uprawnień, proces konfiguracji zostanie zakończony.
Następnie powinien pojawić się ekran Urządzenie połączone, a proces konfiguracji Matter się rozpocznie. Na tym ekranie użytkownik może wybrać pokój i nazwę urządzenia.
Gdy urządzenie jest dołączane do struktury Matter, wyświetla się ekran Przygotowuję urządzenie.
Twoja aplikacja przejmuje kontrolę, a niestandardowy komisarz, jeśli jest zarejestrowany, jest teraz uruchamiany.
Jak używać interfejsu Commissioning API jako dodatkowego komisarza Matter
Te czynności pokazują proces Matter konfiguracji, w którym proces konfiguracji odbywa się przed procesem konfiguracji Google:
Użytkownik rozpoczyna proces konfiguracji w Twojej aplikacji. Na przykład klika Dodaj urządzenie.
Uruchamiany jest proces konfiguracji, aby dodać urządzenie do Twojej struktury.
Po zakończeniu możesz określić dalsze działanie, opierając się 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 skonfigurować Google, możesz uruchomić proces konfiguracji.
Twój proces wywołuje interfejs Commissioning API i przekazuje ładunek, który zawiera hasło, dyskryminator i inne dostępne informacje.
Proces konfiguracji Google dodaje urządzenie do struktury Google.