Teclado IME de Kwiq
Un teclado virtual completo con sugerencias offline en 3 idiomas, diccionario local, plantillas Mustache, herramientas Markdown, emoji, flechas WASD y modo anónimo.
1 Activación
Para usar el teclado de Kwiq como tu método de entrada predeterminado:
- Abre los Ajustes de Android > Sistema > Teclado > Teclado Virtual.
- Activa "Kwiq Keyboard" en la lista de teclados disponibles.
- Selecciona "Kwiq Keyboard" como método de entrada predeterminado.
Alternativamente, en los Ajustes de Kwiq, ve a "Teclado" y toca "Activar Teclado". Esto abre directamente los ajustes de teclado de Android.
2 Idiomas Soportados
El teclado soporta 3 idiomas con diccionarios offline completos:
Portugués (PT)
Locale pt_BR. Layout QWERTY con acentos y ç. Diccionario con palabras en portugués brasileño.
English (EN)
Locale en_US. Layout QWERTY estándar americano. Diccionario con palabras en inglés.
Español (ES)
Locale es_ES. Layout QWERTY con ñ. Diccionario con palabras en español.
Cambio de idioma: toca el botón de idioma en la barra espaciadora para alternar rápidamente entre PT, EN y ES. El orden de cambio es PT → EN → ES → PT.
El idioma también se puede cambiar mediante el InputMethodSubtype del sistema, si está configurado.
3 Diccionario Offline
Kwiq tiene un sistema de diccionario offline completo, basado en Room Database:
- BundledDictionaryStore: diccionarios incluidos en los assets de la app, cargados en una estructura
DictionaryTrie(un trie para búsquedas eficientes de prefijos). - KeyboardDictionaryDatabase: base de datos Room con tablas
words(palabras),bigrams(pares de palabras) ylearning_history(historial de aprendizaje). - DictionaryTextNormalizer: elimina acentos y normaliza el texto para búsquedas consistentes.
- DictionaryLocaleMapper: normaliza etiquetas de locale (pt_BR, pt-PT, en_US, es_ES).
El diccionario aprende palabras nuevas que escribes y sugiere en base a tu historial de uso local, todo en el dispositivo, sin enviar datos a servidores.
Gestión del Diccionario
Kwiq ofrece broadcasts para gestionar el diccionario de forma programática:
ActionClearLearning— borra todo el historial de aprendizaje.ActionAddWord— añade una palabra al diccionario.ActionRemoveWord— elimina una palabra del diccionario.
4 Sugerencias y Autocorrección
El motor de sugerencias (KeyboardSuggestionEngine) ofrece:
- Coincidencias de bigramas: sugiere la siguiente palabra según el historial de pares de palabras (ej.: después de "buenos", sugiere "días").
- Coincidencias de prefijo: palabras del diccionario que empiezan con lo que has escrito.
- Corrección difusa: usa la distancia de Levenshtein para corregir palabras de 3+ caracteres que no están en el diccionario.
- Autocorrección: corrige automáticamente palabras que no están en el diccionario (se puede desactivar en los ajustes).
- Rechazo inteligente: deshacer una autocorrección con retroceso impide que la misma corrección se vuelva a aplicar, incluso si presionas espacio justo después. El teclado respeta tu elección.
Las sugerencias aparecen en una barra sobre el teclado. Toca una sugerencia para aceptarla.
5 Diseños y Páginas
El teclado tiene 18 páginas de teclas, organizadas en categorías:
| Página | Contenido |
|---|---|
| Letters | Letras del alfabeto en layout QWERTY + fila numérica. PT tiene ç, ES tiene ñ. |
| Numbers | Dígitos, símbolos comunes, paréntesis, operadores. |
| Math | Símbolos matemáticos: ±, ×, ÷, √, ∞, etc. |
| Currency | Monedas: $, €, £, ¥, ¢, R$, etc. |
| Arrows | Flechas: ←, ↑, →, ↓, ↔, ⇐, ⇒, etc. |
| Shapes | Formas geométricas: rombos, círculos, cuadrados, estrellas. |
| Cards | Palos de cartas: picas, corazones, diamantes, tréboles. |
| Greek | Alfabeto griego: α, β, γ, Δ, etc. |
| Technical | Símbolos técnicos: ©, ®, ™, §, ¶, etc. |
| Smileys | Emoticonos y smileys: ∼), :D, ;), etc. |
| People | Emoji de personas con soporte de tono de piel. |
| Nature | Animales, plantas, fenómenos naturales. |
| Food | Comidas y bebidas. |
| Travel | Transporte, lugares, banderas. |
| Activities | Deportes, actividades, objetos. |
| Objects | Objetos diversos, herramientas, tecnología. |
| Hearts | Corazones y símbolos de afecto. |
| Flags | Banderas de países. |
El teclado se adapta automáticamente al tipo de campo: texto, número, decimal o teléfono (ImeKeyboardKind).
6 Variantes de Teclas (Pulsación Larga)
Cada tecla tiene variantes accesibles mediante pulsación larga. Por ejemplo:
El tiempo de respuesta de la pulsación larga se puede ajustar en los ajustes del teclado (corto, medio, largo).
Los emoji de manos y personas también tienen variantes con tonos de piel.
7 Emoji
El teclado tiene 9 páginas de emoji con categorías completas: Smileys, People, Nature, Food, Travel, Activities, Objects, Hearts y Flags.
- Cada página se puede acceder desde el selector de páginas junto a la barra espaciadora. Navega entre ellas deslizando horizontalmente o tocando los iconos de categoría.
- Los emoji se insertan directamente en el campo de texto como caracteres Unicode.
8 Herramientas Markdown
Una barra de herramientas Markdown está disponible sobre el teclado (configurable) para facilitar el formato de texto:
Wrap (Envolver)
Selecciona el texto escrito y lo envuelve en formato:
Prefix (Prefijo)
Inserta prefijos de formato al inicio de la línea:
Link
Abre un diálogo para insertar un enlace formateado: [texto](url).
La barra de herramientas Markdown se puede activar o desactivar en los ajustes del teclado.
9 Flechas, WASD y Analógico
El teclado ofrece 3 modos de navegación con flechas:
Above Keyboard
Las flechas direccionales (← ↑ ↓ →) aparecen ENCIMA del teclado. Ideal para editar texto.
Below Keyboard
Las flechas direccionales aparecen DEBAJO del teclado, cerca de la barra espaciadora.
Hidden
Flechas ocultas. Usa gestos o atajos para navegar.
Modo WASD
Cuando está activado, las teclas W, A, S, D funcionan como flechas direccionales. Esto es especialmente útil para:
- Juegos basados en texto o Termux.
- Navegación en editores de texto.
- Uso con teclado físico en modo escritorio.
Analog Stick
Soporte para joystick analógico para navegación. Cuando hay un mando con analógico conectado, puedes usarlo para navegar por el texto o la interfaz.
10 Plantillas Mustache
Kwiq tiene un sistema de plantillas Mustache para pegar texto rápidamente con campos personalizables.
¿Qué son?
Las plantillas Mustache son textos con marcadores en el formato {{ nombre_del_campo }}. Al pegar una plantilla, el teclado muestra un formulario para completar los campos antes de insertar el texto final.
Ejemplo
Plantilla:
Al pegarla, el teclado muestra campos para completar: Nombre, Asunto, Plazo. Tras completarlos, el texto se renderiza con los valores sustituidos.
Cómo crear plantillas
- Crea una nota Markdown en el Gestor de Archivos de Kwiq con el texto deseado y marcadores
{{ campo }}. - Fija la nota en la pantalla de inicio (aparecerá como una tarjeta).
- En el teclado, la nota aparecerá en la lista de plantillas disponibles (accesibles desde el icono de nota en la barra de herramientas).
Acciones al pegar
- Cancel: descarta la plantilla.
- Paste Normal: pega el texto con los marcadores sustituidos por los valores completados.
- Paste Special: pega el texto con renderizado personalizado (cuando aplica).
11 Modo Anónimo
El modo anónimo (private mode) es una opción de privacidad que, al activarse:
- No aprende nuevas palabras escritas.
- No envía datos de escritura a ningún lugar (el teclado ya no los envía, pero el modo anónimo también desactiva el aprendizaje local).
- No sugiere palabras basadas en tu historial reciente.
- Indicador visual: la interfaz del teclado cambia ligeramente para indicar que el modo anónimo está activo.
Para activarlo o desactivarlo, ve a los Ajustes de Kwiq > Teclado > "Modo Anónimo".
12 Personalización
El teclado ofrece varias opciones de personalización:
Vibración (Haptic)
Retroalimentación táctil en cada tecla. Se puede activar o desactivar. Usa HapticFeedbackConstants de Android.
Color de las Teclas
Tiñe las teclas con un color personalizado. La opción keyTintEnabled activa o desactiva el efecto.
Tiempo de Pulsación Larga
Ajusta el tiempo necesario para activar las variantes de tecla: Corto, Medio o Largo.
Barras de Herramientas
Activa o desactiva la barra de herramientas Markdown y la barra de flechas de forma independiente.
Todas las opciones están disponibles en: Ajustes de Kwiq > Teclado.
13 Integración con Asistentes de IA
El teclado de Kwiq se integra con asistentes de IA para ofrecer sugerencias contextuales avanzadas:
- Asistentes soportados: ChatGPT, Google Gemini, GitHub Copilot.
- Cómo funciona: cuando un asistente de IA está disponible en el dispositivo, el teclado puede enviar el texto escrito para obtener sugerencias contextuales.
- Integración: vía
KwiqAssistantContract, que usaIntent.ACTION_ASSISTpara abrir el asistente configurado.
Para configurarlo, ve a los Ajustes de Kwiq > "Asistente" y elige qué app de IA usar.
14 Consejos y Atajos
Smart Space
El teclado inserta un espacio automáticamente después de la puntuación (cuando está configurado).
Caps Lock
Mantén pulsado Shift para activar Caps Lock. Pulsa de nuevo para desactivarlo.
Plantillas de Notas
Las notas Markdown fijadas en Home se pueden usar como plantillas de pegado en el teclado. Crea notas con {{ campo }} para plantillas Mustache.
Carpetas de Notas
Las notas fijadas se gestionan desde el Gestor de Archivos. Crea, edita y elimina notas allí — aparecen automáticamente en el teclado.