AIS dom

Wprowadzenie

To nasza g┼é├│wna aplikacja, kt├│ra dzia┼éa zar├│wno na bramce jak i na innych urz─ůdzeniach, w tym: tablety, telefony oraz Android TV.

AIS Dom

Aplikacja jest czym┼Ť w rodzaju ramki/przegl─ůdarki do aplikacji internetowej dzia┼éaj─ůcej na bramce. Dostarcza te┼╝ nam interfejs do API systemu Android oraz konsol─Ö ┼Ťrodowiska Linux (zawieraj─ůcego minimalny system podstawowy wraz z interpreterem j─Özyka Python, Node.js oraz Clang).

AIS Dom

Instalacja

Aplikacja dost─Öpna jest za darmo (bez reklam, mikrop┼éatno┼Ťci itp) w sklepie Google Play pod nazw─ů AIS dom. Mo┼╝esz zeskanowa─ç telefonem poni┼╝szy kod, by przej┼Ť─ç do instalacji aplikacji w Google Play:

Google Play

Kod źródłowy aplikacji dostępny jest w naszym publicznie dostępnym repozytorium Podpisane wersje publikujemy też na naszym serwisie ze składowymi systemu

Konfiguracja za pomoc─ů kreatora

Po pierwszym uruchomieniu aplikacji pojawi si─Ö kreator, kt├│ry przeprowadzi nas krok po kroku przez prosty proces konfiguracji

AIS Dom

Dost─Öp do mikrofonu

W pierwszym kroku kreatora mo┼╝emy w┼é─ůczy─ç dost─Öp do mikrofonu.

AIS Dom

Dost─Öp do dysku

W kolejnym kroku kreatora mo┼╝emy w┼é─ůczy─ç dost─Öp do plik├│w na urz─ůdzeniu mobilnym.

AIS Dom

Dost─Öp do lokalizacji

W kolejnym kroku kreatora mo┼╝emy w┼é─ůczy─ç dost─Öp do lokalizacji.

AIS Dom

Dost─Öp do kamery

W kolejnym kroku kreatora mo┼╝emy w┼é─ůczy─ç dost─Öp do kamery.

AIS Dom

Skanowanie identyfikatora bramki

Na koniec mo┼╝emy zeskanowa─ç identyfikator naszej bramki lub po┼é─ůczy─ç si─Ö z bramk─ů demo.

AIS Dom

Ka┼╝da bramka posiada sw├│j unikalny identyfikator, jest on losowo wygenerowany przy pierwszym uruchomieniu i pozostanie sta┼éy przez ca┼éy okres u┼╝ytkowania urz─ůdzenia. Identyfikator bramki znajdziemy klikaj─ůc w pozycj─Ö "Przydatne linki", w menu po lewej stronie w aplikacji webowej Asystent domowy:

Gate ID

Konfiguracja ustawień apliacji

W ka┼╝dej chwili mo┼╝emy przej┼Ť─ç do ustawie┼ä aplikacji naciskaj─ůc przycisk z trzema kropkami po lewej stronie na dolnej belce w aplikacji

AIS Dom

W ustawieniach możemy ręcznie wybrać parametry aplikacji lub uruchomić ponownie kreator ustawień AIS Dom

Adres URL lub identyfikator bramki

Najwa┼╝niejszy parametr to adres URL lub identyfikator bramki, nale┼╝y poprawnie ustawi─ç adres lub identyfikator bramki, by komunikacja z bramk─ů by┼éa mo┼╝liwa. Je┼╝eli chcemy ┼é─ůczy─ç si─Ö┬áz nasz─ů bramk─ů b─Öd─ůc poza sieci─ů┬ádomow─ů to nale┼╝y pami─Öta─ç o w┼é─ůczeniu dost─Öpu z Internetu.

Raportowanie lokalizacji

Opcja raportowania lokalizacji uruchomi serwis ┼Ťledz─ůcy lokalizacj─Ö urz─ůdzenia GPS

