Korzystanie z przykładowej aplikacji na Androida

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 aplikacja przykładowa wczytuje wszystkie lokalne urządzenia znajdujące się 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 barwowej (włączanie i wyłączanie, jasność)
  • Czujnik kontaktu (stan logiczny)
  • Światło z możliwością ściemniania (włączanie i wyłączanie, jasność)
  • Rozszerzone światło kolorowe (włączanie i wyłączanie, jasność)
  • Przełącznik ogólny
  • Aparat Google
  • Czujnik obecności (wykrywanie obecności)
  • Włączanie i wyłączanie światła (włączanie i wyłączanie, jasność)
  • Włącznik światła
  • Włącznik/wyłącznik (włączony i wyłączony)
  • Czujnik włączania/wyłączania

Działania na istniejących urządzeniach i automatyzacjach

Aplikacja przykładowa składa się z 2 kart: UrządzeniaAutomatyzacje. Każda karta zawiera informacje o strukturze i umożliwia wykonywanie zadań.

Karta urządzeń

Karta Urządzenia (rysunek 1) zawiera pomieszczenia w strukturze (Podwórko, Strych, 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ę. Spowoduje to wyświetlenie ekranu sterowania tym urządzeniem (rysunek 2).

Aby dodać urządzenie do struktury, 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 Urządzenia w przykładowej aplikacji Home API.
Rysunek 1. Przykładowy ekran aplikacji: widok karty Urządzenia
Sterowanie urządzeniami w aplikacji próbnej Home API.
Rysunek 2. Przykładowe elementy sterujące urządzeniem w aplikacji

Karta Automatyzacja

Karta Automatyzacje (rysunek 3) zawiera listę wszystkich automatyzacji dotyczących struktury. Każda automatyzacja zawiera elementy uruchamiające i działania. Obsługiwanych jest wiele elementów rozpoczynają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 uruchomić ją ręcznie bez potrzeby używania narzędzia do uruchamiania, pod warunkiem że przycisk Uruchom ręcznie jest obsługiwany w przypadku tej automatyzacji.

W widoku szczegółowym automatyzacji (rysunek 4) możesz też włączyć lub wyłączyć automatyzację, przełączając pole isActive. 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.

karty Automatyzacje w aplikacji próbnej Home API.
Ilustracja 3. Widok karty Automatyzacja
Widok szczegółowy wybranej automatyzacji.
Ilustracja 4. Widok szczegółowy jednej automatyzacji

Utwórz automatyzację

Aby utworzyć nową automatyzację, na liście automatyzacji kliknij przycisk Utwórz (rysunek 3). Pojawi się ekran Nowa automatyzacja (rysunek 5).

Aby dodać do automatyzacji co najmniej 1 początek i działanie, użyj przycisków +Dodaj początek+Dodaj działanie (rysunek 5). Na ilustracjach 6 i 7 pokazano przykłady wyboru odpowiednio początku rutyny i czynności. Po dokonaniu wyboru i zapisaniu polecenia inicjującego lub działania pojawią się przyciski Zaktualizuj polecenie inicjująceUsuń polecenie inicjujące (oraz Zaktualizuj działanieUsuń działanie). Dzięki temu możesz edytować polecenie inicjujące lub czynność albo je usunąć, zanim zapiszesz automatyzację.

Po dodaniu poleceń inicjujących i działań możesz wrócić do ekranu Nowa automatyzacja i kliknąć Utwórz automatyzację (rysunek 8).

Przykładowy ekran aplikacji do rozpoczynania nowej automatyzacji
Rysunek 5. Rozpoczynanie tworzenia nowej automatyzacji
Przykładowy ekran aplikacji do dodawania polecenia inicjującego automatyzację.
Rysunek 6. Dodawanie elementu rozpoczynającego do automatyzacji
Przykładowy ekran aplikacji do dodawania działania do automatyzacji.
Rysunek 7. Dodawanie działania do automatyzacji
Przykładowy ekran aplikacji do tworzenia automatyzacji.
Rysunek 8. Tworzenie automatyzacji

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

Jeśli masz problemy z korzystaniem z aplikacji przykładowej, zapoznaj się z sekcją Rozwiązywanie problemów na Androidzie.