Video en línea: reglas y ejemplos

Un video en línea es una grabación alojada o incrustada externamente que se coloca dentro del flujo de lectura del artículo para demostrar, explicar o documentar una idea delimitada. Incluye una etiqueta visible, una imagen de póster deliberada, controles de reproducción, subtítulos, duración y una transcripción completa. Sin esas palabras de contexto, un reproductor sin etiqueta es invisible para todo lector que no puede o elige no ver, y está casi vacío para los sistemas que extraen texto en lugar de decodificar la grabación.

El comentario del póster pendiente es una especificación de captura, no una referencia a un recurso. El HTML circundante demuestra el orden de lectura requerido antes de que la producción multimedia esté completa.

Por qué es importante este elemento

El video reduce el costo de explicación cuando el movimiento, el tiempo, la voz o el cambio a lo largo del tiempo transmiten significado. Un lector puede ver cómo se abre un menú, cómo se mueve un producto físico o cómo un orador califica una conclusión. Ver requiere atención, sonido o subtítulos, tiempo y a menudo más datos que leer, por lo que una etiqueta clara y la duración permiten al lector evaluar ese costo.

Las imágenes de póster influyen en esa decisión antes de la reproducción. Una imagen fija representativa actúa como una promesa visual de lo que contiene la grabación. Un fotograma aleatorio con ojos cerrados, un indicador de carga o una tarjeta de título no relacionada hacen que el contenido parezca descuidado y obligan al lector a presionar reproducir para descubrir su tema. El póster debe revelar el estado, la persona, el objeto o el resultado que el video realmente explica.

La extractabilidad por máquina es la capacidad del software de recuperar el significado de una unidad de contenido sin reproducir su presentación. Un iframe desnudo normalmente expone poco más que la URL del proveedor. Un elemento etiquetado expone un título, resumen, duración, fecha, póster, subtítulos, transcripción e identificador estable. Los sistemas de búsqueda, traducción, accesibilidad y recuperación pueden entonces entender la explicación delimitada.

Por lo tanto, la transcripción es parte del elemento, no una descarga opcional. Preserva afirmaciones habladas, cambios de orador, sonidos significativos y acciones visuales en el orden del documento. Los subtítulos respaldan la experiencia de reproducción; la transcripción respalda la página. Sigue las reglas de escritura de elementos compartidas para la precedencia semántica, la sintaxis de directivas y el mapeo del cuerpo. Esta página tiene prioridad donde requiere una transcripción, póster, duración y campos de accesibilidad específicos de video.

Cuándo usarlo

Usa video en línea cuando la evidencia basada en el tiempo haga un punto delimitado más claro que las imágenes fijas y la prosa. Los casos adecuados incluyen una operación de interfaz, técnica física, transición visible, explicación de un experto, comportamiento de producto dependiente del movimiento o un resultado grabado cuya entrega sea evidencia.

Aplica una prueba de reemplazo antes de encargar la grabación. Si una captura de pantalla y dos oraciones explican el punto igual de bien, úsalas: cargan más rápido, se escanean más rápido y cuestan menos de actualizar. El video se gana su lugar cuando la secuencia, el ritmo, el movimiento, la voz o el comportamiento observado cambian la comprensión.

Los casos límite incluyen:

• Un webinar largo dentro de un párrafo no relacionado: enlaza a una página de video dedicada o usa una sección de inserción de video completa. Un elemento en línea debe servir al argumento local, no importar una hora de contenido temático adyacente.
• Una decoración silenciosa en bucle: eso es diseño de movimiento, no video editorial. Elimínalo o trátalo como contenido multimedia decorativo con comportamiento de movimiento reducido.
• Una grabación de pantalla usada en lugar de instrucciones: escribe los pasos y el estado de éxito en texto. El video puede demostrarlos, pero no puede ser la única forma de completar la tarea.
• Una cita de cliente recortada sin contexto: un clip corto puede respaldar un caso de estudio solo cuando se divulgan el orador, la relación, la fecha de grabación, la aprobación y la afirmación circundante.
• Un video cuyo único valor es la personalidad: úsalo solo cuando la voz, la entrega o la autoridad del orador sean relevantes. No hagas que los lectores vean a un presentador repetir un texto que ya está en la página.
• Varios clips similares: usa una galería o sección multimedia dedicada cuando la tarea sea seleccionar entre grabaciones. No apiles reproductores en línea.

