Playing LocalRTSP

Introduction

The following guide outlines the process of accessing and playing local RTSP feeds from Eagle Eye Networks cameras. This is particularly useful for those looking to integrate their Eagle Eye cameras with other systems or monitor video feeds on a local network.

Prerequisites

Make sure you meet the following requirements:

  • You have a valid Eagle Eye Networks account.
  • You are on the same local network as the Eagle Eye bridges or CMVRs.

Note: Local RTSP URLs can only be played back within the same local network (LAN).

Procedure

By following these steps, you will be able to retrieve and play local RTSPs from Eagle Eye Networks API, giving you access to real-time video feeds within your network.

  1. Log in to Eagle Eye Networks account.

Note: You can get your Base URL and <glossary:access token>> from your account by logging in.

  1. Retrieve the list of cameras.

Note: You may use the appropriate API endpoint, or Eagle Eye Networks WebApp to get a list of the camera IDs that you wish to access.

  1. Call the /feeds API with the camera ID(s) using the following cURL command.

Note: Make sure to replace <access token> with your valid access token and the deviceId__ in parameters with the camera IDs you want to access.

curl --request GET \
     --url 'https://api.c013.eagleeyenetworks.com/api/v3.0/feeds?deviceId__in=1000dabb&deviceId__in=10023191&type=main&include=localRtspUrl&pageSize=100' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <access token>'

The response will contain the local RTSP URLs for the specified cameras.

The following is a sample response for the above call:

{
  "nextPageToken": "",
  "prevPageToken": "",
  "results": [
    {
      "id": "1000dabb-main",
      "type": "main",
      "deviceId": "1000dabb",
      "mediaType": "video",
      "localRtspUrl": "rtsp://devtest%40een.com:LrRCW84D%2BkiFo%2BHilM5FgzOPj4U%[email protected]:8554/1000dabb"
    },
    {
      "id": "10023191-main",
      "type": "main",
      "deviceId": "10023191",
      "mediaType": "video",
      "localRtspUrl": "rtsp://devtest%40een.com:LrRCW84D%2BkiFo%2BHilM5FgzOPj4U%[email protected]:8554/10023191"
    }
  ],
  "totalSize": 2
}
  1. Play the Local RTSP by doing the following:
    1. Extract the localRtspUrl from the JSON response.
    2. Open any RTSP player or library that supports the RTSP protocol.
    3. Paste or input the localRtspUrl into the player, and start streaming the video.

📘

Note

  • No additional authentication is needed for playing the local RTSPs.
  • Make sure to be on the same local network (LAN) as the Eagle Eye Bridges or CMVRs to be able to play the RTSP streams.
  • You can customize the cURL request according to your needs, such as specifying different camera IDs or altering the page size.

Result: You are now able to retrieve and play local RTSPs from Eagle Eye Networks API that is giving you access to real-time video feeds within your network.