Setup page

Authentication

Before using the system, you need to authenticate, which can be done using the Login menu in this setup tab. You need to use the API Key that you were provided with. This key identifies you as a user, and ensures you have access to the Video Analysis system with your configuration. The key can also be used for interacting with the REST API programatically.

The API key is validated at login, and will remain active for as long as you keep the sesion opened in your browser.

The production environment is selected by default in the environment dropdown menu. The staging environment can be temporarilly enabled by the Sense Aeronautics Support team for interaction with the staging system. This can be used fo showcasing or validating beta features, or for problem solving, and will not allow video processing unless when enabled by the support team.

Adding new sources

The API supports processing both videos and real time streams. Realtime streams can correspond to either streams provided via a URL, or FlightHub streams. For more information on supported formats, see inputs.

Videos and streams are added to the API for your API Key as follows:

Videos

For adding videos, use the menu in the Add New Video section.

Enter the Alias for your video, which will be used to identify your video in the list of sources in the info page. Then, click on Explore files. This will open a system dialog for selecting a video file from your computer. Once you are ready, click on Add Video Source.

You will receive a message after a few seconds confirming your video file is ready as a source for your API Key.

Please beware you can not upload videos larger than 500Mb in size, and the total quota for your videos is of 10 Gb. Should you require a larger quota or to upload larger files, please contact Sense Aeronautics support.

Streams defined with a URL

For streams defined with a URL, use the menu in the Add New Source section.

Sense Aeronautics' ATR system exploits telemetry information, if available, to optimize the target detection process and provide drone location as output. There are different ways and formats that can be used when integrating directly with Sense Aeronautics Video Processing REST API, as described in the API documentation check telemetry integration.

In this section, the process of adding a stream without telemetry integration, as well as with telemetry integration via MQTT

Adding a stream without telemetry:

An alias and an URL must be provided, which will be used to indentify the stream as a source in the info page. Then, enter URL for your stream and click on Add source.

Adding a stream with telemetry:

If your stream includes telemetry, you need to provide the configuration for this before adding your source.

In this case, check the Add Telemetry box, and then provide all the information about your stream, including the URL and Alias as above, but also the configuration for the telemetry. Telemetry is supported via a MQTT broker, and so you need to fill in the information about the URL, the topic and the message format as indicated in the figure.

Notes on hosted video streams

When providing a stream input URL, and specially for RTMP inputs, you can provide it in two different different ways:

1.- Custom RTMP input: You can stream your own video source to the platform by configuring it to push to any RTMP endpoint you control. This is ideal if you’re using your own infrastructure or broadcasting tools.

2.- Sense Aeronautics Hosted Stream: For a fully managed experience, you can use the streaming service provided by Sense Aeronautics. In this case, your stream should be pushed to the following RTMP endpoint format:

rtmp://media.senseaeronautics.com/path/to/your/stream

To learn how to configure your DJI drone to generate a RTMP stream to our serves, see this section.

Flighthub streams:

If you want to add streams directly from your FlightHub 2 setup, you can do so in the FlightHub section of the Setup page. For more information on this, check this section.

Once you have added all your sources, they will be listed in information page.

Adding new outputs

Outputs allow for integrating the video stream resulting of Sense Aeronautics' AI processing into other applications. The API provides different flavours for this output stream, as explained in detail here.

Adding outputs is not required if you are going to be using the web client for video output visualization. It is only required for further integrating the output of Video analysis on your platform, or for streaming it on other third party services.

You can use the menu in the Add new output section to register outputs into the API. As illustrated in the figure, you will need to include information about the type of stream, and the URL. Once you are ready, click on Add Output. As with the input sources, you can check the registered outputs in the information page once you have finished.