Dónde colocarlo

Coloca el video inmediatamente después del párrafo que nombra lo que el lector aprenderá u observará. Pon su título, duración y resumen antes del reproductor. Coloca la transcripción directamente después, contraída solo cuando el texto completo permanezca en HTML sin código de reproducción.

En un procedimiento, coloca el reproductor después de la secuencia de acciones escrita y antes de la solución de problemas. El lector debe poder actuar sin ver el video y luego usar la grabación para confirmar el movimiento o el estado de la interfaz. En un argumento o caso de estudio, expresa la afirmación antes de la grabación e interpreta sus límites después.

No lo coloques junto a otro reproductor, animación de reproducción automática, gran llamada a la acción, formulario o calculadora. Los controles en competencia crean un enfoque poco claro. No lo pongas dentro de una celda de tabla, elemento de lista, nota destacada, pestaña, carrusel, panel de acordeón o tarjeta clickeable. La transcripción puede usar un control de divulgación; el video completo no debe hacerlo.

Mantén el título, resumen, póster, reproductor, duración, control de transcripción y crédito dentro de un solo límite de figura. Una nota de fuente puede ir inmediatamente después. Nunca separes el reproductor de su transcripción con un anuncio, promoción o sección no relacionada.

Anatomía

1. Título visible: Nombra la tarea, demostración, evento o afirmación en texto HTML específico.
2. Resumen: Explica en una oración qué verá el lector y por qué es importante.
3. Duración: Indica el costo visual antes de la reproducción en minutos y segundos.
4. Imagen de póster: Muestra un fotograma representativo y aprobado sin pretender ser un botón por sí mismo.
5. Controles del reproductor: Proporcionan reproducción, pausa, búsqueda, volumen, pantalla completa, velocidad de reproducción y acceso a subtítulos.
6. Subtítulos: Sincronizan el diálogo, los cambios de orador y el audio no verbal significativo con la reproducción.
7. Transcripción: Reproduce la secuencia completa y significativa como texto HTML seleccionable y buscable.
8. Descripciones visuales: Registran acciones o cambios en pantalla significativos que la narración no menciona.
9. Crédito y fuente: Identifican al orador, creador, fecha de grabación o procedencia de la evidencia cuando sea relevante.

El título no es el nombre del archivo, y el resumen no es «Mira el video a continuación». Cada uno debe seguir siendo útil cuando se copie sin el reproductor.

Ejemplos de diseño

Todas las variantes comparten el mismo contrato de contenido. La entrega cambia; el etiquetado, los subtítulos, la calidad de la transcripción, el consentimiento de reproducción y el orden de lectura no.

Demostración alojada

Usa un reproductor HTML5 de primera parte para una grabación corta de producto o proceso cuando la organización controle la codificación, los subtítulos, la selección del póster y la disponibilidad.

Inserción externa con privacidad consciente

Usa una plataforma externa cuando su entrega, analíticas o canal establecido sean necesarios. Carga al proveedor solo después del consentimiento cuando la política lo requiera, identifica al proveedor antes de la activación y conserva la transcripción local incluso si el proveedor elimina la grabación.

Clip corto de interfaz

Usa un clip conciso para un cambio de estado que sea difícil de comunicar con imágenes fijas. Aun así necesita controles, un mecanismo de pausa, una descripción textual significativa y una transcripción; no lo conviertas en un GIF en bucle automático.

Clip de entrevista o evidencia

Usa un clip con orador cuando la autoría, las palabras o el testimonio observado importen. Muestra el nombre y el rol de la persona en HTML, divulga las ediciones y transcribe tanto el habla como la evidencia visual material.

Parámetros

Estos campos forman el contrato de contenido portátil. El ancho, borde, sombra, estilo del botón de reproducción y comportamiento en puntos de ruptura pertenecen al renderizador.

