K3AudioType

Application Android d'accessibilité pour l'entraînement à la frappe au clavier physique, conçue pour les personnes malvoyantes.

Présentation

K3AudioType est née de l'idée de créer un outil d'entraînement à la frappe rapide sur téléphone, utilisable avec un clavier physique compact dans les transports en commun. En cours de développement, nous avons réalisé son potentiel pour les personnes en situation de handicap visuel : le retour audio complet (synthèse vocale, sons, vibrations) permet de s'entraîner sans regarder l'écran.

L'application propose quatre modes d'affichage adaptés à chaque situation :

• Écran allumé — affichage normal, sans TTS ni sons
• Luminosité minimum — écran très sombre, TTS et sons actifs
• Écran noir — overlay noir total, TTS et sons actifs
• Écran éteint — écran verrouillé, TTS et sons actifs (nécessite le service d'accessibilité)

Fonctionnalités

• Entraînement à la frappe avec clavier physique (Bluetooth ou USB-C)
• Synthèse vocale (TTS) pour la navigation et la dictée des phrases
• Sons de validation, suppression et victoire (earcons)
• Retour haptique (vibrations)
• 4 modes d'écran : allumé, luminosité minimum, noir, éteint
• Suivi des performances : vitesse (WPM), précision (%), durée
• Graphique de progression avec tendance sur les 10 dernières sessions
• Textes pré-intégrés : phrases courtes et histoires
• Ajout, édition et suppression de textes personnalisés (swipe-to-delete avec undo)
• Preview des textes avant de lancer une partie (BottomSheet)
• 3 langues : français, anglais, espagnol
• Choix de la voix TTS et de la vitesse de lecture
• Navigation complète au clavier physique (mode audio)
• Triple tap pour sortir du mode écran noir sans clavier

Technologies

Technologie	Utilisation
Kotlin	Langage principal
Jetpack Compose	Interface utilisateur
Room (SQLite)	Base de données locale (textes, sessions)
Android TTS	Synthèse vocale
AccessibilityService	Capture clavier écran éteint
Foreground Service	Maintien du processus écran éteint
KDoc / Dokka	Documentation du code

Raccourcis clavier

Depuis l'écran d'accueil :

• Entrée — lancer une partie
• S — ouvrir les paramètres
• M — changer de mode d'écran
• Suppr — retour en arrière (toutes les pages)

Prérequis

• Téléphone Android (API 26+, Android 8.0 minimum)
• Clavier physique Bluetooth ou USB-C
• Android Studio (pour la compilation)

Installation

Depuis l'APK

1. Téléchargez le fichier APK.
2. Installez-le sur votre téléphone (autoriser les sources inconnues si nécessaire)
3. Au premier lancement, l'app propose d'activer le service d'accessibilité (optionnel)

Depuis les sources

git clone https://github.com/keycube/K3Mobile.git
cd K3Mobile

Ouvrez le projet dans Android Studio, puis Build → Build APK.

Architecture

com.k3mobile.testk3
├── main/
│   ├── MainActivity.kt              # Point d'entrée, navigation, gestion écran noir/dim
│   ├── MainViewModel.kt             # ViewModel partagé (TTS, préférences, BDD)
│   ├── K3AccessibilityService.kt    # Capture clavier système (dead keys)
│   ├── K3AppState.kt                # Routage événements clavier (Channel)
│   ├── K3SoundManager.kt            # Earcons et vibrations
│   └── TypingForegroundService.kt   # Service maintien écran éteint
├── data/
│   ├── AppDatabase.kt               # Base Room + données pré-populées
│   ├── TextEntity.kt                # Entité texte
│   ├── SessionEntity.kt             # Entité session
│   └── TypingDao.kt                 # Requêtes SQL
└── ui/screens/
    ├── K3TopBar.kt                  # Barre de navigation réutilisable
    ├── HomeScreen.kt                # Écran d'accueil
    ├── CustomGameScreen.kt          # Configuration de partie (catégorie + vitesse)
    ├── TextListScreen.kt            # Liste des textes (jeu + gestion)
    ├── TypingScreen.kt              # Session de frappe + résultats
    ├── StatsScreen.kt               # Statistiques et historique
    ├── SettingsScreen.kt            # Menu paramètres
    ├── SoundScreen.kt               # Réglages audio / vibrations
    ├── ScreenModeScreen.kt          # Sélection du mode d'écran
    ├── LanguageScreen.kt            # Sélection de la langue
    ├── VoiceScreen.kt               # Sélection de la voix TTS
    └── AboutScreen.kt               # À propos / crédits

Documentation

La documentation KDoc peut être générée avec Dokka :

# Windows (PowerShell, depuis le terminal Android Studio)
$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"

# HTML
.\gradlew.bat dokkaHtml
# → app/build/dokka/html/index.html

# Markdown (GitHub Flavored)
.\gradlew.bat dokkaGfm
# → app/build/dokka/gfm/

La documentation HTML sera disponible dans app/build/dokka/html/index.html.

Auteur

Mathis Marsande

• BUT Informatique — IUT 2 Grenoble
• Mobilité internationale — UQAC (Université du Québec à Chicoutimi)