KeyMod ▾

12. Dépannage

Problèmes courants et solutions pour l'application KeyMod sur Android.

Problèmes de connexion

Non connecté

Symptôme Solutions
Indicateur « Non connecté » Vérifiez la connexion du câble ; essayez de rebrancher. Pour BLE, activez/désactivez Bluetooth et ré-appairez.
USB autorisation refusée Accédez à Android Paramètres → Applications → KeyMod → Autorisations → activez USB. Rebranchez le câble.
Le Bluetooth ne s'associe pas Activez/désactivez Bluetooth. Oubliez l'appareil dans les paramètres Bluetooth et ré-appairez. Assurez-vous que l'appareil KeyMod est en mode d'appairage.
La connexion est interrompue fréquemment Vérifiez la valeur RSSI sous la valeur BLE button dans l'application. En dessous de -75 dBm indique un signal faible – rapprochez-vous. Supprimez les obstacles physiques.

Indicateurs d'état de connexion

Indicateur Signification
Connecté Icône verte — prêt à envoyer une entrée
Connexion Icône orange — connexion en cours
Déconnecté Icône grise — aucune connexion active
Barres de signal BLE force du signal ou USB état actif

Connexion automatique

Activez "Connexion automatique au démarrage" dans la boîte de dialogue de connexion. KeyMod mémorise votre dernier type de connexion (USB ou BLE) et le dernier appareil BLE couplé.

USB Détection d'attache/détachement

KeyMod surveille les événements de diffusion d'attache/détachement USB de Android. Si vous débranchez le câble USB, l'état de la connexion est immédiatement mis à jour. Le rebranchement déclenche une tentative de reconnexion si la connexion automatique est activée.


Problèmes de clavier

Les clés ne s'enregistrent pas

Symptôme Solutions
Les clés ne sont pas envoyées Vérifiez que la connexion affiche « Connecté » (vert). Essayez de changer de mode et inversement. Vérifiez que l'ordinateur cible reconnaît l'appareil KeyMod comme clavier.
La macro ne s'exécute pas Vérifiez que vous êtes connecté. Vérifiez que les données de la macro contiennent des jetons valides (pas de fautes de frappe dans les noms de jetons).
Mauvais caractères apparaissant Vérifiez le paramètre Target OS : un système d'exploitation incompatible peut entraîner des problèmes de mappage de clés. Vérifiez la disposition du clavier de l'ordinateur cible (QWERTY vs AZERTY).

Les caractères Unicode ne fonctionnent pas

Les caractères non-ASCII (chinois, japonais, emoji) nécessitent des méthodes de saisie spécifiques au système d'exploitation :

Système d'exploitation Méthode
Windows Alt+Entrée Unicode hexadécimale du pavé numérique
Linux Ctrl+Shift+U suivi du code hexadécimal
macOS Option+entrée hexadécimale

Si les caractères Unicode n'apparaissent pas correctement, vérifiez que le système d'exploitation cible est correctement défini.


TouchPad Problèmes

Symptôme Solutions
Touchpad ne répond pas Vérifiez que le retour haptique est activé dans les paramètres. Essayez la superposition d'aide TouchPad (?) pour vérifier la prise en charge des gestes.
Le défilement ne fonctionne pas Vérifiez la sensibilité du défilement touchpad dans Paramètres → Général.

Problèmes de saisie vocale

Reconnaissance vocale indisponible

Installez Google Saisie vocale depuis Play Store. Sur Android 11+, KeyMod a besoin de l'autorisation de requêtes (incluse dans le APK).

La détection des silences ne fonctionne pas

Symptôme Solutions
L'enregistrement continue lorsque vous ne parlez pas Cochez la case Pause automatique en cas de silence. Réduisez le bruit de fond. Parlez clairement et près du microphone.
L'enregistrement s'arrête immédiatement Parlez plus fort ou réduisez le délai de détection du silence.

Le texte vocal n'est pas envoyé

Vérifiez l'état de la connexion. Le "Envoyer" button est désactivé lorsqu'il n'est pas connecté.


Problèmes d'IA

La clé API ne fonctionne pas

Symptôme Solutions
"Clé API non configurée" Vérifiez que la clé API est correcte : vérifiez les espaces supplémentaires ou les fautes de frappe. Vérifiez l'URL de base de l'API : elle doit inclure le chemin d'accès complet (par exemple, https://api.openai.com/v1). Vérifiez que le nom du modèle existe sur le fournisseur. Pour les fournisseurs locaux (Ollama), assurez-vous que l’indicateur API Key Facultatif est défini.

Affinement du texte lent

Vérifiez votre connexion réseau. Essayez un modèle plus rapide : les modèles plus petits (gpt-3.5-turbo, llama3-8b) répondent plus rapidement. Utilisez un fournisseur local (Ollama) pour éliminer la latence du réseau. Vérifiez l’historique des demandes AI pour les messages d’erreur.


Besoin d'aide supplémentaire ?

Si vous rencontrez toujours des problèmes :