CMAF VOD ᴮᴱᵀᴬ Overview

👍


This is a beta offering. By using this documentation, you agree to abide by the terms of the JWX Beta Program Agreement.

JWX’s CMAF VOD workflow provides flexible transcoding and rendition management for advanced video-on-demand (VOD) use cases. You can upload a source file for JWX to transcode or supply renditions encoded outside JWX. JWX packages and delivers the resulting media using Common Media Application Format (CMAF).

CMAF VOD supports workflows that require greater control over encoding, rendition ladders, and playback than Traditional VOD. Use it to:

  • Apply custom transcoding configurations at the property or media-item level
  • Access premium transcoding features, such as next-generation codecs and audio normalization, with the required paid entitlement
  • Upload pre-encoded video, audio, and text renditions
  • Add or remove individual renditions to a media item
  • Deliver content through HLS or DASH with DRM, analytics, advertising, and other JWX capabilities


CMAF VOD workflows

CMAF VOD offers three distinct workflows to meet your needs.

WorkflowDescription
Automatically create renditionsUpload a source file and use a transcoding config to automatically generate a complete audio and video rendition ladder. Your JWX representative can assist in creating custom transcoding configs.
Transcode custom renditionsUpload a source file and create individual audio and video renditions instead of an automated rendition ladder.
Bring your own renditionsUpload video, audio, and text renditions that you encoded outside JWX.
📘

Premium transcoding

Non-AVC codecs, 4K video, and audio loudness normalization require a premium transcoding entitlement and may incur additional costs.

If the entitlement is removed, JWX continues to create renditions using standard transcoding features and ignores premium settings. The transcoding job does not fail solely because the entitlement is unavailable.


Automatically create renditions

When you upload a source file through the dashboard or Management API v2, JWX uses a transcoding config to automatically generate its audio and video renditions.

Every property receives a default CMAF VOD transcoding config. The standard default config creates:

  • AVC video renditions at 1080p, 720p, 540p, 480p, 360p, and 270p, capped at 60 fps
  • AAC-LC stereo audio up to 192 kbps
  • AAC-LC or E-AC3 5.1 surround track up to 512 kbps when the source contains multichannel audio

JWX adapts the output to the source:

  • The source frame rate is preserved, including fractional frame rates.
  • Vertical video retains its original orientation.
  • Sources are not upscaled. For example, a 720p source produces renditions at 720p and below.
  • Mono audio is upmixed to stereo.

Contact your JWX representative to create a custom transcoding config if you have other encoding requirements or want to build a customized rendition ladder. You can set the config as the new property default or assign it to an individual media item. If you do not assign a config, JWX uses the property default.


Manually create individual renditions

To transcode all renditions individually rather than generate an automatic rendition ladder, first ask your JWX representative to create an empty transcoding config. Next, select the empty config when uploading a source file through the dashboard or Management API v2. The empty config prevents JWX from automatically creating renditions from the source file. After the upload is complete, use the custom audio and video rendition endpoints to transcode each rendition with your preferred settings.


Bring your own renditions

If you encode media outside JWX, use the Management API v2 to upload individual pre-encoded CMAF VOD video, audio, and text renditions that adhere to the guidelines below. After uploading them, you can manage the renditions through the dashboard or API.

To ensure smooth delivery, all uploaded pre-encoded renditions must meet the following specifications.

CategoryGuidelines
Rendition limits per media item

  • Up to 16 video renditions

  • Up to 32 audio renditions

  • Up to 48 text renditions
File format

  • Must be in CMAF with cmfc or cmf2 compatible files

  • Each file must contain exactly one track
File structure

  • Must include a sidx (Segment Index) box

  • Segment durations must be constant within a file

  • Segments must start on an I-frame and end on a closed GoP

  • Recommended: Align segment durations across all video renditions and across all audio renditions for smoother ABR playback
Supported codecsVideo:
  • H.264
  • HEVC (H.265)
  • AV1 (up to 4K resolution)
Audio:
  • AAC
Text:
  • WebVTT
📘

Please note the following.

Kind values:

To define kind values for audio or text tracks, set them in the CMAF file. Suggested kind values are returned in the 201 response bodies of the endpoints for creating CMAF VOD audio and text renditions.

Multiple audio renditions:

When uploading multiple audio renditions, you must upload the same number of audio renditions for every language to adhere to HLS specifications. Audio renditions for different languages should have the same bitrate (rounded down to the nearest KB). This applies to all steps in an audio bitrate ladder.




Did this page help you?
© 2007- Longtail Ad Solutions, Inc.