Przykładowa aplikacja na Androida pokazuje podstawowe możliwości dostępu do urządzeń i sterowania nimi za pomocą interfejsów Home API w przypadku obsługiwanych typów urządzeń.
Po zakończeniu autoryzacji konta i wybraniu struktury przykładowa aplikacja wczytuje wszystkie urządzenia lokalne znalezione w tej strukturze.
Jeśli urządzenie znajduje się w pomieszczeniu, będzie widoczne pod nazwą tego pomieszczenia. Przykładowa aplikacja obsługuje te typy urządzeń:
- Światło o regulowanej temperaturze kolorów (włączanie i wyłączanie, jasność)
- Czujnik kontaktowy (stan logiczny)
- Światło z możliwością przyciemniania (włączanie i wyłączanie, jasność)
- Zamek drzwi
- Extended Color Light (włączanie i wyłączanie, jasność)
- Przełącznik ogólny
- Router graniczny Google
- Aparat Google
- Google Doorbell
- Czujnik obecności (wykrywanie obecności)
- Światło (włączanie i wyłączanie, jasność)
- Włącznik/wyłącznik światła
- Wtyczka z przełącznikiem (włączanie i wyłączanie)
- Czujnik włączania/wyłączania
Działania na dotychczasowych urządzeniach i automatyzacje
Przykładowa aplikacja składa się z 2 kart: Urządzenia i Automatyzacje. Każda karta zawiera informacje o strukturze i umożliwia wykonywanie zadań.
Karta urządzeń
Na karcie Urządzenia (rys. 1) widać pomieszczenia w domu (Ogród, Poddasze, Podróż) i urządzenia w każdym z nich wraz ze stanem każdego urządzenia. Aby wyświetlić lub edytować cechy urządzenia, kliknij jego nazwę. Zobaczysz ekran sterowania tym urządzeniem (rysunek 2).
Aby dodać urządzenie do domu, na karcie Urządzenia kliknij Dodaj urządzenie (rysunek 1), a następnie postępuj zgodnie z instrukcjami, aby dodać urządzenie z użyciem kodu QR lub bez niego.
Karta Automatyzacja
Na karcie Automatyzacje (rysunek 3) znajduje się lista wszystkich automatyzacji w domu. Każda automatyzacja pokazuje swoje elementy uruchamiające i działania. Możesz dodać wiele elementów inicjujących i działań.
Kliknij automatyzację, aby wyświetlić jej szczegóły, jak pokazano na przykładzie na rysunku 4. W tym widoku szczegółowym możesz usunąć automatyzację lub wykonać ją ręcznie bez konieczności używania elementu inicjującego, pod warunkiem że przycisk Wykonaj ręcznie jest obsługiwany w przypadku tej automatyzacji.
W widoku szczegółowym automatyzacji (rysunek 4) możesz też przełączać pole isActive, aby włączać i wyłączać automatyzację.
Pole isValid jest ustawiane przez pakiet SDK i ma wartość false, jeśli występuje problem z obsługą urządzenia lub cechy albo inny problem.
Utwórz automatyzację
Aby utworzyć nową automatyzację, kliknij przycisk Utwórz w widoku listy automatyzacji (rysunek 3). Pojawi się ekran Nowa automatyzacja (rysunek 5).
Użyj przycisków + Dodaj polecenie inicjujące i + Dodaj działanie (rysunek 5), aby dodać do automatyzacji co najmniej 1 polecenie inicjujące i działanie. Na ilustracjach 6 i 7 pokazano przykłady wyboru polecenia inicjującego i działania. Po dokonaniu wyboru i zapisaniu polecenia inicjującego lub działania zobaczysz przyciski Zaktualizuj polecenie inicjujące i Usuń polecenie inicjujące (oraz Zaktualizuj działanie i Usuń działanie). Dzięki temu możesz edytować polecenie inicjujące lub działanie albo je usunąć, zanim zapiszesz automatyzację.
Po dodaniu elementów inicjujących i działań możesz wrócić do ekranu Nowa automatyzacja i kliknąć Utwórz automatyzację (rysunek 8).
Rozwiązywanie problemów
Aplikacja wyświetla okna z komunikatami o niektórych typowych zdarzeniach, które mogą wystąpić.
Informacje o tym, jak rozwiązać te zdarzenia, znajdziesz w logach adb.
Jeśli napotkasz problemy podczas korzystania z przykładowej aplikacji, zapoznaj się z artykułem Rozwiązywanie problemów z Androidem.