Authorizations
API key for authentication. Make sure to include the word apikey
, followed by a single space and then your token.
Example: apikey 1234$abcdef
Path Parameters
ID of a stream to record
Start recording a stream.
Stream will be recorded and automatically saved in our video hosting as a separate video VOD:
stream_id
” field. You can find the video by that value later.recording_started_at
” field.record_type
” parameter of the stream.origin_url
” field. Look at the description of the field how to use it.Stream must be live for the recording to start, please check fields “live” and/or “backup_live
”. After the recording starts, field “recording” will switch to “true”, and the recording duration in seconds will appear in the “recording_duration
” field.
Please, keep in mind that recording doesn’t start instantly, it takes ±3-7 seconds to initialize the process after executing this method.
Stream recording stops when:
Explicit execution of the method /stop_recording
. In this case, the file will be completely saved and closed. When you execute the stream recording method again, the recording will be made to a new video file.
When sending the stream stops on the client side, or stops accidentally. In this case, recording process is waiting for 10 seconds to resume recording:
If the stream resumes within that period, recording will continue to the same file.
After that period, the file will be completely saved and closed.
If the stream suddenly resumes after this period, the recording will go to a new file, because old file is closed already. Please, also note that if you have long broadcasts, the recording will be cut into 4-hour videos. This value is fixed, but can be changed upon request to the Support Team.
API key for authentication. Make sure to include the word apikey
, followed by a single space and then your token.
Example: apikey 1234$abcdef
ID of a stream to record