Release notes
Updated
Past releases and notable updates for Media Gateway.
This page provides the release notes for Media Gateway.
New features
-
WHIP streaming protocol support
Media Gateway adds support for the WHIP protocol for pushing streams, in addition to RTMP and SRT. WHIP is more resilient to weak network conditions than RTMP and has built-in load balancing. Supported codecs are H.264, H.265, and AV1 for video, and OPUS for audio. For more information, see WHIP streaming.
-
AV1 video transcoding
Stream templates support AV1 as a transcoding output codec, in addition to H.264 and H.265. Use AV1 to reduce bitrate at the same visual quality, or to serve players that require AV1 playback. For supported codecs, see Feature details.
-
G.711 audio ingest
RTMP and RTMPS ingest accepts G.711 A-law and u-law audio, commonly used by security cameras and hardware encoders. Media Gateway maps G.711 audio to PCMA or PCMU without requiring a transcoding template. For supported codecs, see Feature details.
-
Adaptive transcoding
Stream templates support conditional transcoding. You define an expression based on source stream properties, such as bitrate, frame rate, and B-frames, and Media Gateway transcodes a stream only when it doesn't already meet your target specification. For more information, see Adaptive transcoding.
-
Custom domains and TLS certificates
Configure custom RTMPS streaming domains and manage TLS certificates through the REST API, including requesting an Agora-issued certificate or importing your own. For more information, see RTMP and RTMPS streaming.
-
Dual-stream high availability
Bind two streaming keys to the same channel and user ID, then stream to a primary and a backup domain at the same time. Media Gateway can automatically fail over to the backup stream if the primary stream drops or degrades in quality. For more information, see Dual-stream.
-
Global streaming keys
Create a streaming key that works across all Media Gateway regions, instead of being scoped to a single region. You can also revoke a global streaming key across all regions in a single request. For more information, see Create a global streaming key.
-
New streaming key format
Media Gateway adds a more secure method for generating streaming keys locally. Streaming keys generated using this method start with
sk001and are bound to your app ID, which prevents a key from being used in a different project. You can use a streaming key in this format as the stream name for RTMP and SRT, or as the Bearer token in a WHIP request. For more information, see Generate a streaming key with your App ID.
New features
-
Low-bitrate high-quality streaming
Video transcoding now supports low-bitrate high-quality streaming through PVC and Super Resolution features. For configuration details, see PVC and Super Quality.
-
Adaptive Bitrate (ABR)
Stream configuration templates now support ABR functionality. For configuration details, see Adaptive bitrate (beta).
-
SRT streaming protocol support
Gateway nodes now support the SRT protocol with the following codec formats:
- Video: H.264, H.265
- Audio: AAC, OPUS
For configuration details, see SRT streaming.
Improvements
-
NCS callback configuration by VID
Configure NCS callback logic by VID. For the
live_profile_updatedevent, you can configure whichprofilefields are required. -
NCS callback event updates
This version updates the format of NCS callback events, including:
live_stream_connected: Now includes transcoding parameter configuration information for the current streamlive_stream_disconnected: Now includes total input and output bytes for the stream, enabling average bitrate calculation when combined with stream start and end times
This release includes the following updates:
- Adds support for a backup primary domain name and a secondary domain name to ensure service availability.
- Adds the
modefield for setting the transcoding mode, and updateswidth,height, andfpsfields to support more transcoding options.
Agora Media Gateway reaches General Availability status with the following core functions:
- Pushing media streams into Agora SDRTN(R)
- Supporting RTMP and SRT streaming protocols, H.264 and H.265 video codecs, and AAC audio codec
- Customizing transcoding options, including video resolution, frame rate, and bitrate
