Question
What are the various attributes of the Vonage Video composed archive codecs?
Applies To
- Composed Archives
- Video API
Answer
Vonage Video API composed archives are created by a process that ingests and decodes all the published streams in a session, composes them into a single audio and video stream, re-encodes the composite stream, and then wraps it in a media container.
Basic metadata about an archive is provided via the REST API and Archive callback when the archive completes, including the size and duration of the archive, as well as other helpful attributes. Beyond this, the configuration of composed archive media encoding itself is described below.
Media Quality
The quality of an archive can be no higher than the quality of the real-time audio and video in a session. Real-time streams, captured and encoded for live video chat, are the inputs to the archiving composer. Given best-case conditions, archive quality will be similar to the audio and video quality of a real-time session, and can degrade as client network issues arise, just as with real-time video chats.
Audio Encoding
The audio in the composite archive is a single channel encoded as AAC at 128Kbps and a sample rate of 48Khz.
Video Encoding
The video in the composite archive is encoded using H.264 Baseline profile at level 3.1. A constant quantization parameter (qp) of 19 is used, yielding variable bitrate video. By default, the output resolution is 640x480 (SD landscape) at 25 frames-per-second. Other resolutions 480x640 (SD portrait), 720x1280 (HD portrait), 1280x720 (HD landscape), 1080x1920 (FHD portrait), 1920x1080 (FHD landscape) are also supported. The keyframe interval is 10 seconds. Input decoded video streams are sampled with YUV 4:2:0 at 8 bits per component.
Container
Streams are wrapped in an MP4 media container to create an .mp4 file.
Although Vonage Video API does not provide this detailed level of information as part of archive meta data, it can be obtained using a utility for reading audio and video file attributes such as MediaInfo or ffprobe.
At this time, archive composer audio and video encoding settings cannot be customized by developers using Vonage Video API.
Additional information
For details on REST API to retrieve archive information, please refer to our documentation below.
Vonage Video API Opentok Environment
Vonage Video API Unified Environment
For information about archive callback, please refer to our developer documentation below.
Vonage Video API Opentok Environment
Articles in this section
- 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?
- Accessing Recordings When Using Vonage Video API Demo