openccb/docs/AUDIO_GUIDE_FOR_INSTRUCTORS.md

🎤 Guía de Audio para Preguntas

¿Por qué agregar audio?

El audio en las preguntas ayuda a:

• ✅ Estudiantes con diferentes estilos de aprendizaje
• ✅ Práctica de listening comprehension
• ✅ Accesibilidad para estudiantes con dificultades visuales
• ✅ Pronunciación correcta en idiomas

📱 Cómo Grabar Audio

Opción 1: Con tu Celular (Recomendado)

1. Abre la app de grabadora en tu celular
2. Graba la pregunta en un lugar silencioso
3. Envía el archivo a tu computadora (email, WhatsApp, cable USB)

Consejos:

• Habla claro y a velocidad normal
• Evita ruido de fondo
• Grabación corta: 5-30 segundos ideal

Opción 2: Con tu Computadora

Windows:

• Usa "Grabadora de voz" (incluida en Windows)
• O usa Online Voice Recorder

Mac:

• Usa QuickTime Player → Archivo → Nueva grabación de audio
• O usa GarageBand

Linux:

• Usa Audacity: sudo apt install audacity
• O usa GNOME Sound Recorder

Opción 3: Usando el Editor de Preguntas

1. Ve a /question-bank en Studio
2. Crea o edita una pregunta
3. En la sección "Audio de la Pregunta":
   • Click en "Subir archivo de audio"
   • Selecciona tu archivo MP3/WAV/OGG
   • Preview del audio
   • Guarda la pregunta

📊 Formatos Soportados

Formato	Tamaño Máx	Calidad Recomendada
MP3	10 MB	128 kbps
WAV	10 MB	44.1 kHz, 16-bit
OGG	10 MB	128 kbps

💡 Mejores Prácticas

Para Preguntas de Listening

📝 Texto: "What color is the sky?"
🎤 Audio: [Grabación clara: "What color is the sky?"]

Para Preguntas de Pronunciación

📝 Texto: "Repeat: The quick brown fox"
🎤 Audio: [Pronunciación modelo]

Para Instrucciones

📝 Texto: "Listen and choose the correct answer"
🎤 Audio: [Instrucción en inglés]

🚫 Errores Comunes a Evitar

• ❌ Audio muy largo (> 1 minuto)
• ❌ Ruido de fondo (tráfico, ventilador, etc.)
• ❌ Volumen muy bajo o muy alto
• ❌ Hablar muy rápido
• ❌ Múltiples personas hablando

✅ Checklist de Calidad

Antes de subir tu audio:

• Se escucha claro y sin ruido
• Duración apropiada (< 1 min)
• Volumen consistente
• Pronunciación correcta
• Formato MP3/WAV/OGG
• Tamaño < 10MB

📈 Ejemplo de Flujo de Trabajo

1. Preparación

1. Abre tu banco de preguntas en Studio
2. Ten lista la lista de preguntas
3. Prepara tu celular o micrófono

2. Grabación

1. Graba cada pregunta por separado
2. Nombra los archivos claramente:
   - pregunta_001.mp3
   - pregunta_002.mp3
   - etc.

3. Subida

1. Ve a cada pregunta en Studio
2. Sube el archivo de audio correspondiente
3. Preview para verificar
4. Guarda

🎯 Casos de Uso por Habilidad

📖 Reading

• Audio de la pregunta para estudiantes con dificultades visuales
• Narración de pasajes cortos

🎧 Listening

• Diálogos para comprensión auditiva
• Instrucciones en el idioma objetivo

🗣️ Speaking

• Modelos de pronunciación
• Ejemplos de conversación

✍️ Writing

• Dictados
• Instrucciones de escritura

🔧 Solución de Problemas

"El audio no se reproduce"

• Verifica el formato (MP3/WAV/OGG)
• Verifica el tamaño (< 10MB)
• Intenta subir de nuevo

"El audio se escucha mal"

• Re-graba en un lugar más silencioso
• Usa un micrófono externo si es posible
• Ajusta el volumen de grabación

"El archivo es muy grande"

• Comprime a MP3 con menor bitrate (128 kbps)
• Corta silencios al inicio/final
• Usa formato OGG (mejor compresión)

📞 Soporte

¿Problemas con el audio?

• Revisa esta guía completa
• Contacta al administrador del sistema
• Revisa los logs del servidor

---

Recuerda: El audio es OPCIONAL pero MUY VALIOSO para la experiencia de aprendizaje.