Hexer DialerInstrukcja Obslugi
Documentazione completa di Hexer Dialer - dalla prima configurazione alle impostazioni avanzate.
Indice
Konfiguracja
1. Wymagania systemowe
Minimalne wymagania sprzetowe
| System operacyjny | Android 10.0 (API 29) lub nowszy |
| RAM | Minimum 2 GB |
| Pamiec wewnetrzna | Minimum 50 MB wolnego miejsca |
| Ekran | Zalecane 7-10 cali (tablet) |
| Siec | Karta SIM z mozliwoscia polaczen glosowych LUB VoIP |
Zalecane urzadzenia
Samsung Galaxy Tab A/S series, Lenovo Tab M10/P11, Nokia T20/T21. Unikaj tanich tabletow bez certyfikacji Google Play - moga miec problemy z telefonowaniem.
Wymagane uprawnienia
| Uprawnienie | Cel |
|---|---|
CALL_PHONE | Wykonywanie polaczen telefonicznych |
READ_PHONE_STATE | Monitorowanie stanu polaczen |
ANSWER_PHONE_CALLS | Odbieranie polaczen przychodzacych |
RECORD_AUDIO | Mikrofon podczas rozmowy |
POST_NOTIFICATIONS | Powiadomienia o polaczeniach (Android 13+) |
2. Instalacja aplikacji
Google Play Store
Juz wkrotce w Google Play
Hexer Dialer bedzie dostepny do pobrania bezposrednio ze sklepu Google Play. Subskrybuj powiadomienia, aby byc na biezaco!
Chcesz otrzymac powiadomienie o premierze?
Skontaktuj sie z nami i zostaw swoj email - poinformujemy Cie, gdy aplikacja pojawi sie w Google Play Store.
Wazne dla trybu kiosk
Przed instalacja w trybie Device Owner (kiosk), urzadzenie musi byc zresetowane do ustawien fabrycznych. Wiecej informacji w sekcji Tryb kiosk.
3. Pierwsze uruchomienie
Po pierwszym uruchomieniu aplikacji, zostaniesz poproszony o nadanie wymaganych uprawnien oraz ustawienie Hexer Dialer jako domyslnej aplikacji telefonicznej.
Kreator konfiguracji
Uprawnienia systemowe
Zaakceptuj wszystkie wymagane uprawnienia (telefon, mikrofon, powiadomienia)
Domyslna aplikacja telefoniczna
Ustaw Hexer Dialer jako domyslny dialer systemowy
Haslo administratora
Ustaw haslo dostepu do panelu administracyjnego (zalecane min. 6 znakow)
Dodanie kontaktow
Dodaj osoby/dzialy, do ktorych uzytkownicy beda dzwonic
4. Uprawnienia
Aplikacja wymaga kilku uprawnien systemowych do prawidlowego dzialania. Wszystkie uprawnienia sa niezbedne dla funkcji telefonicznych.
Reczne nadawanie uprawnien
Jesli pominales nadanie uprawnien przy pierwszym uruchomieniu:
- Otworz Ustawienia > Aplikacje > Hexer Dialer
- Kliknij "Uprawnienia"
- Wlacz wszystkie wymagane uprawnienia: Telefon, Mikrofon, Powiadomienia
Ustawienie domyslnego dialera
- Otworz Ustawienia > Aplikacje > Domyslne aplikacje
- Wybierz "Aplikacja telefoniczna" lub "Dialer"
- Wybierz Hexer Dialer
# Alternatywnie przez ADB:
# Sprawdz obecny domyslny dialer adb shell cmd role get-role-holders android.app.role.DIALER # Ustaw Hexer Dialer jako domyslny adb shell cmd role add-role-holder android.app.role.DIALER pl.hexer.dialer
5. Tryb kiosk (Device Owner)
Tryb kiosk (Device Owner) blokuje urzadzenie w aplikacji Hexer Dialer. Uzytkownicy nie moga wyjsc z aplikacji, otworzyc innych aplikacji ani zmienic ustawien systemu.
Wymagany reset fabryczny!
Konfiguracja Device Owner wymaga urzadzenia po resecie fabrycznym (przed pierwsza konfiguracja konta Google). Nie ma mozliwosci aktywacji trybu kiosk na juz skonfigurowanym urzadzeniu.
Krok 1: Reset fabryczny
- Wykonaj kopie zapasowa waznych danych
- Otworz Ustawienia > System > Opcje resetowania
- Wybierz "Wykasuj wszystkie dane (reset fabryczny)"
- Potwierdz reset
Krok 2: Przygotowanie komputera
# Zainstaluj ADB (Android Debug Bridge) # Windows: Pobierz SDK Platform Tools z developer.android.com # macOS: brew install android-platform-tools # Linux: sudo apt install adb # Sprawdz czy ADB dziala adb version
Krok 3: Konfiguracja urzadzenia
- Po resecie, na ekranie powitalnym NIE loguj sie do konta Google
- Polacz sie z WiFi
- Wlacz Opcje programisty (7x kliknij "Numer kompilacji" w Ustawienia > O telefonie)
- Wlacz Debugowanie USB w Opcjach programisty
- Polacz urzadzenie kablem USB do komputera
- Zaakceptuj monit o debugowaniu USB na urzadzeniu
Krok 4: Instalacja i aktywacja Device Owner
# Sprawdz polaczenie z urzadzeniem adb devices # Zainstaluj aplikacje adb install HexerDialer.apk # Ustaw aplikacje jako Device Owner adb shell dpm set-device-owner pl.hexer.dialer/.admin.DeviceAdminReceiver # Powinno wyswietlic: "Success: Device owner set to package..." # Weryfikacja adb shell dpm list-owners
Sukces!
Po poprawnej konfiguracji, aplikacja automatycznie wlacza tryb Lock Task. Urzadzenie jest teraz zablokowane w trybie kiosk.
Usuwanie Device Owner
Aby usunac tryb kiosk i przywrocic normalne dzialanie urzadzenia:
# Usun Device Owner (wymaga dostepu do panelu admina w aplikacji) # LUB przez ADB: adb shell dpm remove-active-admin pl.hexer.dialer/.admin.DeviceAdminReceiver # Alternatywnie - pelny reset: adb shell wipe data
Tryb Screen Pinning (alternatywa)
Jesli nie mozesz skonfigurowac Device Owner, uzyj trybu Screen Pinning jako alternatywy:
- Otworz Ustawienia > Bezpieczenstwo > Przypinanie ekranu
- Wlacz funkcje przypinania
- Otworz aplikacje Hexer Dialer
- Kliknij przycisk "Ostatnie aplikacje" (kwadrat)
- Kliknij ikone pinezki na karcie aplikacji
Ograniczenia Screen Pinning
W trybie Screen Pinning uzytkownik moze wyjsc z aplikacji przytrzymujac przyciski Back + Recent. Device Owner jest znacznie bezpieczniejszy dla srodowisk produkcyjnych.
6. Panel administracyjny
Dostep do panelu
Panel administracyjny jest ukryty przed uzytkownikami. Aby go otworzyc:
Gestem lub dotkieciem
Dotknij i przytrzymaj prawy gorny rog ekranu przez 3 sekundy. Pojawi sie okno logowania - wprowadz haslo administratora.
Struktura panelu
Panel administracyjny sklada sie z kilku zakladek:
Oglone
Informacje o aplikacji, status domyslnego dialera, dostep do ustawien systemowych
Wyglad
Kolory, logo, czcionki, gotowe motywy kolorystyczne
Ekran rozmowy
Wyglad ekranu podczas polaczenia, przyciski, komunikaty
Zawartosc
Kontakty (osoby), statusy dostepnosci, teksty wielojezyczne
Harmonogram
Godziny pracy, tryb usypiania, okresy specjalne (swieta)
Bezpieczenstwo
Haslo admina, backup i przywracanie ustawien
7. Personalizacja wygladu
Motywy kolorystyczne
Aplikacja zawiera 6 gotowych motywow kolorystycznych. Wybierz motyw w zakladce "Wyglad":
Wlasne kolory
Kazdy element interfejsu mozna dostosowac indywidualnie:
| Element | Opis |
|---|---|
| Tlo glowne | Kolor tla ekranu glownego |
| Tytul | Kolor, rozmiar i grubosc tekstu naglowka |
| Przycisk dzwonienia | Tlo, tekst, obramowanie, zaokraglenie |
| Karta kontaktu | Tlo, tekst, cien karty |
| Ekran rozmowy | Tlo, przyciski sterowania, etykiety |
Logo i grafiki
- Obslugiwane formaty: SVG (zalecane), PNG, JPG
- Zalecana rozdzielczosc: min. 512x512 px dla rastrow
- Logo wyswietlane na ekranie glownym i podczas rozmowy
- Mozliwosc dostosowania rozmiaru i marginesow
Wlasne czcionki
Dodaj wlasna czcionke (TTF lub OTF) dla spojnego brandingu:
- Przygotuj plik czcionki w formacie TTF lub OTF
- W panelu admina otworz zakladke "Wyglad"
- Kliknij "Wybierz czcionke" i wskazz plik
- Czcionka zostanie zastosowana do wszystkich tekstow
8. Zarzadzanie kontaktami
Dodawanie kontaktow
Kontakty (osoby) to lista osob/dzialow wyswietlana uzytkownikowi na ekranie glownym.
- Otworz panel admina > zakladka "Zawartosc"
- Kliknij "Dodaj osobe"
- Wprowadz nazwe (np. "Recepcja", "Jan Kowalski")
- Wprowadz numer telefonu w formacie miedzynarodowym (+48...)
- Zapisz zmiany
Nazwy wielojezyczne
Kazdy kontakt moze miec inne nazwy dla roznych jezykow:
| Jezyk | Nazwa |
|---|---|
| Polski (PL) | Recepcja |
| Angielski (EN) | Reception |
| Niemiecki (DE) | Rezeption |
Statusy dostepnosci
Statusy informuja uzytkownika o dostepnosci danej osoby/uslugi:
- Dostepny - mozna dzwonic (domyslny)
- Zajety - przycisk dzwonienia zablokowany
- Przerwa - informacja o przerwie
- Nieobecny - blokada polaczen
Zmiana statusu przez uzytkownika
Mozesz wlaczyc lub wylaczyc mozliwosc zmiany statusu przez uzytkownika gestem przesuniecia. Domyslnie ta opcja jest wylaczona dla srodowisk kiosk.
9. Harmonogram pracy
Godziny pracy
Skonfiguruj godziny, w ktorych aplikacja jest aktywna:
- Otworz panel admina > zakladka "Harmonogram"
- Ustaw godzine rozpoczecia (np. 08:00)
- Ustaw godzine zakonczenia (np. 18:00)
- Wlacz "Tryb usypiania"
Tryb usypiania (Sleep Mode)
Poza godzinami pracy, ekran urzadzenia staje sie czarny (oszczednosc energii). Panel admina pozostaje dostepny przez dotyk w prawym gornym rogu.
Przyklady konfiguracji
| Scenariusz | Start | Koniec |
|---|---|---|
| Biuro standardowe | 08:00 | 17:00 |
| Hotel 24h | 00:00 | 23:59 |
| Przychodnia | 07:00 | 20:00 |
Okresy specjalne
Dodaj okresy, w ktorych urzadzenie bedzie w trybie usypiania (swieta, konserwacja):
- Data rozpoczecia i zakonczenia
- Opcjonalny komunikat dla uzytkownikow
- Automatyczne wznowienie po zakonczeniu okresu
10. Bezpieczenstwo
Szyfrowanie danych
Wszystkie ustawienia i dane sa szyfrowane:
| Algorytm szyfrowania | AES-256-GCM |
| Przechowywanie kluczy | Android Keystore (HSM) |
| Hashowanie hasel | PBKDF2WithHmacSHA256, 120k iteracji |
| Sol hasla | Losowa, unikalna dla kazdego hasla |
Zmiana hasla administratora
- Otworz panel admina > zakladka "Bezpieczenstwo"
- Kliknij "Zmien haslo"
- Wprowadz aktualne haslo
- Wprowadz nowe haslo (min. 6 znakow)
- Potwierdz nowe haslo
Brak odzyskiwania hasla!
Nie ma mozliwosci odzyskania zapomnianego hasla. Jedyna opcja to reset aplikacji przez ADB, co spowoduje utrate wszystkich ustawien. Zapisz haslo w bezpiecznym miejscu!
Reset hasla przez ADB (awaryjnie)
# Wyczyszczenie danych aplikacji (usuwa wszystkie ustawienia!) adb shell pm clear pl.hexer.dialer # Alternatywnie - tylko usun encrypted shared preferences adb shell rm -rf /data/data/pl.hexer.dialer/shared_prefs/
11. Backup i przywracanie
Eksport ustawien
- Otworz panel admina > zakladka "Bezpieczenstwo"
- Kliknij "Eksportuj ustawienia"
- Wybierz lokalizacje zapisu pliku JSON
- Plik zostanie zapisany z data i czasem w nazwie
Zawartosc backupu
Plik backup JSON zawiera:
- Wszystkie ustawienia wygladu (kolory, logo, czcionki)
- Kontakty z numerami telefonow i nazwami wielojezycznymi
- Statusy dostepnosci
- Konfiguracje harmonogramu
- Ustawienia ekranu rozmowy
- Metadane (wersja, data, ID urzadzenia)
Haslo nie jest eksportowane
Ze wzgledow bezpieczenstwa, haslo administratora NIE jest zawarte w pliku backup. Po przywroceniu ustawien, haslo pozostaje bez zmian lub nalezy ustawic nowe.
Przywracanie ustawien
- Otworz panel admina > zakladka "Bezpieczenstwo"
- Kliknij "Importuj ustawienia"
- Wybierz plik JSON z backupem
- Potwierdz import (nadpisze aktualne ustawienia)
- Aplikacja automatycznie zastosuje przywrocone ustawienia
Backup przez ADB
# Kopiowanie pliku backup z urzadzenia adb pull /storage/emulated/0/Android/data/pl.hexer.dialer/files/backup.json ./ # Przywracanie pliku backup na urzadzenie adb push ./backup.json /storage/emulated/0/Download/ # Nastepnie w aplikacji: Importuj ustawienia > wybierz plik z folderu Download
12. Rozwiazywanie problemow
Polaczenia nie sa realizowane
Przyczyna: Brak uprawnien lub aplikacja nie jest domyslnym dialerem.
Rozwiazanie:
- Sprawdz uprawnienia w Ustawienia > Aplikacje > Hexer Dialer > Uprawnienia
- Ustaw jako domyslny dialer w Ustawienia > Aplikacje > Domyslne
- Sprawdz czy karta SIM jest aktywna i ma srodki
Blad "Device Owner already set"
Przyczyna: Urzadzenie ma juz skonfigurowanego Device Ownera lub konto Google.
Rozwiazanie:
- Wykonaj reset fabryczny urzadzenia
- Nie loguj sie do konta Google przed konfiguracja Device Owner
- Postepuj zgodnie z instrukcja w sekcji "Tryb kiosk"
Aplikacja nie uruchamia sie po restarcie
Przyczyna: Brak uprawnien do autostartu lub optymalizacja baterii.
Rozwiazanie:
- Wylacz optymalizacje baterii dla Hexer Dialer
- Na Xiaomi/MIUI: Wlacz "Autostart" w ustawieniach aplikacji
- Na Samsung: Wylacz "Usypianie aplikacji"
Zapomniane haslo administratora
Przyczyna: Haslo nie moze byc odzyskane.
Rozwiazanie:
# Reset danych aplikacji (utrata ustawien!) adb shell pm clear pl.hexer.dialer
Czarny ekran (tryb usypiania) w godzinach pracy
Przyczyna: Nieprawidlowe ustawienia harmonogramu lub strefa czasowa.
Rozwiazanie:
- Sprawdz godziny pracy w panelu admina > Harmonogram
- Sprawdz czy urzadzenie ma poprawna strefe czasowa
- Sprawdz czy nie ma aktywnego "Okresu specjalnego"
Logo/czcionka nie wyswietla sie
Przyczyna: Uszkodzony plik lub nieobslugiwany format.
Rozwiazanie:
- Uzyj formatu SVG dla logo (najlepsza kompatybilnosc)
- Sprawdz czy plik PNG/JPG ma rozdzielczosc min. 512x512
- Dla czcionek uzyj formatu TTF lub OTF
- Sprobuj inny plik - obecny moze byc uszkodzony
Logi diagnostyczne
Zbieranie logow do analizy problemow:
# Logi aplikacji w czasie rzeczywistym adb logcat -s HexerDialer:V # Zapis logow do pliku adb logcat -s HexerDialer:V > hexer_logs.txt # Logi systemu telefonicznego adb logcat -s Telecom:V TelecomFramework:V # Stan Device Owner adb shell dumpsys device_policy
Kontakt z supportem
Jesli nie mozesz rozwiazac problemu, skontaktuj sie z nami:
- Email: support@hexer.pl
- Formularz: hexer.pl/contact
Specyfikacja techniczna
| Nazwa pakietu | pl.hexer.dialer |
| Min. wersja Android | Android 10 (API 29) |
| Target SDK | Android 14 (API 34) |
| Architektura | MVVM + Clean Architecture |
| UI Framework | Jetpack Compose |
| Dependency Injection | Hilt |
| Baza danych | Room + Encrypted DataStore |
| Szyfrowanie | AES-256-GCM (Android Keystore) |
| Obslugiwane jezyki | PL, EN, ES, DE, FR, IT, PT, NL, RU, UK, CS, SK, LT, HU, RO |
| Dostepnosc | WCAG 2.1 Level AA |
Potrzebujesz pomocy z konfiguracja?
Nasz zespol pomoze Ci skonfigurowac Hexer Dialer dla Twojej organizacji.
Zamow pomoc techniczna