arabic-software-training-video

Video de Guía de Usuario de Software en Árabe

Convierte la interfaz y documentación de una aplicación existente en un tutorial práctico que pueda revisarse y editarse. Cada instrucción debe referirse a un elemento de la interfaz real. Cada afirmación de calidad debe estar respaldada por una verificación real.

Establecer alcance y referencias

• Lee la solicitud del usuario y los archivos adjuntos antes de elegir un estilo de producción. Identifica el idioma o dialecto, la marca, los entregables y los límites para mostrar datos.
• Inspecciona el video anterior, la narración de origen, los subtítulos y el tiempo cuando estén disponibles. Distingue el guion fuente aprobado de una transcripción inferida del audio.
• Trata la aplicación actual como la autoridad para la funcionalidad, nombres de campos, botones y rutas. Usa las imágenes proporcionadas y las plantillas oficiales como referencias visuales.
• Reutiliza un proyecto de producción editable cuando esté disponible, en lugar de volver a capturar material correcto innecesariamente.
• El árabe estándar moderno es el predeterminado para material institucional en árabe. Respeta una solicitud explícita de otro dialecto; no mezcles estilos dentro de la misma versión.
• Una solicitud de producción de video no autoriza cambios en el código de la aplicación, permisos, red o datos de producción, publicación o envío de material a otras personas.

Elegir herramientas disponibles

Usa herramientas que estén realmente disponibles. No asumas que existe un servicio de voz, una clave API o una GPU.

Herramienta	Propósito
Python y un entorno virtual	Organizar y ejecutar el pipeline de producción
Playwright + Chromium	Capturar la interfaz real y probar la reproducción
Pillow	Fotogramas, títulos, capas, puntero y posiciones de enfoque
NumPy	Procesamiento de audio o música procedural original
FFmpeg, localmente o a través de imageio-ffmpeg	Movimiento, composición, codificación y procesamiento de audio
edge-tts o un proveedor autorizado	Narración y temporización de límites de palabras
arabic-reshaper y python-bidi	Remodelación de árabe de respaldo cuando RAQM no está disponible
PyAV	Duración de medios, conteo de fotogramas y verificación de clips
faster-whisper	Transcripción local opcional para revisión cuando los recursos lo permitan
openpyxl	Registros de pronunciación y revisión
HTML/Chromium o una herramienta PDF adecuada	Informe de calidad en árabe legible

Verifica la compatibilidad de Python/paquetes antes de instalar dependencias. Usa un entorno aislado y registra las versiones. Obtén las fuentes de sus fuentes oficiales y conserva las licencias.

Crear un storyboard editable

Usa datos estructurados como storyboard.json. Para cada paso, registra:

• Capítulo, título del paso, guion hablado y captura requerida.
• El elemento a resaltar y si el movimiento ilustra una captura de pantalla o registra una acción real.
• La evidencia que respalda la instrucción, cualquier período de espera y el resultado real cuando corresponda.

Escribe oraciones cortas que expliquen una acción a la vez. Mantén las etiquetas de la interfaz tal como se muestran. No leas cada palabra visible para llenar tiempo, ni omitas explicaciones necesarias para acortar el video.

Aplica diacríticos árabes parciales a palabras ambiguas, especialmente nombres de productos, nombres de organizaciones y términos técnicos. Mantén un diccionario de pronunciación editable. Los diacríticos de texto por sí solos no prueban que el habla generada se pronuncie correctamente.

Capturar la interfaz y proteger los datos

