Wieloadministratorzy w przypadku interfejsu Commissioning API na Androidzie

Interfejs Commissioning API na Androidzie obsługuje wieloadministrowanie (lub wieloadministratora) w przypadku Matter, co oznacza, że interfejs Commissioning API może pełnić rolę głównego lub dodatkowego komisarza Matter i możesz dodać własnego komisarza:

  • Jako główny komisarz Matter:

    • W tym trybie najpierw dodawana jest sieć Google z interfejsem Google.
    • Możesz dodać niestandardowego komisarza.
      • Po dodaniu do urządzenia tkaniny Google dzwoni do osoby, która ma uprawnienia do konfigurowania urządzenia. Następnie ponownie otwiera się Matterokno konfiguracji.
      • Jeśli z jakiegokolwiek powodu Google nie może najpierw przeprowadzić procesu wdrożenia w swojej własnej sieci, Twoja niestandardowa usługa wdrożenia 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 struktury 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:

  1. Użytkownik inicjuje proces konfiguracji w aplikacji. Na przykład klika przycisk o nazwie Dodaj urządzenie.

  2. 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.

  3. 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 na tym ekranie Anuluj, cały proces wdrażania urządzenia zostanie natychmiast zakończony.

  4. 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ę.

  5. 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.

  6. Podczas rejestracji urządzenia w sieci Matter pojawi się ekran Przygotowuję urządzenie.

  7. Aplikacja przejmuje kontrolę, a zarejestrowany komisarz niestandardowy jest teraz uruchamiany.

Jak korzystać z interfejsu Commissioning API jako dodatkowy komisarz Matter

Poniższe kroki pokazują Matterproces wdrażania, w którym Twój proces wdrażania odbywa się przed procesem wdrażania Google:

  1. Użytkownik rozpoczyna proces konfiguracji w aplikacji. Na przykład klika Dodaj urządzenie.

  2. Proces UX dotyczący uruchamiania jest uruchamiany w celu dodania urządzenia do struktury.

  3. 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.

  4. Proces wywołuje interfejs Commissioning API i przekazuje ładunek, który zawiera kod dostępu, dyskryminator i inne dostępne informacje.

  5. Proces wprowadzania do eksploatacji w Google dodaje urządzenie do struktury Google.