El primer encabezado del cuerpo se asigna a title; el primer párrafo se asigna a summary; el resto del cuerpo se asigna a transcript. Los intervalos de tiempo de la transcripción son opcionales para una explicación continua de un solo orador y se recomiendan para procedimientos, cambios de orador y grabaciones de más de dos minutos. Los campos autoplay, loop y de audio de fondo están deliberadamente ausentes.

Sintaxis y ejemplos de código

Cada notación conserva el mismo título, resumen, metadatos multimedia, subtítulos y transcripción. Los dominios de ejemplo describen el contrato y no son referencias de recursos de producción.

Directiva Markdown portátil

:::inline-video{src="https://media.example.com/freshness-filter.mp4" provider=hosted poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language=en uploadDate="2026-08-27"}

## Filtrar páginas que necesitan revisión

Vea cómo aplicar el filtro Necesita revisión y verificar la cola de trabajo resultante.

**00:00–00:18 — Abrir el informe.** Desde Auditoría, abra Frescura.

**00:19–00:54 — Aplicar el filtro.** Abra Estado y elija Necesita revisión.

**00:55–01:30 — Verificar la cola.** Confirme que cada fila visible tenga el estado esperado.
:::

Shortcode de Hugo

{{< inline-video src="https://media.example.com/freshness-filter.mp4" provider="hosted" poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language="en" uploadDate="2026-08-27" >}}
## Filtrar páginas que necesitan revisión

Vea cómo aplicar el filtro Necesita revisión y verificar la cola de trabajo resultante.

**00:00–00:18 — Abrir el informe.** Desde Auditoría, abra Frescura.

**00:19–00:54 — Aplicar el filtro.** Abra Estado y elija Necesita revisión.

**00:55–01:30 — Verificar la cola.** Confirme que cada fila visible tenga el estado esperado.
{{< /inline-video >}}

Este es el contrato de adaptador previsto, no una afirmación de que exista un shortcode local. Usa solo parámetros con nombre. Hasta que se registre un renderizador, usa HTML semántico de figure, video, track y transcripción que conserve los mismos campos.

Bloque de WordPress

<!-- wp:amicited/inline-video {"src":"https://media.example.com/freshness-filter.mp4","provider":"hosted","poster":"https://media.example.com/freshness-filter-poster.webp","duration":"PT1M30S","captions":"https://media.example.com/freshness-filter.en.vtt","language":"en","uploadDate":"2026-08-27"} -->
<h2>Filtrar páginas que necesitan revisión</h2>
<p>Vea cómo aplicar el filtro Necesita revisión y verificar la cola de trabajo resultante.</p>
<video controls preload="metadata" poster="https://media.example.com/freshness-filter-poster.webp">
  <source src="https://media.example.com/freshness-filter.mp4" type="video/mp4">
  <track kind="captions" srclang="en" src="https://media.example.com/freshness-filter.en.vtt" label="English" default>
</video>
<details><summary>Leer la transcripción</summary><p><strong>00:00–00:18 — Abrir el informe.</strong> Desde Auditoría, abra Frescura.</p><p><strong>00:19–00:54 — Aplicar el filtro.</strong> Abra Estado y elija Necesita revisión.</p><p><strong>00:55–01:30 — Verificar la cola.</strong> Confirme que cada fila visible tenga el estado esperado.</p></details>
<!-- /wp:amicited/inline-video -->

Si el bloque registrado de WordPress no está disponible, usa los bloques nativos de Video, Encabezado, Párrafo y Detalles. No pegues un iframe y omitas la transcripción local.

Ejemplos

Bueno: una demostración delimitada con una alternativa de lectura

Filtrar páginas que necesitan revisión · 1:30

El video muestra una tarea: abrir un informe de frescura, aplicar un filtro de estado y verificar el recuento de resultados. Su póster muestra el filtro abierto, los subtítulos identifican las etiquetas de la interfaz exactamente y la transcripción en tres partes registra cada acción y verificación de éxito. La reproducción comienza solo después de la activación.

Esto funciona porque un lector puede predecir el valor y el costo de tiempo, ver con sonido, ver con subtítulos o completar la misma tarea a partir de la transcripción. La grabación añade evidencia de movimiento y cambio de estado sin convertirse en la única instrucción.

Malo: un reproductor sin etiqueta

