Снимки из ключевых кадров¶

media.process.thumbnails_keyframe

Sapsan создаёт JPEG-снимки из ключевых кадров видеодорожки стрима.

Настройка¶

streams:
  - name: cam1
    inputs:
    - rtsp:
        url: rtsp://admin:password@10.0.0.5/stream0
    thumbnails:
    - keyframe:
        track: v1           # видеодорожка-источник
        width: 320          # по умолчанию 320, если размер не задан; минимум 32
        height: 180
        every: 3gop         # снимать каждый 3-й GOP (по умолчанию — каждый GOP)
      dvr: true

every должен быть больше 0. Размеры кадра должны быть не меньше 32.

См. также: Снимки по HTTP.

Получение скриншотов¶

Что	URL
Текущий кадр потока	`http://server/streaming/live-preview-jpeg/<stream>`
Кадр конкретной дорожки	`http://server/streaming/track-preview-jpeg/<stream>/<track>`
Кадр из архива	`http://server/streaming/v/<stream>/image/<track>/<utc_ms>.jpg`

Скриншоты в архиве¶

При dvr: true кадры пишутся в архив как отдельная JPEG-дорожка с реальными размерами кадра. В DASH-манифесте архива она отдается как стандартный thumbnail tile AdaptationSet (http://dashif.org/guidelines/thumbnail_tile) — плееры с поддержкой миниатюр на таймлайне подхватывают ее автоматически.

Что дальше¶

Настроить запись архива

Превью кадров архива¶

JPEG-кадр из дорожки скриншотов: http://server/streaming/v/<stream>/image/<track>/<utc_ms>.jpg
MP4-фрагмент момента архива: http://server/streaming/dvr-preview-mp4/<stream>/<utc_ms> — короткий фрагмент от ключевого кадра; для превью сервер сам выбирает дорожку наименьшего разрешения.