You can publish hosted video layers from video files and supported metadata files using ArcGIS Excalibur. You can also publish hosted live stream video layers from network video broadcasts and streams. To publish hosted video and live stream layers, you must have the appropriate privileges to create, update, and delete video layers.
License:
Publishing video layers is only supported on ArcGIS Enterprise environments.
Publish hosted on-demand video layers
Complete the following steps to publish a hosted video layer:
- On the ArcGIS Excalibur home page, click Publish New: Hosted Web Layers.
Alternatively, from the left navigation menu, click Publish Layer.
- In the Video Layer section, click On Demand.
- Type an Item Name.
- Choose the folder that the new layer will be created in.
- Optionally, provide Summary text that describes the layer.
- Type Tags that describe the layer.
Separate the terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags).
- Chose a sharing level and specify whether to share the layer across the organization or to specific groups.
- Click Next Step.
- Choose the data source and provide the data files and associated metadata files needed to publish your new layer.
You can browse to these files or drag them to the drop zone. See ArcGIS Video Server metadata telemetry requirements for more information on supported metadata files.
- Remove your files to start over.
- Click Next Step.
- Configure the video service name.
The service name can be different than the item name for this layer. Service names cannot contain spaces and invalid characters.
- View the Source Video Information which will provide the analyzed results of the first portion of the video. This will display which telemetry information is available and the source resolution of the video.
It is important to note that only a small portion of the beginning of the video is being analyzed. This may return unknown or incorrect results such as unknown source resolution or no metadata identified.
- Select the desired output video resolutions if available.
When ArcGIS Video Server is installed and configured on an environment with GPU, videos can be published and encoded with multiple resolutions up to the source video resolution, but not above. If GPU is not enabled on the environment, the native resolution of the video is the only option available.
- Optionally, configure Layer Location Details. This will provide the initial startup extent and camera location and heading.
- Initial Map Extent—Pan and zoom or use search to go to a specific location of interest to define the initial extent of the video. This will be the starting extent of the map when the web map loads and will remain at this location if the video does not contain any additional metadata.
- Sensor Position—Select a coordinate format and type or paste the coordinate of the sensor location if known. Additionally, use Capture Coordinate to click directly on the map to define the sensor location.
- Heading—Type the heading in degrees, from 0 to 360, where the camera is facing. Where 0 degrees is North, 90 degrees is East, 180 degrees is South, and 270 degrees is West.
- Field of View—Type the approximate field of view (FOV) in degrees, from 10 to 360. This is the area that can be seen by the camera and is a value between a narrow (10 degree) FOV and a wide (360) FOV.
- Click Save.
- Click Next Step.
- View a summary of your choices prior to establishing.
Click Back to make any changes.
- Click Publish.
Once the video layer is published, click Connect to Canvas to work with the layer in the canvas in ArcGIS Excalibur.
Publish hosted live stream video layers
Complete the following steps to publish a hosted livestream video layer as a user with at least the privileges to publish live video:
- On the ArcGIS Excalibur home page, click Publish New: Hosted Web Layers. Alternatively, from the left navigation menu, click Publish Layer.
- In the Video Layer section, click Livestream.
- Type an Item Name.
- Choose the folder that the new layer will be created in.
- Optionally, provide a Summary that describes the layer.
- Type Tags that describe the layer.
Separate the terms with commas (for example, federal land is one tag; federal, land are two tags.
- Choose a sharing level and specify whether to share the layer across the organization or to specific groups.
- Click Next Step.
- Select a Livestream Protocol and Livestream Mode.
Modes are determined based on the livestream protocol you are publishing:
- UDP Multicast—Use this mode 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—Use this mode 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, Video Server starts the livestream process on one of its nodes and opens a specific, user-defined listening port.
- RTMP and RTSP Pull from Remote Source—Use this mode to enable Video Server to pull livestream content from a remote source. Any IP address can be used.
- RTMP and RTSP Listen for Inbound Stream—Use this mode to enable Video Server to search for and receive livestream content. The allowed IP address is 0.0.0.0 or the IP address set by Video Server for Listen mode.
Note:
In a highly available Video Server environment, the listening machine for a livestream can be determined by navigating to ArcGIS Video Server Admin > Services > serviceName, which will display a listenURL parameter signifying the live endpoint on the node where Video Server livestream process is running.
- Type a Video Layer Name.
- Enter a Stream Address.
- UDP—Enter a fully qualified UDP address to include the IP address and port.
- RTMP and RTSP—Enter a fully qualified RTMP or RTSP address to include the IP address or FQDN, port, and path.
The same port cannot be used in multiple livestream services.
- Click Next Step.
- Choose Record Livestream Content to convert the livestream video layer into an on-demand video layer that can be used and viewed once the livestream ends.
This is enabled by default.
If disabled, you cannot convert the livestream video layer into an on-demand video layer for future use once the livestream has concluded.
- 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.
- 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.
- Optionally, configure Layer Location Details. This will provide the initial startup extent and camera location and heading.
- Initial Map Extent—Pan and zoom or use search to go to a specific location of interest to define the initial extent of the video. This will be the starting extent of the map when the web map loads and will remain at this location if the video does not contain any additional metadata.
- Sensor Position—Select a coordinate format and type or paste the coordinate of the sensor location if known. Additionally, use Capture Coordinate to click directly on the map to define the sensor location.
- Heading—Type the heading in degrees, from 0 to 360, where the camera is facing. Where 0 degrees is North, 90 degrees is East, 180 degrees is South, and 270 degrees is West.
- Field of View—Type the approximate field of view (FOV) in degrees, from 10 to 360. This is the area that can be seen by the camera and is a value between a narrow (10 degree) FOV and a wide (360) FOV.
- Click Save.
- Click Next Step.
- View a summary of your choices.
Click Back to make any changes.
- Click Publish.
Once the layer is published, click Connect to Canvas to work with the layer in the canvas in ArcGIS Excalibur. The video layer will also be available on the Analysis Layers page, where it can be opened in the canvas in ArcGIS Excalibur or managed, allowing you to start or stop the livestream as well as delete the layer.
Publish external video provider layers
To publish an external video provider layer, complete the following steps:
- Click Publish Layer from the navigation menu.
- Click External Video Provider in the Video Layer section.
- Type an Item Name.
- Choose the folder that the new layer will be created in.
- Optionally, provide Summary text that describes the layer.
- Type tags that describe the layer.
Separate each term with commas. For example, Federal land is considered one tag, and Federal, land is considered two tags.
- Choose a sharing level and specify whether to share the layer across the organization or to specific groups.
- Click Next Step.
- Select the type of external video source being published:
- On Demand Video Link—A direct URL to an accessible video resource such as an .mp4 or .m3u8 file.
- Livestream Video Feed—A direct URL to an accessible HLS video source, such as a traffic or security camera or other live source that is streamed using the HS protocol.
- Type the URL for the video source you selected.
These must be URls linked to .m3u8 or .mp4 files, or if a livestream video feed is selected, it must be using the HLS protocol.
- Click Next Step.
- Type a name for the service that will be published on Video Server.
This does not have to match the initial name given to the layer.
- Optionally, configure Layer Location Details. This will provide the initial startup extent and camera location and heading.
- Initial Map Extent—Pan and zoom or use search to go to a specific location of interest to define the initial extent of the video. This will be the starting extent of the map when the web map loads and will remain at this location if the video does not contain any additional metadata.
- Sensor Position—Select a coordinate format and type or paste the coordinate of the sensor location if known. Additionally, use Capture Coordinate to click directly on the map to define the sensor location.
- Heading—Type the heading in degrees, from 0 to 360, where the camera is facing. Where 0 degrees is North, 90 degrees is East, 180 degrees is South, and 270 degrees is West.
- Field of View—Type the approximate field of view (FOV) in degrees, from 10 to 360. This is the area that can be seen by the camera and is a value between a narrow (10 degree) FOV and a wide (360) FOV.
- Click Save.
- Click Next Step.
- View a summary of your choices prior to publishing.
Optionally, click Back to make any changes.
- Click Publish.
- Click Connect to Canvas once the video layer is published to work with the layer in the ArcGIS Excalibur canvas.