Documentație

Hexer DialerInstrukcja Obslugi

Documentație completă Hexer Dialer - de la prima configurare până la setările avansate.

1. Wymagania systemowe

Minimalne wymagania sprzetowe

System operacyjnyAndroid 10.0 (API 29) lub nowszy
RAMMinimum 2 GB
Pamiec wewnetrznaMinimum 50 MB wolnego miejsca
EkranZalecane 7-10 cali (tablet)
SiecKarta 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

UprawnienieCel
CALL_PHONEWykonywanie polaczen telefonicznych
READ_PHONE_STATEMonitorowanie stanu polaczen
ANSWER_PHONE_CALLSOdbieranie polaczen przychodzacych
RECORD_AUDIOMikrofon podczas rozmowy
POST_NOTIFICATIONSPowiadomienia 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!

WKROTCE DOSTEPNE W
Google Play

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

1

Uprawnienia systemowe

Zaakceptuj wszystkie wymagane uprawnienia (telefon, mikrofon, powiadomienia)

2

Domyslna aplikacja telefoniczna

Ustaw Hexer Dialer jako domyslny dialer systemowy

3

Haslo administratora

Ustaw haslo dostepu do panelu administracyjnego (zalecane min. 6 znakow)

4

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:

  1. Otworz Ustawienia > Aplikacje > Hexer Dialer
  2. Kliknij "Uprawnienia"
  3. Wlacz wszystkie wymagane uprawnienia: Telefon, Mikrofon, Powiadomienia

Ustawienie domyslnego dialera

  1. Otworz Ustawienia > Aplikacje > Domyslne aplikacje
  2. Wybierz "Aplikacja telefoniczna" lub "Dialer"
  3. 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

  1. Wykonaj kopie zapasowa waznych danych
  2. Otworz Ustawienia > System > Opcje resetowania
  3. Wybierz "Wykasuj wszystkie dane (reset fabryczny)"
  4. 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

  1. Po resecie, na ekranie powitalnym NIE loguj sie do konta Google
  2. Polacz sie z WiFi
  3. Wlacz Opcje programisty (7x kliknij "Numer kompilacji" w Ustawienia > O telefonie)
  4. Wlacz Debugowanie USB w Opcjach programisty
  5. Polacz urzadzenie kablem USB do komputera
  6. 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:

  1. Otworz Ustawienia > Bezpieczenstwo > Przypinanie ekranu
  2. Wlacz funkcje przypinania
  3. Otworz aplikacje Hexer Dialer
  4. Kliknij przycisk "Ostatnie aplikacje" (kwadrat)
  5. 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":

Modern
Minimal
Professional
Nature
Warm
Elegant

Wlasne kolory

Kazdy element interfejsu mozna dostosowac indywidualnie:

ElementOpis
Tlo glowneKolor tla ekranu glownego
TytulKolor, rozmiar i grubosc tekstu naglowka
Przycisk dzwonieniaTlo, tekst, obramowanie, zaokraglenie
Karta kontaktuTlo, tekst, cien karty
Ekran rozmowyTlo, 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:

  1. Przygotuj plik czcionki w formacie TTF lub OTF
  2. W panelu admina otworz zakladke "Wyglad"
  3. Kliknij "Wybierz czcionke" i wskazz plik
  4. Czcionka zostanie zastosowana do wszystkich tekstow

8. Zarzadzanie kontaktami

Dodawanie kontaktow

Kontakty (osoby) to lista osob/dzialow wyswietlana uzytkownikowi na ekranie glownym.

  1. Otworz panel admina > zakladka "Zawartosc"
  2. Kliknij "Dodaj osobe"
  3. Wprowadz nazwe (np. "Recepcja", "Jan Kowalski")
  4. Wprowadz numer telefonu w formacie miedzynarodowym (+48...)
  5. Zapisz zmiany

Nazwy wielojezyczne

Kazdy kontakt moze miec inne nazwy dla roznych jezykow:

JezykNazwa
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:

  1. Otworz panel admina > zakladka "Harmonogram"
  2. Ustaw godzine rozpoczecia (np. 08:00)
  3. Ustaw godzine zakonczenia (np. 18:00)
  4. 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

ScenariuszStartKoniec
Biuro standardowe08:0017:00
Hotel 24h00:0023:59
Przychodnia07:0020: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 szyfrowaniaAES-256-GCM
Przechowywanie kluczyAndroid Keystore (HSM)
Hashowanie haselPBKDF2WithHmacSHA256, 120k iteracji
Sol haslaLosowa, unikalna dla kazdego hasla

Zmiana hasla administratora

  1. Otworz panel admina > zakladka "Bezpieczenstwo"
  2. Kliknij "Zmien haslo"
  3. Wprowadz aktualne haslo
  4. Wprowadz nowe haslo (min. 6 znakow)
  5. 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

  1. Otworz panel admina > zakladka "Bezpieczenstwo"
  2. Kliknij "Eksportuj ustawienia"
  3. Wybierz lokalizacje zapisu pliku JSON
  4. 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

  1. Otworz panel admina > zakladka "Bezpieczenstwo"
  2. Kliknij "Importuj ustawienia"
  3. Wybierz plik JSON z backupem
  4. Potwierdz import (nadpisze aktualne ustawienia)
  5. 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:

Specyfikacja techniczna

Nazwa pakietupl.hexer.dialer
Min. wersja AndroidAndroid 10 (API 29)
Target SDKAndroid 14 (API 34)
ArchitekturaMVVM + Clean Architecture
UI FrameworkJetpack Compose
Dependency InjectionHilt
Baza danychRoom + Encrypted DataStore
SzyfrowanieAES-256-GCM (Android Keystore)
Obslugiwane jezykiPL, EN, ES, DE, FR, IT, PT, NL, RU, UK, CS, SK, LT, HU, RO
DostepnoscWCAG 2.1 Level AA

Potrzebujesz pomocy z konfiguracja?

Nasz zespol pomoze Ci skonfigurowac Hexer Dialer dla Twojej organizacji.

Zamow pomoc techniczna