Begin recording when you start a transcoder

Learn how to use the REST API to record a live stream or transcoder in the Wowza Video™ service.

Info

This topic only applies to version 2.0 and later of the REST API.

Before you start

You should complete the following tasks:

Create a live stream or a transcoder . You'll need the resulting live_stream_id or transcoder_id to record a broadcast. View our View our connect a source topics to learn how to create a live stream or transcoder for RTMP, RTSP, IP camera, SRT encoder, UDP encoder, WebRTC, and Wowza Streaming Engine.

You should be familiar with the following concepts:

Available workflows for recording streams.

You should choose between the following two workflows:

Decide between the live stream or transcoder workflow.
See Decide between a live stream or transcoder workflow for more information about these workflows.

Live stream workflow

Live Stream Workflow

1. Configure your live stream to record when it starts

You'll need to edit your live stream so that the save_asset parameter is set to true. You can skip this step if you set this parameter to true when you created the live stream.

Endpoint Reference

Copy

Copied

curl 
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${WV_JWT}" \  
  -X "PATCH" \
  "${WV_HOST}/api/${WV_VERSION}/live_streams/[live_stream_id]" \
  -d $'{
  "live_stream": {
    "save_asset": "true"
  }
}'

2. Start the live stream

Endpoint Reference

Copy

Copied

curl -X PUT \
-H "Authorization: Bearer ${WV_JWT}" \
"${WV_HOST}/api/${WV_VERSION}/live_streams/[live_stream_id]/start"

3. Stop recording

You can stop the recording at any point before the live stream has ended or you can stop the live stream, which will end the recording.

Info

We recommend leaving the live stream running for 10 to 15 seconds after the end of the event. This ensures that the recording doesn't cut off prematurely.

Stop the recording:

Endpoint Reference

Copy

Copied

curl -X PUT \
-H "Authorization: Bearer ${WV_JWT}" \
"${WV_HOST}/api/${WV_VERSION}/transcoders/[transcoder_id]/stop_recording"

Stop the live stream:

Endpoint Reference

Copy

Copied

curl -X PUT \
-H "Authorization: Bearer ${WV_JWT}" \
"${WV_HOST}/api/${WV_VERSION}/live_streams/[live_stream_id]/stop"

Transcoder workflow

Transcoder Workflow

1. Configure your transcoder to record when it starts

You’ll need to configure the properties parameter. The section should be set to save_asset, the key to mp4, and the value to true. For more information, see Set advanced properties with the Wowza Video REST API.

Endpoint Reference

Copy

Copied

curl -X PUT \
-H "Authorization: Bearer ${WV_JWT}" \
"${WV_HOST}/api/${WV_VERSION}/transcoders/[transcoder_id]/properties"

{
  "property": {
    "save_asset": "mp4",
    "section": "recording",
    "value": "true"
  }
}

2. Start the transcoder

Endpoint Reference

Copy

Copied

curl -X PUT \
-H "Authorization: Bearer ${WV_JWT}" \
"${WV_HOST}/api/${WV_VERSION}/transcoders/[transcoder_id]/start"

3. Stop recording

You can stop the recording at any point before the stream has ended or you can stop the transcoder, which will end the recording.

Info

We recommend leaving the transcoder running for 10 to 15 seconds after the end of the event. This ensures that the recording doesn't cut off prematurely.

Stop the recording:

Endpoint Reference

Copy

Copied

curl -X PUT \
-H "Authorization: Bearer ${WV_JWT}" \
"${WV_HOST}/api/${WV_VERSION}/transcoders/[transcoder_id]/stop_recording"

Stop the transcoder:

Endpoint Reference

Copy

Copied

 curl -X PUT \
-H "Authorization: Bearer ${WV_JWT}" \
"${WV_HOST}/api/${WV_VERSION}/transcoders/[transcoder_id]/stop"