Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Scribd Logo
Upload

Welcome to Scribd!

  • 80 views

    Diva Rtsp-Api 2.2

    Uploaded by

    xl_hamo
    DIVA rtsp settings

    Copyright:

    © All Rights Reserved
    Download as PDF, TXT or read online from Scribd

    Diva Rtsp-Api 2.2

    Uploaded by

    xl_hamo
    80 views9 pages
    DIVA rtsp settings

    Original Title

    DIVA RTSP-API 2.2

    Copyright

    © © All Rights Reserved

    Available Formats

    PDF, TXT or read online from Scribd

    Did you find this document useful?

    Is this content inappropriate?

    DIVA rtsp settings

    Copyright:

    © All Rights Reserved
    Download as PDF, TXT or read online from Scribd
    Download as pdf or txt
    80 views9 pages

    Diva Rtsp-Api 2.2

    Uploaded by

    xl_hamo
    DIVA rtsp settings

    Copyright:

    © All Rights Reserved
    Download as PDF, TXT or read online from Scribd
    Download as pdf or txt
    You are on page 1of 9

    DIVA RTSP API

    DIVA RTSP API


    Version 2.2
    Revision 2.2.0

    DIVA RTSP API

    Contents
    1 End user license agreement

    2 Introduction
    2.1 Real Time Streaming Protocol(RTSP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

    3
    3

    3 Functionality
    3.1 Video playback . . . . . .
    3.1.1 Live video . . . . .
    3.1.2 Video on-demand
    3.1.3 Authentication . .
    3.1.4 Transcoding . . . .

    4
    4
    6
    6
    6
    7

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    .
    .
    .
    .
    .

    DIVA RTSP API

    Chapter 1

    End user license agreement


    R software.
    User license for the Digital Intelligent Video Architecture DIVA
    READ THIS CAREFULLY!
    This End User License Agreement (EULA) is a legal contract between you (natural person or legal person) and
    R hardware, firmware and software (Software Product or Software), the above
    the supplier (producer) of DIVA
    product of which you have received. The Software product consists of computer software, the accompanying
    R
    media, printed documentation and any on-line or electronic documentation. The act of using the DIVA
    software means that you agree with the regulations of this contract. If you do not agree with the regulations
    of this contract, the supplier/producer is not prepared to give you the user right to use the Software product.
    Youre not allowed to use the software product in this case.
    R is protected by copyrights and interSOFTWARE PRODUCT LICENSE The Software product in the DIVA
    national copyright treaties, and by other intellectual ownership laws and treaties. The software product is given
    in license and not sold.
    GRANT OF THE RIGHT OF USE. This contract grants you the following rights /obligations:
    R
    Use of the software in the DIVA

    No reverse-engineering, decompilation or dismantling


    It is not permitted to add or remove software
    It is not permitted to add or remove hardware
    It is not permitted to change any settings in the operating system with the exception of installation, deinstallation or settings of printing equipment.

    DIVA RTSP API

    Chapter 2

    Introduction
    2.1

    Real Time Streaming Protocol(RTSP)

    The RTSP protocol is an open protocol which facilitates the transfer of audio and video over an IP network.
    In order to make Diva video available through RTSP, the RTSP plugin is required. This plugin can supply live
    and on-demand video through an RTSP interface.
    This user manual describes the use and the functionality of the Diva RTSP plugin. Usage of this plugin requires
    a minimum of 1 Diva management server to be available within the network.

    DIVA RTSP API

    Chapter 3

    Functionality
    When the plugin is active, an RTSP stream can be initiated from several media players through a customized
    URL. The arguments within this URL sets the way in which the video is transmitted.

    3.1

    Video playback

    The generic URL is formatted as follows:


    rtsp://[serveraddress]/[serverid or description]?device=[deviceid]&[optional settings]
    The figures on the next page illustratrate how this information can be obtained from Diva Client.

    Figure 1: Server ID, Description and IP Address. (Server tab, Diva Client)

    DIVA RTSP API

    Figure 2: Device ID. (Devices tabb, Diva Client)

    DIVA RTSP API

    Within the boundaries of the given example, both of the following URLs would be valid (since it supports both
    the server id and description):
    rtsp://192.168.202.106/wksztmthkok?device=37
    rtsp://192.168.202.106/14279157275533708956?device=37

    3.1.1

    Live video

    The given example will play live video using the RTSP protocol.

    3.1.2

    Video on-demand

    In order to play recorded video, the timestamp argument can be added to the RTSP URL. This argument identifies from which point in time playback needs to commence. The date and time are formatted in a specific way:
    year (4 digits); month (3 digits); day (2 digits); hour (2 digits); minute (2 digits); second (2 digits); millisecond (3
    digits, optional)
    By this notations, the following 2 timestamps are formatted correctly:
    20130226181722 (26-2-2013 18:17:22)
    20130226181722455 (26-2-2013 18:17:22.455)
    In addition, the following operators can be used combined with the argument:
    =
    Commences playback on exactly the given date and time.
    =>
    Commences playback on the first available data after the given date and time.
    =<
    Commences playback on the last available data before the given date and time.
    rtsp://192.168.202.106/wksztmthkok?device=37&timestamp=>20130226181722 plays video from camera 37
    from 26-2-2013 18:17:22 or later.

    3.1.3

    Authentication

    After initiating an RTSP stream, the server will require a username and password. These are identical to
    those within Diva, please note that the Diva user needs to have sufficient permission for the camera which is
    requested. Please refer to the Diva user manual for more information. Both the username and password are
    case-sensitive.
    Figure 3 illustrate the login procedure within VLC media player.

    DIVA RTSP API

    Figure 3: Logging in on the RTSP server.

    3.1.4

    Transcoding

    The supplied video can be trancoded. In that case the video will always be supplied in JPEG format, and can
    be adjusted for the required height and width, if specified.
    This can be accomplished by combining the transcode (do or do not transcode), width (videowidth) and height
    (videoheight) arguments within the URL.
    Whether to do or do not transcode is identified by the server using a 0 (do not) or 1 (do) value. The videos
    height and width are given in pixels. For example:
    rtsp://192.168.202.106/14279157275533708956?device=37&timestamp=20130226181722
    &transcode=1&width=250&height=125
    This URL initiates a videostream on server 14279157275533708956 (IP address 192.168.202.106) of device
    37 on exactly 26-2-2013 18:17:22, transcoded to JPEG with a width of 250 pixels and a height of 125 pixels.

    VDG Security BV
    Radonstraat 10
    2718 TA Zoetermeer
    The Netherlands
    P+31 (0)79 363 81 11
    F+31 (0)79 363 81 18
    info@vdgsecurity.com
    sales@vdgsecurity.com
    support@vdgsecurity.com
    Chamber of Commerce
    30191139 (The Hague)
    VAT Number
    NL.8124.25.017.B01

    You might also like