Skip To Content

Publish hosted live stream video layers

You can publish hosted live stream video layers from network video broadcasts and streams using ArcGIS Excalibur. To publish hosted live stream video layers, you must have the appropriate privileges to create, update, and delete live stream video layers.

Note:

ArcGIS Excalibur requires an add-on license and additional installation. To learn more, see ArcGIS Excalibur system requirements.

Complete the following steps to publish a hosted live stream video layer using ArcGIS Excalibur:

  1. On the ArcGIS Excalibur home page, click Publish New: Hosted Web Layers.

    Alternatively, from the navigation menu, click Publish Layer.

  2. In the Video Layer section, click UDP Livestream, RTSP Livestream, or RTMP Livestream.
  3. For Livestream Mode, select one of the following modes. Modes are determined based on the livestream protocol you are publishing:
    • UDP Multicast—This mode is used for any network communication between many systems simultaneously. The allowed IP address must be between 224.0.0.0 and 239.255.255.255.
    • UDP Unicast —This mode is used for any network communication between one sender and one receiver. The allowed IP address is 0.0.0.0 or the IP address set by the Video Server for Unicast mode. In a UDP Unicast stream, the Video Server starts the livestream process on one of its nodes and opens a specific, user-defined listening port.
    • RTMP and RTSP Fetch—This mode is used to enable Video Server to pull livestream content from a remote source. Any Fully Qualified Domain Name (FQDN) or IP address can be used.
    • RTMP and RTSP Listen—This mode is used to enable Video Server to listen for and receive livestream content. The allowed IP address is 0.0.0.0 or the FQDN or IP address set by the Video Server for Listen mode.

    Note:
    In a highly available Video Server environment, the listening machine for a live stream can be determined by browsing to ArcGIS Video Server Admin > Services > serviceName, which will display a listenUrl parameter signifying the live endpoint on the node where the Video Server live stream process is running.

  4. For Stream Address, enter the address.
    • UDP—Enter a fully qualified UDP address to include the IP address and port.
    • RTMP and RTSP—Enter a full qualified RTMP or RTSP address to include the IP address, port, and path

    Note:
    Note: The same port cannot be used in multiple livestream services.

  5. For Layer Name, type a name.
  6. Ensure that Record Livestream Content is enabled. This is enabled by default. If disabled, there will be no ability to convert the livestream video layer into an on-demand video layer for future use once the livestream has concluded.
  7. For Start Stream Options, choose how to start the livestream.
    • Start On Request—Start the livestream receiver whenever needed. This option provides the most control over when livestreaming ports are active and listening. You can manage the configuration status through the list of livestream services.
    • Start Automatically—Open the receiving port and initialize the livestream when the connection is configured and the video layer is created. Use this option if the livestream is available when the configuration and live layer are made. The receiving communications port on the server opens immediately.
  8. For Stop Stream Options, choose how to stop the livestream.
    • Stop On Request—Stop the livestream receiver whenever needed. This option provides the most control over when livestreaming ports are active and listening.
    • Stop Automatically—Stop the livestream connection and close the port when ArcGIS Video Server detects that the livestream has ended.
  9. Optionally, for Summary, provide a summary that describes the layer.
  10. For Tags, type terms that describe the layer.

    Separate the terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags).

  11. Specify whether you want to share the layer across the organization or to specific groups.
  12. Click New Livestream Video Layer.

Once the layer is published, it appears on the Analysis Layers page, where it can be opened in the canvas in  ArcGIS Excalibur or can be managed; here, you can start or stop the livestream, as well as delete the layer. Video layers can also be consumed and used in ArcGIS AllSource or ArcGIS Pro.