Overview

Streams (short for Video streams) are designed to simplify provisioning, management, and performance monitoring of video streams.

TLDR:

• For IP Cameras that you link to your Application, Streams are automatically created and managed for you. IP Cameras typically contain one or more Streams, each with a different bitrate and configuration.
• You can also configure RTSP, HTTP, File video streams by specifying their URLs.
• Streams are also created when you deploy a Pipeline that has one or more RTSP or WebRTC nodes in it.

Note : USB cameras do not have any Streams. For details on how to use a USB camera in your pipeline, see Camera or Video Source Node.

📘

Quickstart

See Camera Setup Guide for step by step instructions to add Cameras and Streams.

Live Streams

URI (aka Live) Streams are created by specifying a RTSP or HTTP URI. Live streams are processed in real time, and Lumeo will attempt to restart any Pipeline Deployments that use Live streams if the stream goes offline or encounters an error.

Live streams are billed at a fixed price per-active-stream per-month basis.

Examples:

rtsp://user:[email protected]/videoMain
https://abc.xyz/video.m3u8

🚧

Streams must be reachable from your Gateway

If your Stream is behind a NAT or Firewall, and you are using a Gateway that's outside the firewall (for example, a Lumeo Cloud Gateway) you will need to port forward the appropriate port (554 for RTSP streams) so that the Gateway can reach the stream.

Files

File Streams are created by uploading a Video file to Lumeo or specifying the File URI. They are processed as fast as possible (ie as fast as your hardware allows) and Lumeo will not attempt to restart any Pipeline Deployments when a File stream finishes processing.

File streams are billed on the basis of the run length of the input file as measured in video-minutes.

Ex.

https://abc.xyz/media.mp4
file:///home/user/media/clip.mp4

Output (Pipeline) Streams

Pipeline Streams are output streams, created by a Stream RTSP Node or Stream WebRTC Node in a Pipeline. These streams may be used to view the output of the pipeline in a browser or as inputs to another pipeline.

• RTSP Node : This node streams the output as RTSP over the local network. This node serves the input (encoded) video stream over rtsp at : rtsp://<local-ip>:<random port>/stream-id.

• WebRTC Node : This node makes the output available as a WebRTC stream. This node serves the input (encoded) video stream over webrtc at : https://<lumeo-cloud-endpoint>/stream-id.

Using Streams in Pipelines

In order to use a URI Stream or an output RTSP stream in a Pipeline, add a Video Source Node to the Pipeline.

Viewing and Embedding Streams

RTSP Streams can be viewed with a native player such as VLC, or configured in a VMS, using the RTSP URL found on the stream's detail page.

WebRTC Streams can be viewed in the Console (on the Pipeline's Deployment detail page, or on the Stream's detail page). Instructions for embedding the stream in a webpage, or IFRAME, or sharing a publicly viewable link can be found on the Stream's detail page as well.

API Reference

See Streams API ref.