0% found this document useful (0 votes)
309 views

Digifort RTSP Interface

The document summarizes Digifort's RTSP interface, which allows accessing live video from Digifort servers' cameras using the RTSP protocol. It supports common RTSP commands and transports video via RTP over TCP or UDP. However, it does not transcode media and can only serve streams as configured on the cameras. The interface permits requesting live video from cameras after RTSP authentication.
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
309 views

Digifort RTSP Interface

The document summarizes Digifort's RTSP interface, which allows accessing live video from Digifort servers' cameras using the RTSP protocol. It supports common RTSP commands and transports video via RTP over TCP or UDP. However, it does not transcode media and can only serve streams as configured on the cameras. The interface permits requesting live video from cameras after RTSP authentication.
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 6

Digifort RTSP Interface

For Digifort 7.2.0.0

© 2002 - 2016 by Digifort. All rights reserved.


2 Digifort RTSP Interface

Index
Part I Overview 3
1 Description
................................................................................................................................... 3
2 History................................................................................................................................... 3

Part II Definitions 3
1 General
...................................................................................................................................
notations 3
General abbreviations
.......................................................................................................................................................... 3
Style conventions
..........................................................................................................................................................
and general syntax of the URL 3

Part III RTSP server implementation 4


1 RFCs ................................................................................................................................... 4
2 Supported
...................................................................................................................................
RTSP commands 4
3 Supported
...................................................................................................................................
media types 4
4 Transmission
...................................................................................................................................
protocol 5
5 Media ...................................................................................................................................
transcoding 5

Part IV Interface 5
1 Requesting
...................................................................................................................................
live video 5

Part V Tested RTSP clients 6

Index 0

© 2002 - 2016 by Digifort. All rights reserved.


Overview 3

1 Overview

1.1 Description

This document specifies the Digifort media


interface based on RTSP protocol.

This interface provides access to live video from


cameras of a Digifort server using the RTSP
protocol, allowing for any media player that
supports this protocol to receive live video from
Digifort servers. This interface can also be used
as a tool for systems integration.

1.2 History
Digifort Version Date Revision Comments
6.7.0.0 2013-Abr-25 Éric Fleming Bonilha First version

2 Definitions
This section contains general information related to the use of this document

2.1 General notations


2.1.1 General abbreviations
The following abbreviations are used in this document

Abbreviation Description
N/A Not applicable - The feature/parameter/value is not used in the specified task
URL Uniform Resources Location (URL) is a compact string that represents a feature available
in Internet. The RFC 1738 describes the syntax and semantics for a URL
URI Uniform Resource Identifier (URI) is a compact string of characters for identifying an
abstract or physical feature. The RFC 3986 describes the generic syntax of a URI

2.1.2 Style conventions and general syntax of the URL


In URL syntax and in the descriptions of the arguments, text in italics with greater than and less than
signs denote a content that must be substituted by a value or a string. When substituting the text, the
greater than and less than signs must also be substituted. For example, the name of a camera is
denoted by <cameraname> in description of URL syntax. In the example of URL syntax,

© 2002 - 2016 by Digifort. All rights reserved.


4 Digifort RTSP Interface

<cameraname> is substituted by the string mycamera.

The URL syntax is written with the word "Syntax:" in bold face, accompanied by a box with the syntax
of the command.

Syntax:
rtsp://<server_address>/Interface/<object>[/<subobject>...]/<command>
[?<argument=value>[&<argument=value>...]]

Example 1: Request live video from camera 1


rtsp://192.168.0.1:554/Interface/Cameras/Media?Camera=1

3 RTSP server implementation


This session provides details on the implementation of the Digifort RTSP server.

3.1 RFCs
The Digifort RTSP server was developed using as a basis the following RFCs:

Server base:
RFC 2326 - Real Time Streaming Protocol (RTSP)
RFC 2327 - Session Description Protocol (SDP)

Packetizers:
RFC 3550 - RTP: A Transport Protocol for Real-Time Applications
RFC 2435 - RTP Payload Format for JPEG-compressed Video
RFC 3016 - RTP Payload Format for MPEG-4 Audio/Visual Streams
RFC 3984 - RTP Payload Format for H.264 Video
RFC 3551 - RTP Profile for Audio and Video Conferences with Minimal Control
RFC 3640 - RTP Payload Format for Transport of MPEG-4 Elementary Streams

3.2 Supported RTSP commands


The Digifort RTSP server supports the following protocol commands:

OPTIONS
DESCRIBE
SETUP
PLAY
PAUSE
TEARDOWN

3.3 Supported media types


The Digifort RTSP server supports the packing and transmission of the following media types:

Video: Motion JPEG, MPEG-4, H.264


Audio: Linear PCM, G.711, G.726, AAC

© 2002 - 2016 by Digifort. All rights reserved.


RTSP server implementation 5

3.4 Transmission protocol


The Digifort RTSP server allows the transmission of media using UNICAST over TCP or UDP protocols.

MULTICAST transmission is not yet supported.

3.5 Media transcoding


The Digifort RTSP server DOES NOT transcode the media, it only serves as a bridge to the original
media stream sent by the camera, with it, you cannot request a media stream with resoluion, frame rate
or quality different from the values configured on the camera.

4 Interface
This section contains information related to the API Interface

4.1 Requesting live video


The RTSP server from Digifort System allows for the request of live video from any camera of the server.

Security level: Requires user authentication through RTSP protocol

Syntax:
rtsp://<server_address>/Interface/Cameras/Media?<argument=value>
[&<argument=value>...]

Arguments:
Argument Valid values Description
Camera=<String>* String Camera name
Profile=<String> Recording Type of media profile:
Visualization
Custom Recording - Request the media stream using the
default recording profile
Visualization - Request the media stream using the
default visualization profile
Custom - Request the media stream using the profile
specified on CustomProfile argument

If this parameter is omitted, the default value


Recording will be used
CustomProfile=<String>String Media profile name in case the value of argument
Profile is "Custom"
* Mandatory parameters

Example 1: Request media stream from camera 1, using default recording profile
rtsp://192.168.0.1:554/Interface/Cameras/Media?Camera=Camera1
or
rtsp://192.168.0.1:554/Interface/Cameras/Media?Camera=Camera1&
Profile=Recording

Example 2: Request media stream from camera 2, using default visualization profile
rtsp://192.168.0.1:554/Interface/Cameras/Media?Camera=Camera2&

© 2002 - 2016 by Digifort. All rights reserved.


6 Digifort RTSP Interface

Profile=Visualization

Example 3: Request media stream from camera ABC, using the previously registered and configured
media profile, named "LowResolution"
rtsp://192.168.0.1:554/Interface/Cameras/Media?Camera=ABC&
Profile=Custom&CustomProfile=LowResolution

5 Tested RTSP clients


The following RTSP clients were tested with Digifort RTSP server successfully:

VLC 2.0.6 - The worlds most popular free media player (www.videolan.org)

Wowza Media Server 3 - Powerful media server, that can be used for internet video broadcasting. This
media server is capable of delivering video in different protocols, allowing for the use of different media
players, including flash plugins that can be added to web pages (www.wowza.com)

© 2002 - 2016 by Digifort. All rights reserved.

You might also like