Procedure for Vonage Video API Opentok Environment
The OpenTok platform allows you to record the sessions generated in your application. You can do this through the OpenTok REST API or one of the OpenTok Server SDKs.
What file format is used for composed archives?
The current file format of a composed archive is a 640x480 MP4 (H.264/AAC) video file.
How can I add a storage location for archives to be uploaded?
You can configure a cloud archiving storage location via the TokBox Account Portal. To save archives, you will need access to an Amazon S3 bucket or a Windows Azure container. You can also download your files manually from the Account Portal. See Using an Amazon S3 bucket with OpenTok archiving and Using an Windows Azure container with OpenTok archiving to learn how to configure these.
What happens if I don't have a cloud storage location set up? What happens if my archive fails to upload to S3/Azure?
If you do not define an Amazon S3 bucket or Windows Azure container, or if uploading to the specified bucket/container fails, recorded archives are available for retrieval from download from the OpenTok cloud. Archives made available on the OpenTok cloud are available for 72 hours from the time they are created. You will also receive an email reporting the upload failure to the email address listed on your TokBox account.
When setting up the cloud storage endpoint in your account, you can optionally disable OpenTok cloud fallback. This may be required based on industry or government security policies. Please be aware that in case of failure, archives will not be recoverable.
How can I know when the archive is uploaded or available?
You can use the Archive Inspector tool to view the status or an archive, or you can configure a callback that receives archiving status messages. To define an archiving callback, log into your Account Portal and follow these steps:
- In your TokBox Account page, locate the project you want to configure in the left side navigation bar.
- Navigate to the "Archives" section.
- Click "Configure" under Callback URL and enter the desired URL.
For every status change of the archive we will send a POST request to the specified URL with archive details.
Procedure for Vonage Video API Unified Environment
The Vonage Video API Unified Environment platform allows you to record the sessions generated in your application. You can do this through the Vonage Video REST API or one of the Vonage Video API Unified Environment Server SDKs.
What file format is used for composed archives?
The current file format of a composed archive is a 640x480 MP4 (H.264/AAC) video file.
How can I add a storage location for archives to be uploaded?
Recordings will be temporarily stored in your Vonage account, and automatically deleted after 72 hours. To keep your recordings for longer, connect a Microsoft Azure, Amazon S3 or S3 compliant storage account.
You can configure a cloud archiving storage location via the Video API Account Portal. You will need to go to the application you want to use archives with and find "Recordings storage". Within that section, choose "Recordings storage" and you will be able to add an integration for Amazon S3 or Azure.
What happens if I don't have a cloud storage location set up? What happens if my archive fails to upload to S3/Azure?
If you do not define an Amazon S3 bucket or Windows Azure container, or if uploading to the specified bucket/container fails, recorded archives are available for retrieval from download from the Vonage Video API Unified Environment cloud. Archives made available on the Vonage Video API Unified Environment cloud are available for 72 hours from when they are created. You will also receive an email reporting the upload failure to the email address listed on your Vonage Video API Unified Environment account.
When setting up the cloud storage endpoint in your account, you can optionally disable Vonage Video API Unified Environment cloud fallback. This may be required based on industry or government security policies. Please be aware that in case of failure, archives will not be recoverable.
How can I know when the archive is uploaded or available?
You can use the Recording Inspector Tool to view the status or an archive, or you can configure a callback that receives archiving status messages. To define an archiving callback, find the section "Recordings callback URL New recordings alert" and populate with the URL you would like to use.
For every status change of the archive we will send a POST request to the specified URL with archive details.
Articles in this section
- File Format with Archive Encryption
- Individual Stream Archive Manifest CreatedAt Attribute Incorrect
- What are the attributes of the Vonage Video Composed Archive Codecs?
- How Much Storage Space is Needed for a 1-Minute Archive?
- How to Configure a FIPS Compliant Amazon S3 Storage Container for Archiving
- How to Configure Archive Monitoring Callbacks
- What happens if a custom archiving layout is applied to an invalid stream?
- What are the limitations of the archiving functionality?
- How does archiving work and how can I configure it?
- What does Size "Not Available" mean in Archive Inspector?