Recording Videos

Overview

The Vonage Video archiving API lets you record a session's audio-video streams to MP4 files.

Archiving requires both client-side and server-side code. In order to archive sessions, you need to have an HTTP server set up. You can pick the right server SDK for your sever setup. The Server SDK on receiving data from the client SDK will perform the actual archiving functionality. Your client-side code will then invoke your server-side code through HTTP calls.

• In most applications, control of the archive recording would not be granted to every end-user.

• You can have automatically archived sessions, which are recorded whenever a client starts publishing a stream.

• You will want to set up an Amazon S3 or Microsoft Azure target for storage of your archive recordings.

This how-to will go over:

• Starting a recording
• Stopping a recording
• How to get information about a recording

Before you start

Before you begin to add recording to your application, ensure that you have a basic video application already running.

If you do not want to write your own server, you can use a pre-built server deployed to Vonage's Code Hub. Head on over to the Vonage Video Learning Server (PHP) and click on "Deploy Code." This will download our learning server and automatically launch it for you.

If you want to explore the code, you can instead click on "Get Code" or head on over to GitHub and download the code to your local machine.

Starting a Recording

Unless your session is set to auto-archive, you will need to tell our system to start recording your session. In practice, this means that your front-end will present recording options to a moderator (or other appropriate role), and your front-end will send a request to a back-end server that will talk to the API to start the recording.

1. Have your front-end send a request to your server to start the archiving.

2. Have your back-end server accept the request, and contact the REST API to start the archiving.

If you are using the REST API directly, you will get a response similar to the following:

If you are using an SDK, it will return the above information in a format appropriate for the SDK. Please check the reference for your Server SDK on the exact return value you will get.

Stopping an Archive

A recording will continue until one of the following conditions are met:

• 4 hours of recording time
• 1 hour of inactivity (no clients are publishing streams)
• 12 total hours of active and "paused" publishing. A stream will pause when no clients are publishing.

We do not recommend that you let an archive stop based on the thresholds above. You should stop an archive whenever you know that an archive is finished. This works similiarly to starting an archive where your front-end should send a request to the back-end to tell the API to stop recording.

1. Have your front-end send a request to your server to stop the archive.

2. Your back-end server will send a request to the REST API to stop the recording.

You will get back a response similar to the following:

This response may not have the final recording URL, especially if you are archving to your own S3 or Azure storage, or if the archive is not finalized. We will send a callback to your server when the archive is ready for download.

Getting Archive Information

You can also get information about any archive at any time. This is useful to get statistics about the archive, and to check the status of the archive itself. For example, when you stop an archive it may take a few moments before the archive itself is ready. You can check the information of an archive to see when the archive is done and ready for download.

You will get back a response similar to when you stop the archive.

See also

• Vonage Video archiving developer guide