kt├│ry b─Ödzie przesy┼éa┼é zmiany wsp├│┼érz─Ödnych oraz adresu telefonu bezpo┼Ťrednio do bramki AIS dom. GPS

Takie dane w powi─ůzaniu z osob─ů w systemie pozwalaj─ů odpowiedzie─ç na pytanie typu: "Gdzie jest Jolka" oraz na uruchamianie automatyzacji w zale┼╝no┼Ťci od lokalizacji osoby - szczeg├│┼éy w Automatyzacje - wykrywanie obecno┼Ťci

Powiadomienia z bramki

Na bramce dost─Öpna jest us┼éuga ais_ai_service.mob_notify, kt├│ra umo┼╝liwia wys┼éanie z bramki powiadomienia do aplikacji mobilnej AIS dom. Dzi─Öki temu za pomoc─ů automatyzacji mo┼╝emy informowa─ç o zdarzeniach w naszym domu wybran─ů aplikacj─Ö mobiln─ů.

Powiadomienia s─ů nielimitowane, mog─ů zawiera─ç zdj─Öcie oraz tekst do przeczytania. Przyk┼éad, w jaki spos├│b mo┼╝na skorzysta─ç z tej funkcjonalno┼Ťci, opisany jest w dokumentacji integracji Galeria, w sekcji "Wysy┼éanie zdj─Öcia w powiadomieniu"

Notify

Notify

Komendy wysyłane z bramki do aplikacji mobilnej

Na bramce dost─Öpna jest us┼éuga ais_ai_service.mob_request, kt├│ra umo┼╝liwia wys┼éanie z bramki komendy (zapytania/┼╝─ůdania) do aplikacji mobilnej AIS dom. Dzi─Öki temu za pomoc─ů automatyzacji mo┼╝emy zdalnie z bramki w┼é─ůczy─ç mikrofon na urz─ůdzeniu mobilnym lub zapyta─ç o aktualn─ů lokalizacj─Ö urz─ůdzenia.

Notify

info

Na przyk┼éadach na forum pokazujemy jak wykorzysta─ç t─Ö funkcjonalno┼Ť─ç, poni┼╝ej znajduje si─Ö┬áopis serwis├│w jakie s─ů dost─Öpne.

komendadane/parametryopis
micOnZdalne w┼é─ůczenie mikrofonu na urz─ůdzeniu w celu odebrania komendy g┼éosowej
locationUpdateWys┼éania ┼╝─ůdania aktualizacji lokalizacji, uruchomienie serwisu lokalizacji na 30 sekund
locationServiceOnZdalne w┼é─ůczenie serwisu lokalizacji na telefonie
locationServiceOffZdalne wy┼é─ůczenie serwisu lokalizacji na telefonie
hotWordServiceOnZdalne w┼é─ůczenie serwisu nas┼éuchiwania s┼éowa aktywuj─ůcego komend─Ö g┼éosow─ů na telefonie
hotWordServiceOffZdalne wy┼é─ůczenie serwisu nas┼éuchiwania s┼éowa aktywuj─ůcego komend─Ö g┼éosow─ů na telefonie
audioServiceOnZdalne w┼é─ůczenie serwisu odtwarzacza audio na telefonie
audioServiceOffZdalne wy┼é─ůczenie serwisu odtwarzacza audio na telefonie
sayIt{ "text": "Cze┼Ť─ç co s┼éycha─ç" }Przes┼éanie do telefonu tekstu do powiedzenia
playAudio{ "url": "https://an.cdn.eurozet.pl/ant-kat.mp3" }Przesłanie do telefonu adresu audio do odtwarzania
stopAudioZdalne zatrzymanie odtwarzania audio na telefonie
findPhoneZdalne w┼é─ůczenie wyszukiwania telefonu - telefon zwi─Öksza g┼éo┼Ťno┼Ť─ç na 100%, m├│wi "Tu jestem" i dzwoni
UWAGA

