Create framesets from existing video services
Framesets allow users to generate screenshots of specific times and segments within a video service of their choice. This can be useful for those who wish to share a specific finding or extract a frame for further analysis outside of ArcGIS Video Server. To create a frameset:
- Navigate to the REST endpoint for ArcGIS Video Server and sign in.
For example: https://machine.domain.com:21443/arcgis/rest)
- Click Services and find the service with the layer you want to clip.
- Click on the layer you want under Layers.
- Under Child Resources, select Framesets.
- Click Create New Frame Set.
- Input a JSON for the Time Range field. This is required.
The Time Stamp field accepts input of integers divided by commas, like 1,2,3.
The Expiry field refers to how long the frameset will persist on the disk. After the input time passes, the files will be deleted.
- Framesets can be found under the C:\arcgisvideoserver\directories\arcgisvideoservices\<serviceName> \<Layer#>\framesets\<frameset#> folder by default. If different directories were chosen during site configuration, the location will change accordingly.
Add or remove layers for existing video services
Functionality has been added in ArcGIS Video Server to create services whose layers can be updated over time.
- Navigate to the REST endpoint for ArcGIS Video Server and sign in.
For example: https://machine.domain.com:21443/arcgis/rest)
- Click Services and find the service you want to update.
- Click on the service.
- To add a layer, click Add Layer.
A new page requesting JSON input opens.
- The format for the expected JSON is the following: { "type" : "ondemand", "id" : 1, "name" : "layerName", "requestedResolutions" : "sd,hd,fhd,native", "fileIds" : "theFileID" } .
- The video file for this layer will need to be uploaded to your server by REST > Uploads. The File ID is the output after uploading the file and can be copied/pasted into this JSON.
- Other layer types will require changes to the JSON used.
- For a UDP Multicast Livestream layer, it requires the “type” to be “livestream”, the “mode” would be “multicast”, and requires the “streamAddress” parameter.
For example, {"type":"livestream","mode":"Multicast","name":"testName","streamAddress":"udp://IP:Port"} .
- An External Proxy Livestream has similar requirements, with the mode being proxy along with the streamAddress.
For example, {"cameraInfo":null,"mode":"proxy","name":"External_Livestream”,streamAddress":"https://streamURL.com/video.m3u8","type":"livestream"}.
- After submitting the job, we can view Job Details to watch the process of publication as with any other service. If any errors occur, this will also provide details for troubleshooting.
- Navigate to REST > Services > yourService and verify that the new layer is listed under Layers.
- To remove undesired layers, select the layer under Layers and click Delete under Supported Operations. Confirm that this is the desired action on the next screen.
Create a clip
Clips allow users to generate videos of specific time ranges within a video service of their choice. This can be useful for those who only need a specific part of a video, or to easily share specific moments. To create a clip:
- Navigate to the REST endpoint for ArcGIS Video Server and sign in.
For example: https://machine.domain.com:21443/arcgis/rest)
- Click Services and find the service with the layer you want to clip.
- Click on the layer you want under Layers.
- Under Child Resources, select Clips.
- Click Create New Video Clip.
- Input a JSON for the Time Range field. This is required.
{ "start" : 0, "end" : 10000 }
The Start parameter is where the clip will begin, and End marks the time at which it ends. The Expiry field is how long the clip will remain on the hard drive. The default is 60.
Name the field. Output Format allows you to select the file format of the clip. The output formats currently available are .ts, .mpeg, and .mov. If left blank, it will be the same format as the original layer.
- Clips can be found under the C:\arcgisvideoserver\arcgisvideoservices\ServiceName\Layer#\clips\ folder by default. If different directories were chosen during site configuration, the location will change accordingly.