1. Captura la interfaz real a una resolución que permita un zoom legible. Usa una relación de píxeles de dispositivo apropiada en lugar de escalado por IA.
2. Guarda los rectángulos de los elementos objetivo y los desplazamientos de recorte junto con las capturas, así como las dimensiones del viewport y la relación de píxeles del dispositivo.
3. Revisa etiquetas, valores, tooltips, enlaces y la cuenta visible, no solo los campos rellenados.
4. Usa un entorno de entrenamiento o enmascaramiento documentado en la vista previa. No cambies datos de producción solo para crear una captura de pantalla segura.
5. Etiqueta la información sustituida como ejemplos. example.org y 192.0.2.10 pueden reemplazar enlaces y direcciones operativos.
6. El movimiento del puntero o el zoom sobre una captura de pantalla fija es una ilustración, no una grabación en vivo. Descríbelo con precisión.
7. Para capturar un guardado exitoso genuino, usa un entorno de prueba aislado autorizado y verifica primero el destino de escritura. Limpia los registros de prueba después. Si no está disponible, explica el procedimiento sin inventar un mensaje de éxito.

No envíes capturas de pantalla de la aplicación o datos a un proveedor de locución. Envía solo el texto explicativo general, respetando las restricciones del usuario sobre el procesamiento externo.

Locución y subtítulos en árabe

• Verifica la disponibilidad de la voz y prueba un pasaje representativo. Un identificador de voz regional no establece por sí mismo el dialecto, el árabe formal o la entrega natural.
• Conserva el texto, audio y límites de palabras aprobados para cada segmento. Regenera solo los segmentos modificados.
• Deriva las claves de caché de audio del texto, voz, velocidad y configuración de pronunciación; la mera existencia del archivo no es una clave de caché válida.
• Construye el SRT a partir del guion aprobado, conservando la puntuación, y alinea sus palabras con los límites de tiempo. No ensambles fichas de transcripción sin procesar y pierdas la puntuación.
• Documenta el tiempo estimado cuando la alineación exacta no esté disponible. No lo describas como una verificación precisa basada en escucha.
• Verifica la renderización en árabe. Prefiere la remodelación nativa con RAQM; usa reshaper/bidi solo cuando sea necesario. No remodeles ni inviertas el texto dos veces.
• Prueba la fuente con árabe, números y texto técnico mixto. Evita subconjuntos de fuentes incompletos.
• Coloca los subtítulos fuera del área de acción importante. Mantenlos legibles en tamaño de teléfono y preferiblemente dentro de una o dos líneas.

Movimiento y marca

• Extrae colores, fuentes y logotipos del proyecto real. Usa el logotipo original sin redibujarlo ni recolorearlo.
• Muestra la instrucción actual claramente en lugar de abarrotar todas las instrucciones alrededor de una pequeña captura de pantalla.
• Acerca el zoom progresivamente a la acción mientras conservas la relación de aspecto y todo el campo o botón relevante.
• Usa un puntero claro, movimiento suavizado y una breve indicación de clic donde sea útil. Alinea el clic con la instrucción hablada correspondiente.
• Mantén las transiciones tranquilas. Evita sacudidas, destellos y zooms repetidos sin propósito.
• Cuando se solicite una introducción y un final, usa la misma identidad y revela el logotipo, la organización y el título progresivamente. Duracciones como 8-12 segundos son ejemplos, no requisitos universales.
• No presentes un eslogan propuesto como un lema oficialmente aprobado.

Flechas: color, colocación y movimiento

Estos son valores predeterminados de producción recomendados, no afirmaciones sobre cada video existente. Adáptalos a la densidad de la aplicación y a la referencia del usuario, manteniendo un estilo de anotación consistente en toda una entrega.

Apariencia

• Usa rojo #D52424 para la flecha instructiva, con un contorno blanco #FFFFFF para separarla de interfaces claras y oscuras. Mantén los colores y el logotipo de la aplicación sin cambios.
• A 1920×1080, comienza con un eje de 5 píxeles, un contorno blanco de 2 píxeles, una punta de flecha de 18 píxeles y una longitud total de aproximadamente 90-160 píxeles. Escala estos valores proporcionalmente a la resolución de salida y verifica la legibilidad en tamaño de teléfono.
• Una pequeña sombra negra con aproximadamente un 18% de opacidad y 3 píxeles de desenfoque es opcional. No agregues brillo neón, efectos 3D pesados, emojis o un glifo de flecha de texto. Dibuja la anotación como una trayectoria vectorial limpia o una capa transparente de alta resolución.
• Distingue la flecha del tutorial del puntero del mouse real: la flecha explica el objetivo; el puntero indica navegación o un clic real. Evita mostrar ambos cuando oscurezcan el mismo control.

