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.

  1. Podstawowa funkcjonalno┼Ť─ç aplikacji mobilnej 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. AIS Dom

  2. Przej┼Ťcie do ustawie┼ä aplikacji.

  3. Sygnalizacja trybu po┼é─ůczenia z bramk─ů (lokalnie / tunel).

  4. Mikrofon do komunikacji z asystentem głosowym.

  5. Wskaźnik poziomu dźwięku w mikrofonie - obrazuje to jak asystent nas słyszy.

  6. uruchomienie trybu gest├│w.

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

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.

Funkcjonalno┼Ť─ç aplikacji

Aplikacja Asystent domowy

Podstawowa funkcjonalno┼Ť─ç aplikacji mobilnej 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.

AIS Dom

Wysyłanie komend głosowych do bramki

Po naci┼Ťni─Öciu przycisku mikrofonu mo┼╝emy powiedzie─ç komend─Ö i przes┼éa─ç j─ů do wykonania do bramki. AIS Dom

Skanowanie tag├│w NFC

Jeżeli nasz telefon ma wbudowany czytnik kodów NFC, to możemy przesyłać do bramki komendy zapisane w kodach NFC lub identyfikatory zeskanowanych tagów NFC.

Komenda w tagu NFC

Zamiast m├│wi─ç komend─Ö lub wpisywa─ç j─ů w okienko czatu z Asystentem domowym mo┼╝emy przy┼éo┼╝y─ç odblokowany telefon do taga NFC i przes┼éa─ç do bramki komend─Ö zapisan─ů tekstowo w tagu NFC.

Do zapisu tekstu do tag├│w NFC polecamy darmow─ů aplikacj─Ö NFC Tools. Aplikacja ta jest bardzo intuicyjna. Po jej uruchomieniu w pierwszej zak┼éadce mo┼╝emy odczyta─ç tag NFC i sprawdzi─ç, czy jest odblokowany do zapisu. Je┼╝eli tag jest zapisywalny, to przechodzimy do zak┼éadki ZAPIS i wybieramy opcj─Ö Dodaj pozycj─Ö. Nast─Öpnie wybieramy pozycj─Ö typu Tekst i wprowadzamy tekst polecenia/komendy, kt├│ra ma by─ç wykonana na bramce, np. W┼é─ůcz radio Eska Rock i zatwierdzamy OK.

AIS Dom Po zapisie tekstu komendy do naszego taga NFC wychodzimy z aplikacji NFC Tools.

Teraz zeskanowanie tego taga NFC spowoduje przes┼éanie zapisanej w nim komedy bezpo┼Ťrednio do naszej bramki. AIS Dom

Co spowoduje uruchomienie akcji powi─ůzanej z komend─ů AIS Dom

W ten spos├│b mo┼╝emy wykonywa─ç dowolne rzeczy na bramce - uruchamia─ç automatyzacj─Ö, sceny, sterowa─ç urz─ůdzeniami, pyta─ç o status czujnik├│w, odtwarza─ç audio itd..

Skan identyfikatora NFC

Je┼╝eli w zeskanowanym tagu NFC nie ma rekordu typu text, to wysy┼éamy do bramki sam identyfikator zeskanowanego taga NFC. W ten spos├│b wyzwalamy na bramce zdarzenie (event) typu tag_scanned a w danych tego zdarzenia (w event_data) przekazujemy identyfikator taga tag_id. Ta funkcjonalno┼Ť─ç┬ápozwala na wykorzystanie tag├│w NFC, kt├│re mamy w domu, do wykonywania automatyzacji na bramce.

Przyk┼éad, w jaki spos├│b mo┼╝na skorzysta─ç z tej funkcjonalno┼Ťci, opisany jest szczeg├│┼éowo w Automatyzacja wyzwalana tagiem NFC.

Sterowanie gestami

Ikona z prawej strony na dolnym pasku aplikacji, pozwala na prze┼é─ůczanie aplikacji w tryb sterowania gestami - by prze┼é─ůczy─ç w tryb sterowania gestami nale┼╝y nacisn─ů─ç i przytrzyma─ç t─Ö ikon─Ö.

Sterowanie gestami

Definiowanie gest├│w

Gesty mo┼╝emy definiowa─ç w ustawieniach 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

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

Synchronizacja z bramk─ů

Opcja raportowania do bramki uruchomi serwis kt├│ry okresowo b─Ödzie przesy┼éa┼é do bramki lokalizacj─Ö urz─ůdzenia oraz informacje o stanie niekt├│rych czujnik├│w w telefonie. GPS

To ile statusów zostało wysłanych do bramki, możemy zobaczyć w powiadomieniu aplikacji. 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 statusu czujnik├│w w telefonie czy te┼╝ 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.

Opis techniczny działania 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. Aplikacja wy┼Ťwietlana jest w komponencie WebView systemu Andorid, komponent ten umo┼╝liwia wy┼Ťwietlanie tre┼Ťci aplikacji webowej jako aktywno┼Ťci w aplikacji. W Android od wersji 7.1.2 komponent WebView mo┼╝e u┼╝ywa─ç tego samego silnika co przegl─ůdarka Chrome, co umo┼╝liwia bardzo responsywne dzia┼éanie aplikacji.

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

  • przej┼Ťcie do ustawie┼ä aplikacji

  • sygnalizacja trybu po┼é─ůczenia z bramk─ů (lokalnie / tunel)

  • mikrofon do komunikacji z asystentem g┼éosowym. Mikrofon u┼╝ywa wbudowanego w system Android mechanizmu SpeechRecognizer

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