Publish Livestream video layers

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

Note:

See ArcGIS Excalibur system requirements to learn more.

Complete the following steps to publish a livestream 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. Click Livestream under Video Layer.

   Note:

   ArcGIS Video Server requires a GPU to be installed and configured to publish video layers. It must be federated with an ArcGIS Enterprise environment and configured with a GPU for the video layer publishing options to appear.

3. Enter an Item Name, add a Summary, and Tags. Optionally, choose an existing Folder Name, or click Create a new folder .
4. Choose a Sharing Level for the new service:
   • Owner
   • Organization
   • Everyone
5. Click Show Groups under Share to Group choose a group from your organization.
6. Click Next Step.
7. Click a Livestream Data Source:
   • Pull Livestream Data—Video Server pulls remote livestream content using a provided URL.
   • Listen for Inbound Livestream Data—Video Server listens for livestream content being pushed to it using designated ports and protocols.

   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.

   Note:

   Hosted Feature Layer is used for creating observation layers as feature services. Learn more about publishing hosted feature layers.

8. Depending on which livestream data source option you selected, the following livestream protocols and options will be available to select from:

   Data Source	Livestream Protocol	Protocol parameters	Notes
   Pull Livestream Data	HTTPS	Video Layer Name HTTPS Source URL	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	Video Layer Name RTMP Source URL	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.
   	RTMPS	Video Layer Name RTMPS Source URL	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.
   	RTSP	Video Layer Name RTSP Source URL	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.
   	RTSPS	Video Layer Name RTSP Source URL	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.
   Listen for Inbound Livestream Data	RTMP	Video Layer Name	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.
   	RTSP	Video Layer Name	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.
   	SRT	Video Layer Name Port Number	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. The default port number is 50841.
   	UDP Multicast	Video Layer Name Port Number UDP Multicast IP	This mode is used for any network communication between many systems simultaneously. The IP address must be between 224.0.0.0 and 239.255.255.255. Default port number is 59671. Click Validate Multicast Address to verify IP address is correct and functioning.
   	UDP Unicast	Video Layer Name Port Number	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. Default port number is 60471.

   Note:

   The URL address that the layer will listen for inbound livestream video will be provided on the summary screen after successfully publishing the layer. This URL will be used by the source of the livestream video to push content.

9. Click Next Step.
10. Click Record Livestream is enabled if desired. 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. This can be changed in the REST endpoint after the service is created.
11. Choose  Start Stream Options option:
    • 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.
    • 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.
12. Choose  Stop Stream Options option:
    • Stop Automatically—Stop the livestream connection and close the port when ArcGIS Video Server detects that the livestream has ended.
    • Stop On Request—Stop the livestream receiver whenever needed. This option provides the most control over when livestreaming ports are active and listening.
13. Optionally, set Location Details.
    1. Click Edit Location.

       Sensor Location Details pane opens.

    2. Change the Map Extent. You can pan and zoom or use the search widget to go to a specific location of interest to define the initial extent of the video. This is the starting extent of the map when the web map loads and remains at this location if the video does not contain any additional metadata.
    3. Modify the Sensor Position. Use the drop-down menu to select a coordinate format and enter or paste the coordinate of the sensor location. Optionally, use the Capture Coordinate tool to click on the map to define the sensor location.
    4. Change the Height of the sensor. Enter the camera height in meters (integer).
    5. Change the sensor Tilt. Enter the tilt of the camera in degrees as an integer between 0 and -90 (below).
    6. Change the Direction of the sensor. Enter in the heading degrees (0-360 degrees) of where the camera is facing, where 0 degrees = North, 90 degrees = East, 180 degrees = South, and 270 degrees = West.
    7. Change the maximum Distance distance, in meters, the camera can view as an integer value.
    8. Change the approximate Field of View, or the area, that can be seen by the camera. This approximation can be defined between a narrow and wide field of view (FOV) from 10 degrees to 360 degrees.
    9. Click Save and Close to exit Sensor Location Details dialog. Alternately, click Reset Form to clear the parameters in the dialog.
14. Click Next Step.
15. Review the summary and parameter values for the new data source.
16. ClickPublish to publish the layer, or use Back to step back through the publish process to modify parameters.

    Note:

    If publishing a livestream video layer in listen mode, the URL address that the layer will listen for inbound livestream video will be provided. This URL will be used by the source of the livestream video to push content.

Publish process begins in two steps; creating the layer and updating the layer settings. 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 to start or stop the livestream. Video layers can also be consumed and used inArcGIS AllSource or ArcGIS Pro.