Filter
Top Products
Video Streaming API
This document is copyright protected and is the property of Axis Communications AB and may not be copied, reproduced or distributed in any way without
the prior written consent of Axis Communications AB.
3 RTSP API
RTSP (Real Time Streaming Protocol) is a control protocol for media streams delivered by a media server. RTSP can be considered a
“remote control” providing commands such as play and pause. In addition, RTSP API provides parameters controlling media stream
properties such as resolution, compression, video bit rate and audio as well as parameters controlling the image settings.
Please refer to the release notes for the actual product for compliance information.
The RTSP server in the Axis products is based on RFC 2326 Real Time StreamingProtocol (RTSP), RFC 4566 SDP: Session Description
Protocol and RFC 3550 RTP: A Transport Protocol for Real-Time Applications.
When streaming both video and audio the audio and video can be synchronized by using RTP timestamps as described in RFC 3550.
3.1 Prerequisites
3.1.1 Identication
Property: Properties.API.RTSP.Version=2.01 and later
Property: Properties.API.RTSP.RTSPAuth=yes
3.2 RTSP Commands
The RTSP API provides several commands for media stream control.
3.2.1 Request Syntax
Syntax:
COMMAND rtsp://<servername>/axis-media/media.amp
[?<parameter>=<value>[&<parameter>=<value>...]] RTSP/1.0<CRLF>
Headerfield1: val1<CRLF>
Headerfield2: val2<CRLF>
...
<CRLF>
[Body]
COMMAND is any of DESCRIBE, SETUP, OPTIONS, PLAY, PAUSE, TEARDOWN, SET_PARAMETER or GET_PARAMETER. Lines
are separated with Carriage Return and Line Feed (CRLF).
Supported RTSP URL parameters and their values are listed in section3.4 Parameter SpecicationRTSP URL.
Note
RTSP requests always contain the absolute URL.
The following header elds are accepted by all commands. Some commands accept or require additional header elds:
Header Field Description
Authorization
Authorization information from the client.
CSeq
Request sequence number.
Session
Session identier (returned by the Axis product in SETUP
response).
Content-Length
Length of content.
15