Dokumentacja

Dokumentacja FreeKiosk

Wszystko, czego potrzeba do wdrożenia i konfiguracji kiosku

Przegląd

FreeKiosk to darmowa aplikacja open source, która zmienia tablety z Androidem w bezpieczne kioski wyświetlające jedną stronę WWW lub aplikację webową na pełnym ekranie. Idealna do ekranów informacyjnych, systemów POS, digital signage i ogólnodostępnych terminali.

Co potrafi

  • WebView na pełnym ekranie lub aplikacja zewnętrzna
  • REST API (ponad 40 punktów końcowych)
  • Rotacja URL i harmonogram
  • Pełna blokada urządzenia

Wymagania

  • Android 8.0+ (Oreo)
  • Połączenie sieciowe
  • ADB (dla Device Owner)

Instalacja

Instalacja podstawowa

  1. 1

    Pobierz APK

    Z naszej strony pobierania lub ze Sklepu Google Play

  2. 2

    Przenieś plik na urządzenie

    Przez USB, e-mail lub bezpośrednie pobranie

  3. 3

    Zainstaluj aplikację

    W razie potrzeby włącz „Nieznane źródła” w Ustawienia > Zabezpieczenia

  4. 4

    Otwórz FreeKiosk

    Skonfiguruj swój URL i ustawienia

Pobierz FreeKiosk

Tryb Device Owner

Dlaczego Device Owner?

Tryb Device Owner zapewnia pełną blokadę: brak paska stanu, brak powiadomień, brak przycisków nawigacji, automatyczny restart po awarii i brak możliwości wyjścia z kiosku przez użytkowników.

Wymagania

  • Urządzenie przywrócone do ustawień fabrycznych (bez konta Google)
  • ADB zainstalowane na komputerze
  • Debugowanie USB włączone na urządzeniu
  • FreeKiosk już zainstalowany

Konfiguracja krok po kroku

Krok 1: przywrócenie ustawień fabrycznych

Przejdź do Ustawienia → System → Opcje resetowania → Wymaż wszystkie dane

NIE dodawaj konta Google podczas pierwszej konfiguracji. Pomiń zakładanie wszelkich kont.

Krok 2: włączenie opcji programisty
  1. Przejdź do Ustawienia → Informacje o tablecie
  2. Dotknij 7 razy Numer kompilacji
  3. Wróć do Ustawienia → Opcje programisty
  4. Włącz Debugowanie USB
Krok 3: instalacja FreeKiosk

Zainstaluj APK przez USB, pobranie z sieci lub kartę SD. Upewnij się, że aplikacja jest zainstalowana przed uruchomieniem polecenia ADB.

Krok 4: ustawienie Device Owner

Podłącz tablet przez USB i uruchom:

adb shell dpm set-device-owner com.freekiosk/.DeviceAdminReceiver

Powinien pojawić się komunikat: Success: Device owner set

Usuwanie trybu Device Owner

Aby usunąć status Device Owner, przejdź do Ustawienia FreeKiosk → Usuń Device Owner lub uruchom:

adb shell dpm remove-active-admin com.freekiosk/.DeviceAdminReceiver

Konfiguracja podstawowa (szybki start)

1Twój URL

Adres URL, który tablet będzie stale wyświetlać.

https://freekiosk.app

2Kod PIN

4-6-cyfrowy PIN dostępu do ustawień.

3Zalecany tryb

ZastosowanieTrybPrzypinanie ekranu
🌐 Strona WWWWebView✅ Włączone
📺 Aplikacja zewnętrznaAplikacja zewnętrzna✅ Włączone
🧪 Test / demoWebView❌ Wyłączone

4Najważniejsze ustawienia

OpcjaZalecana wartość
Pełny ekran✅ Włączone
Autostart po uruchomieniu✅ Włączone
Ukryj pasek stanu✅ Włączone
Wygaszanie ekranuNigdy (lub przez wygaszacz ekranu)
Jasność50-70%

5REST API (opcjonalnie)

Steruj tabletem z Home Assistant.

Więcej szczegółów w dokumentacji API.

Funkcje

Pełna blokada

Brak wyjścia bez kodu PIN

REST API

Ponad 40 punktów końcowych dla Home Assistant

Rotacja URL i harmonogram

Przełączaj lub planuj adresy URL według godziny/daty

Tryb aplikacji zewnętrznej

Zablokuj dowolną aplikację na Androida

Odtwarzacz multimediów

Signage z pokazem wideo i obrazów

MQTT i Home Assistant

Natywne automatyczne wykrywanie MQTT

Zarządzanie z chmury

Rejestruj i steruj całą flotą urządzeń

Nowoczesny interfejs

Uporządkowane ustawienia na kartach

FreeKiosk Cloud (zdalne zarządzanie)

Masz więcej niż jeden kiosk? FreeKiosk Cloud to nasz opcjonalny panel SaaS do zdalnego monitorowania i aktualizowania całej floty urządzeń oraz sterowania nią. Aplikacja świetnie działa bez niego, ale rejestracja urządzenia odblokowuje monitorowanie na żywo, zdalne polecenia, grupy, alerty i zdalne zrzuty ekranu.

Pierwsze urządzenie za darmo, na zawsze

Załóż konto i zarejestruj pierwsze urządzenie za darmo, bez karty. Zobacz cennik.

Rejestracja urządzenia

1

Utwórz organizację

Załóż konto na cloud.freekiosk.app i wybierz liczbę urządzeń.

2

Wygeneruj token rejestracji

W panelu otwórz Dodaj urządzenie, aby otrzymać jednorazowy token rejestracji.

3

Wprowadź go na tablecie

W ustawieniach FreeKiosk otwórz kartę Zaawansowane, potem Zarządzanie z chmury, i wklej URL serwera oraz token.

4

Urządzenie pojawia się we flocie

Rejestruje się w kilka sekund i co 30 sekund wysyła sygnał życia (heartbeat) ze swoim statusem.

Co można robić w FreeKiosk Cloud

Status na żywo: bateria, sieć, pamięć, ekran
Zdalne polecenia (odświeżenie, restart, zrzut ekranu...)
Grupy urządzeń z działaniami zbiorczymi
Profile konfiguracji (URL, jasność, głośność)
Alerty przez e-mail, webhook i push
Zdalne zrzuty ekranu i dziennik aktywności (CSV)
Poznaj FreeKiosk Cloud

Rozwiązywanie problemów

Polecenie Device Owner kończy się błędem

Upewnij się, że urządzenie zostało przywrócone do ustawień fabrycznych i nie ma konta Google. Usuń wszystkie konta w Ustawienia → Konta.

ADB nie widzi urządzenia

Włącz debugowanie USB, spróbuj innego kabla USB i zainstaluj sterowniki urządzenia na komputerze.

Biały ekran w kiosku

Sprawdź, czy URL jest poprawny i dostępny. Najpierw spróbuj otworzyć ten URL w Chrome.

Nie można wyjść z trybu kiosku

Dotknij szybko 5 razy w dowolnym miejscu ekranu (domyślny gest), aby wyświetlić ekran PIN.

Potrzebujesz więcej pomocy?

Zajrzyj do FAQ lub zgłoś problem na GitHubie