Mira esto
Un iframe de terceros se carga automáticamente debajo del encabezado. Su póster es un fotograma negro, no aparece duración, los subtítulos son generados por el proveedor y no revisados, y la página no contiene transcripción ni resumen.

La versión mala hace que todo lector que no ve el video tenga que adivinar. No da a los extractores ningún tema, pide a los lectores preocupados por la privacidad que contacten a un proveedor antes de elegir la reproducción, no ofrece texto duradero cuando la grabación desaparece y puede presentar subtítulos incorrectos como hechos. Repáralo con un título y resumen específicos, un póster deliberado, duración, carga con consentimiento, subtítulos revisados, transcripción local completa y una tarea o afirmación escrita fuera del reproductor.

Marcado de esquema y accesibilidad

El video en línea no crea automáticamente un derecho de esquema. Usa VideoObject solo cuando la página proporcione visiblemente valores precisos de name, description, thumbnailUrl, uploadDate, duration y contentUrl o embedUrl para la grabación accesible. Nunca inventes campos para satisfacer a un validador ni marques un clip decorativo como video principal.

Un video relevante puede respaldar un Article, HowTo o Product elegible cuando la página califique de forma independiente. Su transcripción no puede justificar afirmaciones o pasos ausentes de la página visible.

La accesibilidad comienza antes de la reproducción. Etiqueta la figura, muestra el título y la duración en texto, y proporciona a los controles operación por teclado y foco visible. Nunca actives la reproducción automática. Proporciona pausa, búsqueda, volumen, velocidad, subtítulos y pantalla completa. No atrapes el foco en un reproductor de terceros; después de cerrar la pantalla completa, devuélvelo al control de inicio.

Los subtítulos deben estar sincronizados, puntuados y revisados contra la grabación. Identifica a los oradores cuando la voz no sea obvia e incluye sonidos significativos como «[tono de notificación]» cuando afecten la comprensión. La descripción de audio es necesaria cuando la información visual significativa no se declara en el audio principal; una transcripción descriptiva por sí sola no hace equivalente la experiencia de reproducción temporizada.

La transcripción debe ser HTML real en orden lógico—no canvas, contenido solo de reproducción, texto oculto ni una descarga solo en PDF. Los controles de divulgación necesitan un nombre accesible y estado expandido. El reproductor y la transcripción deben funcionar al 200% de zoom y en anchos estrechos sin desplazamiento horizontal a nivel de página.

Reglas de escritura

Las palabras alrededor del reproductor determinan si el video es un elemento de contenido o un objeto inexplicado:

• Escribe un título específico de 4 a 12 palabras. Nombra la tarea, demostración, orador, evento o hallazgo; nunca uses «Video», «Mira esto» o «Aprende más» solos.
• Escribe una oración de resumen de 15 a 35 palabras que le diga al lector qué sucede y por qué es importante. No repitas el título.
• Mantén las grabaciones en línea enfocadas y normalmente por debajo de cinco minutos. El máximo estricto es 20 minutos; las grabaciones más largas pertenecen a una página dedicada o necesitan segmentación editorial.
• Muestra la duración antes de la reproducción. Usa M:SS para el texto visible e ISO 8601, como PT1M30S, en campos estructurados.
• Elige un póster que represente el tema al tamaño de visualización normal. Evita fotogramas en blanco, indicadores de carga, expresiones accidentales, botones de reproducción engañosos, texto de interfaz diminuto e información personal o de clientes no aprobada.
• Revisa los subtítulos contra la edición final. Corrige nombres, etiquetas de producto, números, terminología del dominio, puntuación, cambios de orador y sonidos significativos.
• Transcribe todo el discurso y elementos visuales significativos. Los resúmenes, títulos de capítulos y archivos de subtítulos generados automáticamente no reemplazan la transcripción.
• Usa párrafos cortos de transcripción, etiquetas de orador donde sea necesario e intervalos de tiempo alrededor de etapas de procedimiento o cambios de tema. No fabriques citas a partir del discurso parafraseado.
• Indica las ediciones que podrían cambiar la interpretación. No edites un testimonio, experimento o demostración de modo que la secuencia implique un resultado no respaldado.
• Mantén las instrucciones esenciales, precios, advertencias, condiciones de elegibilidad, evidencia y llamadas a la acción fuera de la grabación. Un lector no debe tener que recorrer una línea de tiempo para encontrar un hecho importante.
• Nunca coloques reproducción automática, contenido intermitente, audio de fondo, superposiciones de conversión, campos de transcripción bloqueados ni un segundo reproductor dentro del elemento.
• Registra el propietario del medio y el desencadenante de revisión. Vuelve a verificar el video cuando cambien la interfaz, la política, el comportamiento del producto, la atribución del orador o la afirmación circundante.

