Download PDF

Ensemble Video works with “RTSP Pull” streaming and Wowza Media Engine.

RTSP Pull streaming is used by Axis Network Cameras. Axis cameras are used most often for security monitoring, but they offer some low cost cameras with HD quality, and they are now being increasingly used in a variety of other areas such as classroom video capture, streaming sporting events, and student or employee assessment.

We tested RTSP Pull streaming with one of the cameras from the Axis M10 Network Camera Series. There are a variety of other RTSP Pull streaming cameras and devices that also may work with RTSP Pull streaming and Ensemble Video/Wowza.

You can use RTSP Pull Streaming with Ensemble Video Live Stream or Live Capture items:

  • With a Live Stream item, you will set the stream up to stream continuously, and then you can view and record the stream at any time.
  • With Live Capture, you will set up the stream so it can be started by a viewer, and once the stream is started the stream will be recorded so long as there are viewers. When there are no viewers, the stream and the recording will stop.
RTSP Pull – with Ensemble Video Live Stream
1. Add RTSP Pull Live Stream in Ensemble Video

For the Library where you want to use RTSP Pull for Live Stream, edit the Live Stream Media Workflow and select RTSP Pull from the Encoding Method dropdown, and save the Workflow.

Next, create a new Live Stream item, by clicking on  in the Live Streaming tab. This will generate new Live Stream entry, and in the Manage Stream are of the Add/Edit Wizard, you will see that a .stream file is referenced in the Stream Name field (e.g., in the screen shot below it is DBRF9UD0.stream). Note this file name, you will need to create the .stream file using the Wowza Admin interface.

2. Configure your Camera and Create the .stream File on Wowza Media Engine

Configure your camera so that it streams an H.264 video with AAC audio, at a reasonable bit rate (e.g., in the range of 500 Kbps to 1800 Kbs). We recommend you test the camera stream directly to a standalone player, such as the VLC player, to verify the stream is working properly.

Log into your Wowza Admin interface, select the Live Stream application, select Stream Files, and then click on +Add Stream File. Enter the URI to your camera stream.

Once you’ve added the .stream file, you can click on the button to connect to the stream . That will start the stream, and you can then view the stream in Ensemble. You should also add the stream to the Startup streams so that the stream runs constantly, and you can record view and record your stream at any time.

3. View and Record your stream

Once you’ve started the stream it will stream continuously, so viewers can access it at any time, and in the Live Stream tab you will be able to start and stop recording whenever you want to.

RTSP Pull – with Ensemble Video Live Capture

1. Add RTSP Pull Live Capture in Ensemble Video

For the Library where you want to use RTSP Pull for Live Capture, edit the Live Capture Media Workflow and select RTSP Pull from the Encoding Method dropdown, and save the Workflow.

Next, create a new Live Capture item, by clicking on in the Live Streaming tab. This will generate new Live Capture entry, and in the Manage Stream form of the Add/Edit Wizard, you will see that a .stream file is referenced in the Stream Name field (e.g., in the screen shot below it is ZZNF9RJP.stream). Note this file name, you will need to create the .stream file using the Wowza Admin interface.

2. Configure the Live Capture Wowza Application for RTP Recording

You will need to make a one-time change to the Live Capture Wowza application for RTSP Pull streaming to work with Live Capture items in Ensemble Video.

Open the Application.XML file in the Wowza /conf folder for your Live Capture application (typically something like C:\Program Files (x86)\Wowza Media Systems\Wowza Streaming Engine 4.0.5\conf\EVLiveCapture) and change the <StreamType> to “rtp-live-record”.

3. Configure Your Camera and Create the .stream File on Wowza Media Engine

Configure your camera so that it streams an H.264 video with AAC audio, at a reasonable bit rate (e.g., in the range of 500 Kbps to 1800 Kbs). We recommend you test the camera stream directly to a standalone player, such as the VLC player, to verify the stream is working properly.

Log into your Wowza Admin interface, select the Live Stream application, select Stream Files, and then click on +Add Stream File. Enter the URI to your camera stream.

Once you’ve added the .stream file, you can test the stream item in Ensemble Video. Just click to view the video using a desktop browser using Chrome, Firefox or IE (you must use a desktop browser, not a mobile device, and do not use Safari on a Mac). The item player will indicate the item is Off Air.  But by clicking the player on your desktop, you are requesting an RTMP stream and that “pulls” the stream from the camera to start it.

 4. View and Record your stream

Anyone can start the stream by simply clicking on the player form a desktop browser (launches and RTMP stream and “pulls” the stream from the camera to start it.

Click Play to start the stream if it is Off Air

As long as RTMP streams are being viewed, the video will be automatically recorded.  As soon as all RTMP streams are stopped, the stream will stop as well and recording will stop.