Autoryzacja konta na Androidzie

Zanim przejdziesz do autoryzacji konta, upewnij się, że masz:

1. aplikację Google Home app (GHA) zainstalowaną na urządzeniu mobilnym z Androidem;
2. co najmniej 1 z tych obsługiwanych typów urządzeń dla przykładowej aplikacji w domu:
   • światło o regulowanej temperaturze barwowej (włączanie i wyłączanie, jasność);
   • czujnik kontaktu (stan logiczny);
   • światło z możliwością ściemniania (włączanie i wyłączanie, jasność);
   • zamek do drzwi;
   • światło o rozszerzonej palecie barw (włączanie i wyłączanie, jasność);
   • przełącznik ogólny;
   • router graniczny Google;
   • aparat Google;
   • dzwonek Google;
   • czujnik obecności (wykrywanie obecności);
   • światło włączane i wyłączane (włączanie i wyłączanie, jasność);
   • włącznik światła;
   • włączane i wyłączane urządzenie wtykowe (włączanie i wyłączanie);
   • czujnik włączany i wyłączany;
3. 2 urządzenia do testowania przykładowej automatyzacji.

Zanim zaczniesz korzystać z urządzeń za pomocą interfejsów Home API, musisz mieć możliwość sterowania nimi z GHA.

Uruchamianie przykładowej aplikacji na Androida

Zanim autoryzujesz konto, sprawdź, czy przykładowa aplikacja jest skonfigurowana z odpowiednim zakresem OAuth dla Twojego projektu. Domyślnie kod źródłowy przykładowej aplikacji używa zakresu https://www.googleapis.com/auth/home.platform.v2. Wiele funkcji w przykładowej aplikacji jest ograniczonych zakresem home.platform.v2 i wymaga zatwierdzenia przez partnera. Aby autoryzować i używać przykładowej aplikacji ze standardowym https://www.googleapis.com/auth/home.platform.selected.devices zakresem, ręcznie zmień homePlatformScope na HOME_PLATFORM_SCOPE_VERSION_1 w HomeModule.kt zgodnie z opisem w sekcji Tworzenie aplikacji.

Uruchom przykładową aplikację na Androida. Przy pierwszym uruchomieniu pojawi się prośba o zezwolenie na dostęp do domu na Twoim koncie Google. Dzięki temu przykładowa aplikacja będzie mieć uprawnienia aplikacji do uzyskiwania dostępu do domów i urządzeń oraz sterowania nimi.

Jeśli nie masz domu, użytkownik może go utworzyć podczas procesu przyznawania uprawnień bez konieczności korzystania z GHA.

Domyślne zachowanie uprawnień aplikacji będzie się różnić w zależności od tego, czy aplikacja została zarejestrowana w Google Home Developer Console.

Jeśli aplikacja nie jest zarejestrowana w Developer Console, będzie w stanie niezweryfikowanym. Zalecamy to w przypadku testowania korzystania z interfejsów Home API:

• Tylko użytkownicy zarejestrowani jako testerzy w Konsoli OAuth mogą przyznawać uprawnienia do aplikacji. W przypadku niezweryfikowanej aplikacji obowiązuje limit 100 testerów.

• Niezweryfikowana aplikacja będzie mieć dostęp do urządzeń dowolnego typu obsługiwanego przez OAuth w przypadku interfejsów Home API (lista typów urządzeń w Konsoli dewelopera Developer Console). Uprawnienia zostaną przyznane do wszystkich urządzeń w domu.

Jeśli aplikacja jest zarejestrowana w Developer Console i została zatwierdzona pod kątem dostępu do co najmniej 1 typu urządzenia oraz jeśli w przypadku OAuthprzeprowadzono weryfikację marki , będzie w stanie zweryfikowanym. Ten stan jest wymagany do opublikowania aplikacji w wersji produkcyjnej:

• Limity testerów nie obowiązują. Każdy użytkownik może przyznać uprawnienia do aplikacji.
• Użytkownik może przyznać uprawnienia tylko do typów urządzeń, które zostały zatwierdzone w Developer Console.

Kliknij Zezwól na dostęp do wybranego domu:

• Jeśli z Twoim kontem są połączone jakieś domy, wybierz dom, do którego chcesz przyznać uprawnienia. Jeśli w wybranym domu nie znaleziono żadnych urządzeń, możesz:
  1. Kliknąć Zezwól na dostęp do innego domu , aby wybrać inny dom.
  2. Skonfigurować wybrane urządzenie w tym domu za pomocą Google Home app (GHA). Pamiętaj, że ta przykładowa aplikacja obsługuje sterowanie tylko tymi typami urządzeń:
     • światło o regulowanej temperaturze barwowej (włączanie i wyłączanie, jasność);
     • czujnik kontaktu (stan logiczny);
     • światło z możliwością ściemniania (włączanie i wyłączanie, jasność);
     • zamek do drzwi;
     • światło o rozszerzonej palecie barw (włączanie i wyłączanie, jasność);
     • przełącznik ogólny;
     • router graniczny Google;
     • aparat Google;
     • dzwonek Google;
     • czujnik obecności (wykrywanie obecności);
     • światło włączane i wyłączane (włączanie i wyłączanie, jasność);
     • włącznik światła;
     • włączane i wyłączane urządzenie wtykowe (włączanie i wyłączanie);
     • czujnik włączany i wyłączany;
• Jeśli z Twoim kontem nie są połączone żadne domy, zobaczysz ekran z komunikatem Wybrane konto nie ma żadnych domów.
  1. Przesuń palcem w lewo, aby wrócić do głównego widoku przykładowej aplikacji.
  2. Aby skonfigurować dom, użyj aplikacji Google Home GHA. Następnie spróbuj ponownie przyznać uprawnienia do przykładowej aplikacji.

Do procesu przyznawania uprawnień możesz w każdej chwili wrócić, klikając ikonę profilu account_circle w prawym górnym rogu dowolnego ekranu przykładowej aplikacji.

Gdy przyznasz uprawnienia do domu, w którym znajdują się urządzenia, przejdziesz do widoku urządzeń. Za pomocą przykładowej aplikacji możesz sterować urządzeniami i obserwować zmiany ich stanu.