Implementación
Requisitos técnicos y de red
Navegadores, dispositivos, micrófono, ancho de banda y dominios que el área de TI debe permitir para usar LingoQuesto.
Resumen
LingoQuesto es una aplicación web. No hay nada que instalar en los equipos: no existe aplicación de escritorio ni aplicación nativa para teléfonos.
Para usarla hacen falta cuatro cosas:
- un navegador vigente;
- micrófono y salida de audio;
- una conexión que permita HTTPS y WebSocket por el puerto 443;
- acceso a los dominios que se listan en este documento.
Navegadores y dispositivos
| Plataforma | Compatibilidad |
|---|---|
| Chrome y Edge en escritorio | Compatibles. Son el entorno de referencia. |
| Firefox en escritorio | Compatible. |
| Safari en macOS | Compatible. |
| iPad | Compatible, para docentes y estudiantes. |
| Teléfonos | La interfaz se adapta y se puede practicar desde el teléfono. Recomendamos probarlo con los equipos de la institución antes de un uso masivo. |
| Internet Explorer | No compatible. |
Se da soporte a las versiones vigentes de cada navegador, es decir, las que su fabricante mantiene con actualizaciones de seguridad. No se usan complementos ni extensiones.
En cuanto al equipo, basta con cualquiera que ejecute bien uno de esos navegadores y tenga micrófono y salida de audio. La cámara no se usa: la plataforma la deja deshabilitada de forma explícita.
Micrófono y audio
La práctica es oral, así que el micrófono es el requisito que más conviene verificar antes de la primera clase.
- Permiso del navegador. La primera vez que el estudiante graba, el navegador le pide permiso para usar el micrófono y debe aceptarlo.
- Equipos administrados. En laboratorios y equipos con políticas de grupo es habitual que el micrófono esté bloqueado. Se debe autorizar para
app.lingoquesto.com. - Micrófono. Sirve cualquiera que el sistema operativo reconozca: el integrado del equipo, uno USB o el de unos audífonos.
- Audífonos. En salones donde varias personas practican a la vez recomendamos audífonos con micrófono, para que no se mezclen las voces ni el audio del tutor.
- Dentro de un LMS. Si la plataforma se abre incrustada en el LMS, el navegador solo entrega el micrófono cuando el LMS lo autoriza. La configuración recomendada es que el enlace abra LingoQuesto en una pestaña nueva.
Red
Todo el tráfico va cifrado por el puerto 443.
- WebSocket. La conversación usa una conexión WebSocket. El proxy o el filtro de contenido no debe bloquearla ni cerrarla por inactividad.
- Subida. El audio se comprime en el dispositivo antes de enviarse y ocupa cerca de 1 MB por minuto grabado. Un salón con 30 estudiantes practicando a la vez necesita del orden de 4 Mbps de subida sostenidos, además de la navegación normal.
En redes institucionales el límite suele estar en la subida y no en la bajada. Es la cifra que conviene confirmar con el proveedor de internet.
Dominios que se deben permitir
Estos son los dominios que contacta el navegador de un docente o de un estudiante.
Imprescindibles
| Dominio | Para qué |
|---|---|
app.lingoquesto.com |
La aplicación |
api-base.lingoquesto.com |
API e inicio de sesión |
realtime.lingoquesto.com |
Tiempo real de la conversación (WebSocket) |
nyc3.digitaloceanspaces.comlq-storage-prod.nyc3.digitaloceanspaces.comlq-storage-prod.nyc3.cdn.digitaloceanspaces.com |
Subida y reproducción de audios e imágenes |
fonts.googleapis.comfonts.gstatic.com |
Tipografías |
accounts.google.comlogin.microsoftonline.com |
Inicio de sesión con Google o Microsoft, si se usa |
Si el filtro admite comodines, *.digitaloceanspaces.com cubre los tres dominios de almacenamiento.
Recomendados
Sin ellos la plataforma funciona, pero se ve incompleta.
| Dominio | Para qué |
|---|---|
api.iconify.design |
Algunos iconos |
api.dicebear.com |
Avatar del tutor en la conversación |
images.unsplash.comimages.pexels.com |
Portadas de actividades y cursos |
client.crisp.chat*.crisp.chat |
Chat de soporte |
Según la integración
| Dominio | Cuándo |
|---|---|
lti.lingoquesto.com |
Si la institución entra desde su LMS por LTI |
No hace falta permitir ningún proveedor de inteligencia artificial. El navegador nunca se conecta con ellos: toda la comunicación pasa por los servidores de LingoQuesto.
Lista de verificación para TI
- Los dominios imprescindibles están permitidos en el firewall y en el filtro de contenido.
- El proxy no bloquea ni cierra las conexiones WebSocket por el puerto 443.
- El micrófono está autorizado para
app.lingoquesto.comen los equipos administrados. - Los equipos del laboratorio tienen un navegador vigente.
- El ancho de banda de subida alcanza para el número de estudiantes que practican a la vez.
- Una persona hizo una práctica completa desde un equipo y una red de la institución antes de la primera clase.