Tipos de publicación que lo usan

La matriz postTypes en el frontmatter impulsa esta matriz. La inclusión permite el video en línea cuando la evidencia basada en el tiempo añade significado; no requiere un reproductor en cada página.

Lista de verificación de control de calidad

• El video añade un significado basado en el tiempo que una imagen fija y una prosa concisa no pueden comunicar igual de bien.
• El título visible nombra la grabación específicamente, y el resumen explica su valor antes de la reproducción.
• La duración aparece antes de que el lector active el reproductor.
• El póster es representativo, legible, aprobado y está libre de contenido privado o engañoso.
• La reproducción nunca comienza automáticamente, se repite inesperadamente ni produce sonido sin una acción del lector.
• Los controles de reproducción, pausa, búsqueda, volumen, velocidad, subtítulos y pantalla completa funcionan con teclado y pantalla táctil.
• Los subtítulos coinciden con la edición final y conservan correctamente nombres, números, cambios de orador y sonidos significativos.
• Los elementos visuales significativos no transmitidos en el habla reciben descripción de audio o una versión alternativa equivalente.
• La transcripción completa es HTML seleccionable, sigue el orden de la grabación y describe las acciones visuales necesarias.
• Las instrucciones escritas, advertencias, condiciones, evidencia y llamadas a la acción permanecen disponibles fuera del video.
• La carga del proveedor externo sigue las reglas de consentimiento aplicables, y el proveedor se identifica antes de la activación.
• El reproductor, la etiqueta y la transcripción permanecen como una sola figura semántica y no son interrumpidos por contenido no relacionado.
• El elemento no está anidado dentro de una tabla, lista, nota destacada, pestaña, carrusel, panel de acordeón o contenedor clickeable.
• La grabación y la transcripción funcionan al 200% de zoom, en anchos estrechos, con movimiento reducido y sin significado dependiente solo de JavaScript.
• Cualquier campo VideoObject coincide con metadatos multimedia visibles, verificables y la grabación accesible.
• El tipo de publicación seleccionado aparece en postTypes, y la ubicación coincide con la matriz anterior.
• El propietario del medio, los derechos, la fecha de grabación y las condiciones de revisión o reemplazo están registrados.

Preguntas frecuentes

¿Todo video en línea necesita una transcripción?

Sí. Los subtítulos sirven para la reproducción sincronizada; la transcripción sirve para la lectura, el escaneo, la búsqueda, la traducción, la citación, la accesibilidad y la extracción. Debe contener el contenido significativo completo, incluidas las acciones visuales que el habla no explica.

¿Puede la imagen de póster contener el título del video?

Sí, pero la misma información identificativa también debe aparecer en texto HTML. El texto del póster puede ser ilegible en una pantalla pequeña, no estar disponible cuando las imágenes fallan e inaccesible para el software que no interpreta píxeles.

¿Debería un video en línea reproducirse automáticamente?

No. La reproducción automática consume datos, interrumpe la lectura, introduce movimiento o sonido no solicitados y elimina la elección del lector sobre cuándo participar. Inicia solo después de una activación explícita.

¿Son los subtítulos y una transcripción lo mismo?

No. Los subtítulos están sincronizados con la reproducción e incluyen señales sonoras relevantes. Una transcripción es una alternativa de lectura duradera organizada en la secuencia de la grabación y enriquecida con las descripciones necesarias de los elementos visuales significativos.

¿Un video en línea requiere esquema VideoObject?

No. Añade VideoObject solo cuando existan metadatos visibles precisos y una grabación estable que lo respalden. Un reproductor sin un nombre, descripción, póster, fecha de carga, duración y URL de medio fiables no debe generar marcado incompleto o inventado.