KeyMod ▾

№ 12. Устранение неполадок

Распространенные проблемы и решения для приложения KeyMod на Android.

Проблемы с подключением

Не подключено

Симптом Решение
Индикатор «Не подключено» Проверьте подключение кабеля; попробуйте переподключить. Для BLE выключите/включите Bluetooth и выполните повторное сопряжение.
USB разрешение отклонено Перейдите в Android Настройки → Приложения → KeyMod → Разрешения → включите USB. Повторно подключите кабель.
Bluetooth не подключается Включите/выключите Bluetooth. Забудьте устройство в настройках Bluetooth и выполните повторное сопряжение. Убедитесь, что устройство KeyMod находится в режиме сопряжения.
Соединение часто обрывается Проверьте значение RSSI ниже BLE button в приложении. Ниже -75 дБм указывает на слабый сигнал — подойдите ближе. Устраните физические препятствия.

Индикаторы состояния соединения

Индикатор Значение
Подключено Зеленый значок — готов к отправке ввода
Подключение Желтый значок — соединение выполняется
Отключено Серый значок — нет активного соединения
Сигнальные полосы BLE уровень сигнала или USB активное состояние

Автоподключение

Включите "Автоматическое подключение при запуске" в диалоговом окне подключения. KeyMod запоминает ваш последний тип подключения (USB или BLE) и последнее сопряженное устройство BLE.

USB Обнаружение присоединения/отсоединения

KeyMod отслеживает трансляционные события USB присоединения/отключения Android. Если вы отсоедините кабель USB, статус подключения обновится немедленно. Повторное подключение вызывает попытку повторного подключения, если включено автоматическое подключение.

Проблемы с клавиатурой

Ключи не регистрируются

Симптом Решение
Ключи не отправляются Убедитесь, что соединение показывает «Подключено» (зеленый). Попробуйте переключить режимы и обратно. Убедитесь, что целевой компьютер распознает устройство KeyMod как клавиатуру.
Макрос не выполняется Убедитесь, что вы подключены. Убедитесь, что данные макроса содержат действительные токены (в именах токенов нет опечаток).
Неправильные символы Проверьте настройку Целевая ОС: несоответствующая ОС может вызвать проблемы с сопоставлением клавиш. Проверьте раскладку клавиатуры целевого компьютера (QWERTY или AZERTY).

Символы Юникода не работают

Для символов, отличных от ASCII (китайский, японский, эмодзи), требуются методы ввода, специфичные для ОС:

ОС Метод
Windows Alt+NumPad шестнадцатеричный ввод Юникода
Linux Ctrl+Shift+U, за которым следует шестнадцатеричный код
macOS Option+шестнадцатеричный ввод

Если символы Юникода отображаются неправильно, убедитесь, что Целевая ОС установлена ​​правильно.

TouchPad Проблемы

Симптом Решение
Touchpad не отвечает Убедитесь, что в настройках включена тактильная обратная связь. Попробуйте наложение справки TouchPad (?), чтобы убедиться в поддержке жестов.
Прокрутка не работает Проверьте чувствительность прокрутки touchpad в меню «Настройки» → «Основные».

Проблемы с голосовым вводом

Распознаватель речи недоступен

Установите Google Голосовой ввод из Play Store. На Android 11+ KeyMod требуется разрешение на запросы (включено в APK).

Обнаружение тишины не работает

Симптом Решение
Запись продолжается, даже если вы не говорите Проверьте переключатель «Автопауза при тишине». Уменьшите фоновый шум. Говорите четко и близко к микрофону.
Запись немедленно прекращается Говорите громче или уменьшите время ожидания обнаружения тишины.

Голосовой текст не отправляется

Проверьте состояние соединения. Функция «Отправить» button отключена, если она не подключена.

Проблемы с ИИ

API-ключ не работает

Симптом Решение
"Ключ API не настроен" Убедитесь, что ключ API верен — проверьте наличие лишних пробелов и опечаток. Проверьте базовый URL-адрес API — он должен включать полный путь (например, https://api.openai.com/v1). Убедитесь, что имя модели существует у поставщика. Для местных поставщиков (Ollama) убедитесь, что установлен флаг «Необязательный ключ API».

Уточнение текста медленно

Проверьте сетевое соединение. Попробуйте более быструю модель — модели меньшего размера (gpt-3.5-turbo, llama3-8b) реагируют быстрее. Используйте местного провайдера (Ollama), чтобы устранить задержку в сети. Проверьте историю запросов AI на наличие сообщений об ошибках.

Нужна дополнительная помощь?

Если у вас все еще возникают проблемы: