Przykładowa aplikacja na Androida prezentuje 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 pokoju, będzie wyświetlane w tym pokoju. Przykładowa aplikacja obsługuje te typy 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ść)
- Światło o rozszerzonej palecie barw (włączanie i wyłączanie, jasność)
- Ogólny przełącznik
- Aparat Google
- Czujnik obecności (wykrywanie obecności)
- Światło włączane i wyłączane (włączanie i wyłączanie, jasność)
- Włącznik/wyłącznik światła
- Włącznik (włączanie i wyłączanie)
- Czujnik włączania i wyłączania
Działania na istniejących urządzeniach i automatyzacje
Przykładowa aplikacja składa się z 2 kart – Urządzenia i Automatyzacja. Każda karta zawiera informacje o strukturze i umożliwia wykonywanie zadań.
Karta urządzeń
Karta Urządzenia (rysunek 1) pokazuje pokoje w strukturze (Podwórko, Poddasze, Podróż) oraz urządzenia w każdym pokoju wraz ze stanem każdego urządzenia. Aby wyświetlić lub edytować cechy urządzenia, kliknij jego nazwę. Spowoduje to przejście do ekranu sterowania tym urządzeniem (rysunek 2).
Aby dodać urządzenie do struktury, na karcie Urządzenia (rysunek 1) kliknij Dodaj urządzenie i postępuj zgodnie z instrukcjami, aby dodać urządzenie z kodem QR lub bez niego.
Karta Automatyzacja
Karta Automatyzacja (rysunek 3) zawiera listę wszystkich automatyzacji w strukturze. Każda automatyzacja pokazuje swoje polecenia inicjujące i działania. Obsługiwane są różne polecenia inicjujące i działania.
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 ręcznie ją uruchomić bez konieczności używania polecenia inicjującego, pod warunkiem że ta automatyzacja obsługuje przycisk Uruchom ręcznie.
W widoku szczegółowym automatyzacji (rysunek 4) możesz też przełączyć isActive , aby włączyć lub wyłączyć automatyzację. Pole isValid jest ustawiane przez pakiet SDK i ma wartość false , jeśli wystąpi problem z obsługą urządzenia lub cechy albo inny problem.
Tworzenie automatyzacji
Aby utworzyć nową automatyzację, w widoku listy automatyzacji (rysunek 3) kliknij przycisk Utwórz. Pojawi się ekran Nowa automatyzacja (rysunek 5).
Aby dodać do automatyzacji co najmniej 1 polecenie inicjujące i działanie, użyj przycisków +Dodaj polecenie inicjujące i +Dodaj działanie (rysunek 5). Rysunki 6 i 7 przedstawiają przykłady wybierania odpowiednio polecenia inicjującego i działania. Po dokonaniu wyborów i zapisaniu polecenia inicjującego lub działania pojawią się 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 samą automatyzację.
Gdy skończysz dodawać polecenia inicjujące i działania, 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 dotyczącymi niektórych typowych zdarzeń.
Informacje o tym, jak rozwiązać te problemy, znajdziesz w logach adb.
Jeśli masz problemy z korzystaniem z przykładowej aplikacji, zapoznaj się z artykułem Rozwiązywanie problemów z Androidem.