Mo┼╝na z bramki (do kt├│rej jeste┼Ťmy zalogowani) wys┼éa─ç komend─Ö do urz─ůdzenia mobilnego i zdalnie "zmusi─ç" je do jej wykonania, tylko je┼Ťli w┼é─ůczony jest stosowny dost─Öp (do mikrofonu i/lub lokalizacji) na urz─ůdzeniu mobilnym.

Pokazujemy w powiadomieniu, ┼╝e taka zdalna komenda jest uruchomiona - ┼╝eby by┼éo to jasne dla w┼éa┼Ťciciela urz─ůdzenia.

Sterowanie gestami

Pilot do asystenta

Definiowanie gest├│w

Klikamy na ikonk─Ö po lewej stonie na dole aplikacji, ┼╝eby przej┼Ť─ç do ustawie┼ä aplikacji.

Ustawienia aplikacji

Z menu dost─Öpnego w ustawieniach wybieramy opcj─Ö "Definiowanie gest├│w"

Definiowanie gest├│w

Klikamy przysisk "Dodaj" by przej┼Ť─ç do definiowania nowego gestu

Definiowanie gest├│w

Rysujemy na ekranie gest i zapisujemy go wraz z komend─ů

Definiowanie gest├│w

Prze┼é─ůczenie w tryb sterowania gestami

Ikona na dolnym pasku aplikacji, umieszczona pomi─Ödzy przej┼Ťciem do ustawie┼ä a mikrofonem obrazuje tryb sterowania w aplikacji, by prze┼é─ůczy─ç w tryb sterowania gestami mo┼╝emy klikn─ů─ç w t─ů ikon─Ö w aplikacji mobilnej lub zmieni─ç tryb pilotem radiowym Zmiana trybu sterowania.

Prze┼é─ůczenie w tryb sterowania gestami

Wydawanie komendy za pomoc─ů gestu

Teraz możemy wykonać zdefinowany gest, co spowoduje wysłanie do asystenta zdefiniowanej komedny w celu jej wykonania

Wykonanie gestu

Działanie aplikacji

Podstawowa funkcjonalno┼Ť─ç to wy┼Ťwietlanie internetowej aplikacji Asystent domowy dzia┼éaj─ůcej na bramce, tej samej aplikacji, kt├│r─ů mo┼╝emy uruchamia─ç i konfigurowa─ç w przegl─ůdarce internetowej Aplikacja internetowa.

Dodatkowo na dolnej belce w aplikacji mamy nast─Öpuj─ůce przyciski:

  • przej┼Ťcie do ustawie┼ä aplikacji

  • sygnalizacja dzia┼éania w trybie po┼é─ůczenia lokalnego

  • sygnalizacja dzia┼éania w trybie po┼é─ůczenia przez tunel

  • mikrofon do komunikacji z asystentem g┼éosowym

  • uruchomienie trybu gest├│w

AIS Dom

Po┼é─ůczenie z bramk─ů

Mo┼╝esz r─Öcznie wpisa─ç adres URL do aplikacji webowej dzia┼éaj─ůcej na bramce, np:

w takim przypadku aplikacja AIS dom b─Ödzi─Ö ┼é─ůczy┼éa si─Ö tylko z podanym przez Ciebie adresem URL.

Mo┼╝esz zeskanowa─ç QR kod z unikalnym identyfikatorem swojej bramki, kod ten dost─Öpny jest w aplikacji webowej Asystent domowy jako pierwsza pozycja w menu "Przydatne linki":

Gate ID

Diagram po┼é─ůczenia

Je┼Ťli podasz identyfikator, to aplikacja sama b─Ödzie pr├│bowa┼éa ustali─ç, czy po┼é─ůczenie z bramk─ů ma by─ç lokalne, czy przez szyfrowany tunel. Ustalenie po┼é─ůczenia z bramk─ů dzia┼éa wg nast─Öpuj─ůcego schematu:

AIS Dom

Priorytet ma po┼é─ůczenie lokalne, je┼Ťli jest dost─Öpne.