Colocación y coordenadas

• Apunta al borde del botón, campo o enlace real, dejando aproximadamente 6-12 píxeles de espacio libre a Full HD. No cubras su etiqueta, valor escrito, icono, contorno de enfoque, mensaje de validación o subtítulos.
• Prefiere una trayectoria diagonal o curva corta desde el espacio vacío cercano. Muestra una flecha instructiva por acción. Para varias acciones, revela las flechas secuencialmente en lugar de dejarlas todas en pantalla.
• Guarda un rectángulo objetivo y un ancla relativa a la captura de origen. Aplica el mismo recorte, escalado, paneo y transformación de zoom a la punta de la flecha que a la captura de pantalla. Nunca codifiques una coordenada de pantalla fija para un zoom en movimiento.
• Antes de un zoom/paneo adicional, una asignación simple de recorte y escala es screenX = offsetX + scale * (sourceX - cropX) e igualmente para Y. Aplica también cualquier transformación de animación posterior y verifica el fotograma codificado real.
• RTL/LTR afecta el diseño del texto de anotación, no la ubicación real del objetivo. No reflejes una flecha automáticamente solo porque cambie el idioma de la narración.

Tiempo y movimiento

1. Deja que la pantalla relevante se estabilice. Desvanece la flecha en aproximadamente 0.15-0.25 segundos.
2. Si el movimiento ayuda a explicar la acción, mueve la punta hacia su objetivo una vez durante aproximadamente 0.35-0.65 segundos usando movimiento suavizado. No rebotes, sacudas, gires ni repitas el movimiento continuamente.
3. Una función de suavizado útil es e = (1 - cos(pi * u)) / 2, donde u es el progreso transcurrido limitado a 0-1. Interpola la posición usando p = start + (end - start) * e. Para una trayectoria curva, evalúa la curva en el progreso suavizado y orienta la punta de la flecha a lo largo de su tangente.
4. Completa el movimiento cuando el narrador nombre el objetivo o diga "haz clic aquí". Deriva esta señal de la línea de tiempo de la narración o de un límite de palabra revisado; no apliques el mismo retraso arbitrario a cada escena.
5. Mantén la flecha quieta mientras el espectador lee el control y escucha la instrucción. Una pausa de 1-2 segundos puede ser un punto de partida, pero la instrucción hablada y la legibilidad del objetivo determinan la duración real.
6. Si se representa un clic, muestra un solo anillo sutil durante aproximadamente 0.3-0.5 segundos en el objetivo, sincronizado con la señal. Esta anotación no debe implicar que ocurrió una acción real o un guardado exitoso cuando no fue así.
7. Desvanece la flecha en aproximadamente 0.15-0.25 segundos antes de cambiar de objetivo o escena. En una versión de movimiento reducido, reemplaza el viaje/zoom con una flecha estática y un desvanecimiento suave; evita pulsaciones o destellos.

Almacena el color, las dimensiones, el rectángulo de origen, el ancla, la trayectoria, la señal, la duración de entrada, la pausa y la duración de salida en la configuración editable del storyboard/renderizado. Previsualiza la flecha al inicio, durante el zoom, en la señal y al final. Confirma que permanece adjunta al elemento correcto, dentro del fotograma y legible en ambos temas sin ocultar subtítulos o contenido de la interfaz.

Audio y música

Usa música original o con licencia apropiada, conservando su fuente o método de generación. No imites una composición protegida específica.

