Home » API Reference » Encoding Settings » Live Streaming » Event Length

event_length

:Integer permalink

API Versions: V2

Parent: input

Valid Values: 0-93600

Compatible Job Types: live

Example: 18000

Description:

The minimum time, in seconds, to keep a live stream available. At any point within the specified event_length you may reconnect to your stream. The event_length setting goes into effect as soon as streaming begins.

Note: The live stream will remain available for the remainder of event_length or reconnect_time, whichever is greater. You can end a job at any time with a finish API request.

{
  "live_stream": "true",
  "event_length": 1800,
  "reconnect_time": 120,
  "outputs": [ ... ]
}

Given this API request, the following scenarios would be true:

  • Disconnect at 15 minutes: Job finishes at 30 minutes
  • Disconnect at 29 minutes: Job finishes at 31 minutes
  • Disconnect at 50 minutes: Job finishes at 52 minutes

{
  "live_stream": true,
  "event_length": 18000
}
      
<api_request>
  <live-stream type="boolean">true</live-stream>
  <event-length type="integer">18000</event-length>
</api_request>