Skip to content

Capturas de pantalla

Sapsan puede capturar periódicamente fotogramas JPEG de un stream: mostrar una vista previa actual en las interfaces y guardar los fotogramas en el archivo junto con el vídeo.

Configuración

Un stream puede tener varios generadores de capturas. Cada uno toma los fotogramas de una de dos fuentes:

  • http — descargar un JPEG listo por HTTP (por ejemplo, el snapshot-URL de una cámara);
  • keyframe — renderizar un fotograma de la propia pista de vídeo del stream en los fotogramas clave.
streams:
  - name: cam1
    inputs:
    - rtsp:
        url: rtsp://admin:password@10.0.0.5/stream0
    thumbnails:
    - http:
        url: http://10.0.0.5/snapshot.jpg
        fetch_interval: 10  # período de captura, s (por defecto 10)
        timeout: 5          # tiempo de espera de la petición, s (por defecto 5)
      dvr: true             # guardar los fotogramas en el archivo (por defecto false)
    - keyframe:
        track: v1           # pista de vídeo de origen
        width: 320          # por defecto 320 si no se fija ningún tamaño; mínimo 32
        height: 180
        every: 3gop         # capturar cada tercer GOP (por defecto: cada GOP)

Reglas de validación: fetch_interval, timeout y every deben ser mayores que 0; las dimensiones del fotograma deben ser de al menos 32; timeout solo se admite en http, y width/height/every solo en keyframe.

Protección contra basura: una respuesta que no es un JPEG o que supera el límite de tamaño se descarta — la vista previa no se actualiza.

Obtención de capturas

Qué URL
Fotograma actual del stream http://server/streaming/live-preview-jpeg/<stream>
Fotograma de una pista concreta http://server/streaming/track-preview-jpeg/<stream>/<track>
Fotograma del archivo http://server/streaming/dvr-preview-jpeg/<stream>/<track>/image/<ref>

Capturas en el archivo

Con dvr: true los fotogramas se escriben en el archivo como una pista JPEG aparte con las dimensiones reales del fotograma. En el manifiesto DASH del archivo se expone como un AdaptationSet estándar de thumbnail tile (http://dashif.org/guidelines/thumbnail_tile) — los reproductores con soporte de miniaturas en la línea de tiempo lo recogen automáticamente.

Siguientes pasos