Normaliza la narración y evita el recorte. Si la música acompaña al habla, reduce su volumen según la señal de la narración en lugar de asumir que un nivel fijo es suficiente. Evita la reducción de ruido en el habla digital limpia cuando dañe las consonantes.

Mantén la narración, la música y la configuración de mezcla separadas para la edición. No aceleres el habla para cumplir una duración arbitraria; ajusta las escenas para que se ajusten a la explicación.

Detalles de temporización y codificación

• Mide el audio usando PCM/WAV o conteos de muestras en lugar de la duración estimada de MP3.
• Construye la línea de tiempo final a partir de las longitudes reales de los clips codificados o duraciones redondeadas a la cuadrícula de fotogramas. Incluye separadores de capítulo y entradas/salidas de audio.
• Vincula el SRT y los límites de los capítulos a la línea de tiempo final, no a una línea de tiempo anterior con desviación de redondeo acumulativa.
• Inspecciona las opciones de la versión de FFmpeg instalada. No asumas que filter_complex_script existe; pasa el gráfico de filtros directamente cuando sea apropiado.
• Escribe duraciones decimales como 0.65 en lugar de .65 para filtros que rechazan esto último.
• Usa rutas explícitas y argumentos de subproceso estructurados. No construyas comandos de shell a partir de la narración o los títulos de los capítulos.
• Invalida los cachés de renderizado cuando cambien las imágenes, los rectángulos objetivo, las fuentes, los logotipos o el código de diseño.
• Al exportar capítulos independientes, inspecciona los límites de los fotogramas clave y los inicios de audio. Verifica los archivos extraídos.

Revisión de calidad y aprobación veraz

Realiza las comprobaciones apropiadas para el material:

• Decodifica el video/audio completo y verifica resolución, velocidad de fotogramas, duración y pistas.
• Mide el volumen y los niveles máximos; verifica si hay silencios y recortes.
• Compara los subtítulos con el guion aprobado y valida el orden de tiempo y los límites finales.
• Inspecciona los fotogramas del renderizado final real, incluidos introducción, final, zooms, mensajes de validación y estados de éxito.
• Prueba la reproducción y la búsqueda en un navegador o reproductor adecuado, incluida una vista previa en tamaño de teléfono.
• Confirma que cada elemento referenciado exista, el objetivo de enfoque sea correcto y el texto importante no esté recortado.
• Valida PDF, XLSX, clips independientes y contenido del archivo cuando se solicite.

La transcripción automática no es escuchar. El ASR puede identificar pasajes que necesitan revisión, pero las discrepancias pueden ser errores de reconocimiento o diferencias ortográficas.

Registra las comprobaciones técnicas, la comparación de texto automatizada, la escucha documentada y la aprobación formal por separado. Nunca marques la escucha o la aprobación como completada a menos que haya ocurrido.

Si no está disponible la escucha directa o humana requerida, indícalo claramente. Entrega los archivos admitidos y un registro de revisión de escucha segmento por segmento; no reclames una pronunciación impecable. No informes un cambio basado en ASR como una corrección de escucha confirmada.

El registro de pronunciación debe incluir marca de tiempo, segmento, texto aprobado, transcripción o palabra marcada, corrección solicitada y estado de escucha/resolución.

Entrega

Sigue los nombres y formatos solicitados. Una entrega completa puede incluir:

• MP4 principal e introducción/final separados.
• WAV de narración, SRT en árabe y marcas de tiempo de capítulos.
• XLSX de revisión de pronunciación y PDF de informe de calidad que muestre elementos verificados y pendientes.
• Storyboard, capturas seguras, fuentes/licencias, activos de audio, código de edición e información de dependencias.
• Clips de capítulos independientes cuando sea útil.

Mantén el proyecto de edición portátil; excluye rutas de la máquina del desarrollador y credenciales de inicio de sesión. Inspecciona el paquete antes de crear un archivo. Enlaza solo los archivos que existen, y declara las limitaciones del material sin reclamar trabajo no realizado.