Previews del canal¶
La lista de canales en la app de un operador, la EPG y una pared de monitoreo necesitan imágenes: qué hay al aire ahora mismo. Para eso están los previews del canal — el streamer genera regularmente un cuadro JPEG y lo sirve en una dirección estable. Se configura en el bloque Miniaturas de la pestaña Proceso.
Configure un preview¶
Pulse + Añadir miniatura y elija la Fuente:
- Cuadro clave del stream — el streamer genera JPEGs de los cuadros clave del canal. Campos: Pista (la pista de video, normalmente
v1), Ancho y Alto (basta uno — el otro sigue las proporciones; el ancho por defecto es 320), Cada — con qué frecuencia, en GOPs (gop— cada uno,2gop— uno sí y uno no). - Descarga HTTP — el streamer no genera nada: descarga periódicamente una imagen ya hecha desde la URL de descarga HTTP — práctico con cámaras IP que sirven un snapshot.
El interruptor Guardar miniaturas en el DVR escribe además las miniaturas en el archivo — junto con la grabación del canal aparece su cinta visual.
Un canal puede llevar hasta diez pistas de preview — una pequeña para la lista y una mayor para la ficha del canal, por ejemplo.
![]()
Tome la imagen¶
El cuadro fresco del canal se sirve en:
/streaming/live-preview-jpeg/<nombre-del-canal>
La respuesta es un JPEG normal; una interfaz cliente simplemente lo vuelve a pedir con la cadencia que necesite:
![]()
Mientras el canal no tiene previews configurados, la dirección responde 404 — las miniaturas no se generan solas, son un trabajo que hay que activar.
Si no hay imagen¶
- 404. Los previews no están configurados, el canal no está al aire, o el primer cuadro clave aún no llegó — con
Cada: 2gopy un GOP largo el primer cuadro puede tardar decenas de segundos. - Hay imagen pero se congeló. La fuente del preview es una descarga HTTP y la cámara sirve un snapshot cacheado; compruebe la URL de la cámara directamente.
- La pista no se encuentra. El campo Pista debe nombrar una pista de video existente del canal — mire su identificador en la tarjeta de salud de la fuente (normalmente
v1).