# Release notes (/en/realtime-media/cloud-recording/reference/release-notes)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Agora Cloud Recording is an add-on service to record and save video calls, voice calls, and interactive streaming to
your cloud storage.

Agora Cloud Recording is compatible with Video SDK for:

* Android, iOS, macOS, and Windows - v1.7.0 or later
* Web - v1.12 or later

This page provides the release notes for:

* [Cloud Recording](#cloud-recording)
* [Notifications](#notifications)

<a id="cloud-recording" />

## Cloud Recording [#cloud-recording]

### 2025.06.27 [#20250627]

#### New features [#new-features]

* **Support for self-built S3 compatible cloud storage services**

  This version adds support for self-built S3 compatible cloud storage services. When calling the `acquire` and `start` interfaces, you can specify a S3 compatible cloud storage by setting `vendor` to `11`. Specify the domain name of your cloud storage using the `endpoint` parameter under `extensionParams`. Refer to the following sample configuration:

```json
"storageConfig": {
    "secretKey": "xxxxx",
    "accessKey": "xxxxx",
    "bucket": "s3-digit-test",
    // highlight-start
    "vendor": 11,
    "region": 0,
    // highlight-end
    "fileNamePrefix": [
      "agora",
      "meituan",
      "test"
    ],
    "extensionParams": {
      // highlight-start
      "endpoint": "xxxxx.xxxxx.com"
      // highlight-end
    }
  }
```

### 2024.08.02 [#20240802]

This release adds the following improvement:

To improve the security of Cloud Recording, this release adds optional `stsToken` and `stsExpiration` fields to the `storageConfig` of the `start` and `update` requests. You need to ensure that the validity period of `stsToken` and `stsExpiration` is long enough, so that Cloud Recording can successfully upload files to a third-party cloud storage. For details, see and [API reference](../reference/rest-api/rest).

### 2023.07.05 [#20230705]

This release adds the following improvements:

* Adds support for the following regions of Alibaba Cloud storage:
  * `23`: CN\_Nanjing
  * `24`: CN\_Fuzhou
  * `25`: CN\_Wulanchabu
  * `26`: CN\_Northeast\_2
  * `27`: CN\_Southeast\_7

* Updates the Agora transcoding script to reduce background noise.

### 2022.11.20 [#20221120]

This release adds the following improvements:

* Improves player compatibility for MPD files generated in individual recording `standard` mode, see [Recording configuration](/en/api-reference/api-ref/cloud-recording).
* Optimizes the Agora Format Converter Script for individual recording, you can refer to [Merge audio and video files](/en/realtime-media/cloud-recording/build/process-recorded-files/merge-files) to get the latest Agora Format Converter Script.

### 2022.10.20 [#20221020]

This release supports the postpone transcoding feature globally. You need to set the scene field to `2` (postpone transcoding) when calling the `acquire`. After setting this scene, the recording service transcodes the recorded file within 24 hours after recording to generate an MP4 file, and uploads the MP4 file to the third-party cloud storage you specify. Please note that the `region` of the third-party cloud storage must be consistent with the `region` set when calling `acquire`. For details, see [Individual recording](/en/realtime-media/cloud-recording/build/start-a-recording/individual-mode).

### 2022.8.12 [#2022812]

This release adds support for Amazon S3 in some regions. See [Cloud storage configuration](/en/realtime-media/cloud-recording/reference/region-vendor).

### 2022.5.20 [#2022520]

This release adds the following new feature and API changes:

**Mobile web page mode for web page recording**

This release adds mobile web page mode for web page recording. The API changes are as follows:

* Adds the `mobile` field in `extensionServiceConfig`. After setting `mobile` to `true`, the recording service uses the mobile web page mode to record the current web page.
* The value range of the `videoWidth` and `videoHeight` fields in `extensionServiceConfig` is changed to \[240, 1920].

**Transcoder script for high availability mechanism**

In composite recording mode, Agora provides a transcoder script for merging the old M3U8 file with the new M3U8 file generated after the service enables the high availability mechanism into an MP4 file. For details, see [Manage Recorded Files](./develop/manage-files#when-a-server-is-disconnected-or-the-process-killed).

### 2022.1.20 [#2022120]

#### New features [#new-features-1]

**Individual Audio Non-transcoding Recording**

In order to meet the diverse recording needs of users, this release adds the [`streamMode`](/en/realtime-media/cloud-recording/reference/stream-mode) parameter in the `start` method to support [Individual Audio Non-transcoding Recording](/en/realtime-media/cloud-recording/build/start-a-recording/individual-nontranscoding).

**Postpone Audio Mixing**
For voice chat use-cases, this release adds the [`appsCollection`](/en/api-reference/api-ref/cloud-recording) and [`transcodeOptions`](/en/api-reference/api-ref/cloud-recording) parameters in the `start` method to support [Postpone Audio Mixing](../develop/individual-nontranscoding#implement-an-postpone-audio-mixing). If you enable this function, the recording service merges and transcodes the recorded files of all user IDs in the specified channel within 24 hours after the recording ends to generate an MP3/M4A/AAC file, and then uploads the recording file to your specified third-party cloud storage.

**A Combined audio and video file after individual recording**

When calling `start`, set the `streamMode` field of the [`recordingConfig`](/en/api-reference/api-ref/cloud-recording) parameter to `standard`, you can get a M3U8 audio index file, a M3U8 video index file and a combined M3U8 audio and video index file. If VP9 encoding is used on the web side, a combined MPD audio and video index file are generated.
You can play the combined audio and video index file directly without using script. Agora recommends that you use this mode.

**Support for the third-party cloud storage service encrypting and labeling recording files**

This release adds the [`extensionParams`](/en/api-reference/api-ref/cloud-recording) field to support the third-party cloud storage service to encrypt and tag uploaded recording files. This feature is applicable to Amazon S3 and Alibaba Cloud OSS.

### 2021.12.09 [#20211209]

#### New features [#new-features-2]

This release adds support for Alibaba Cloud (`vendor` is `2`) in the following regions:

* `19`：AP\_Southeast\_6
* `20`：CN\_Heyuan
* `21`：CN\_Guangzhou
* `22`：CN\_Chengdu

For details, see [Alibaba Cloud Documentation](https://www.alibabacloud.com/help/doc-detail/31837.html).

#### Fixed issues [#fixed-issues]

This release fixed the following issue:

When a composite recording started, the user to be recorded did not send streams. When the user sent streams, the user could not display the customized background image or background color after they stopped sending streams or left the channel.

### 2021.10.29 [#20211029]

#### Compatibility [#compatibility]

**Support for AES-GCM2 encryption**

For use-cases requiring high security, to guarantee the confidentiality, integrity, and authenticity of the data and to improve the computational efficiency of the data encryption, this release adds the following options in `recordingConfig`:

* `AES_128_GCM2` and `AES_256_GCM2` encryption modes in `decryptionMode` of `recordingConfig`. The new GCM encryption modes use a more secure KDF (Key Derivation Function) and support setting the key and salt.
* The `salt` parameter in `recordingConfig` to add the salt for the `AES_128_GCM2` and `AES_256_GCM2` encryption modes.

#### New features [#new-features-3]

**Push media stream to the CDN during a web page recording**

Adds support for converting the content and audio of a web page into a media stream and pushing it to the CDN during the web page recording. See the [`start`](/en/api-reference/api-ref/cloud-recording/start), [`update`](/en/api-reference/api-ref/cloud-recording/update) and [`query`](/en/api-reference/api-ref/cloud-recording/query) methods of the Agora Cloud Recording RESTful API for details.

**Third-party cloud storage**

Adds support for [Google Cloud](https://cloud.google.com/), [Huawei Cloud](https://www.huaweicloud.com/intl/en-us/) and [Baidu AI Cloud](https://intl.cloud.baidu.com/) as third-party storage platforms.

#### Improvements [#improvements]

**Capture screenshots**

This release increases the range of the captureInterval of snapshotConfig (in seconds) to \[1,3600] from \[5,3600] when using the Cloud Recording RESTful API to take screenshots of a video stream.

**Output video resolution**

This release increases the upper limit of the output video resolution generated by the web page recording from 1280 x 720 to 1920 x 1080. That is, the range of the `videoWidth` and `videoHeight` parameters of the web page recording in `extensionServiceConfig` is changed to \[480, 1920].

**The estimated maximum number of subscribed users**

To support a larger estimated maximum number of subscribed users, this release adds the following enumeration values of `subscribeUidGroup` in `recordingConfig`:

* `4`: 17 to 32 user IDs
* `5`: 32 to 49 user IDs

### 2021.09.06 [#20210906]

#### Compatibility changes [#compatibility-changes]

The new server version requirements for transcoding recorded files are as follows:

* CentOS 7.0 and later x64
* Ubuntu 14.04 and later x64
* Debian 8.0 and later

#### New features [#new-features-4]

**Web page load timeout detection**

In order to ensure the validity and completeness of page recording, this version supports page load timeout detection function. See [Web Page Load Timeout Detection](/en/realtime-media/cloud-recording/build/customize-the-recording/webpage-load-timeout).

**Pause the page recording**

This release adds the `onhold` parameter to the [`start`](/en/api-reference/api-ref/cloud-recording/start) and [`update`](/en/api-reference/api-ref/cloud-recording/update) methods, which is used to pause the recording when the web page recording starts or is in progress.

**Capture screenshots and recording in a recording process**

This release adds support for recording and taking screenshots in a recording process. Only the recording fee is charged. See [Capture Screenshots](/en/realtime-media/cloud-recording/build/start-a-recording/screen-capture).

#### Improvements [#improvements-1]

* [`The web_recorder_stopped`](../reference/rest-api-overview#71-web_recorder_stopped-web_recorder_stopped) callback adds error codes and error messages to indicate the reason for the abnormal stop of the web page recording. You can take corresponding measures based on the information.
* The [`update`](/en/api-reference/api-ref/cloud-recording/update) method adds the `webRecordingConfig` parameter, which is used to update related parameters during a web page recording.

### 2021.07.30 [#20210730]

This release includes the following new feature and API changes:

**Screenshot event notification**

This release adds the [`recorder_snapshot_file`](../reference/rest-api-overview#45-recorder_snapshot_file) callback，which indicates that the screenshot is captured successfully, and returns the name of the screenshot file.

**New regions for Amazon S3 cloud storage**

This release adds support for Amazon S3 in the following regions:

* `20`: AP\_NORTHEAST\_3
* `21`: EU\_NORTH\_1
* `22`: ME\_SOUTH\_1
* `23`: US\_GOV\_EAST\_1

### 2021.07.07 [#20210707]

#### New features [#new-features-5]

This release adds `maxVideoDuration` to the [`start`](/en/api-reference/api-ref/cloud-recording/start) method to set the maximum duration of the MP4 slice file generated by the web page recording.

#### Improvements [#improvements-2]

When the page status is a `404` or `5XX` error, the page recording service automatically exits to avoid continuing to record the error page.

#### Fixed issues [#fixed-issues-1]

This release fixes an issue where audio was occasionally lost during a web page recording.

### 2021.06.10 [#20210610]

This version was released on June 10, 2021.

#### New features [#new-features-6]

**Network Geofencing**

This release adds the `region` parameter to the [`acquire`](/en/api-reference/api-ref/cloud-recording/acquire) method so you can geofence your cloud recording service. If you specify a region, the cloud recording server connects only to the Agora servers within that region. The following regions are supported:

* Mainland China
* Asia, excluding Mainland China
* North America
* Europe

**Third-party cloud storage**

This release adds support for Microsoft Azure as a third-party storage solution.

#### Improvements [#improvements-3]

This release optimizes the encoding settings for the web page recording, which reduce the bit rate without losing video quality.

#### Fixed issues [#fixed-issues-2]

Fixed security issues caused by vulnerabilities in Chrome V8.

#### API changes [#api-changes]

* Adds the `region` parameter in the [`acquire`](/en/api-reference/api-ref/cloud-recording/acquire) method.
* Adds `recorderStartTime` in the [`web_recorder_started`](../reference/rest-api-overview#70-web_recorder_started-web_recorder_started) callback.
* Adds the [`web_recorder_reload`](../reference/rest-api-overview#73-web_recorder_reload) callback.

### 2021.04.29 [#20210429]

This version was released on April 29, 2021.

**New features**

#### MP4 format in composite recording mode [#mp4-format-in-composite-recording-mode]

From this release, you can get MP4 files after a composite recording. Set `avFileType` as `["hls","mp4"]` when you call the start method, and the recording service generates MP4 files once a recording starts.

#### AES-GCM encryption [#aes-gcm-encryption]

For use-cases requiring high security, to guarantee the confidentiality, integrity, and authenticity of the data and to improve the computational efficiency of the data encryption, this release adds the following options in `decryptionMode`:

* 128-bit AES encryption, GCM mode.
* 256-bit AES encryption, GCM mode.

Once you enable the built-in encryption, all users in the same channel must use the same encryption mode and key.

**Improvement**

From this release, the recording service automatically detects and resolves the occasional audio loss issue during a web page recording, which causes the recorded page to refresh. If necessary, you need to guarantee that the status of your web application remains the same before and after a refresh.

**API changes**

* Adds enumerators `5` and `6` for `decryptionMode` in the [`start`](/en/api-reference/api-ref/cloud-recording/start) method.
* Adds the `fileList` field in the [`uploaded`](../reference/rest-api-overview#31-uploaded) and [`backuped`](../reference/rest-api-overview#32-backuped) callbacks.

### 2021.03.31 [#20210331]

This version was released on March 31, 2021.

**New feature**

#### Background images [#background-images]

In composite recording mode, you can set the background image for both the video canvas and an individual user region. You can update the background image during a recording session. See [Set the background color or background image](../develop/layout#set-the-background-color-or-background-image) for details.

**Improvement**

* Adds a retry logic for Kingsoft Cloud, in which the recording service retries if it fails to upload recorded files to Kingsoft Cloud.

**Fixed issues**

* Occasional file loss when uploading slice files to Tencent Cloud Object Storage (COS).
* In a web page recording, the recording service could not render emoji.
* When recording a static web page, the recording occasionally failed when the value of `videoFps` was too high.

**API changes**

* Adds the `backgroundImage`, `defaultUserBackgroundImage` and `backgroundConfig` fields in the `transcodingConfig` parameter of the [`start`](/en/api-reference/api-ref/cloud-recording/start) method.
* Adds the `backgroundImage`, `defaultUserBackgroundImage` and `backgroundConfig` fields in the `clientRequest` parameter of the [`updateLayout`](/en/api-reference/api-ref/cloud-recording/update-layout) method.
* Adds the `fileList` field in the [`web_recorder_stopped`](../reference/rest-api-overview#71-web_recorder_stopped) callback.

### 2021.02.05 [#20210205]

This release raises the maximum resolution of video sources for [web page recording](/en/realtime-media/cloud-recording/build/start-a-recording/webpage-mode). The recorded web page can now contain video that has a resolution of up to 1920 × 1080.

### 2020.12.10 [#20201210]

This release includes the following new feature and API changes:

#### New feature [#new-feature]

Adds [web page recording](/en/realtime-media/cloud-recording/build/start-a-recording/webpage-mode) mode. In this mode, the content and audio of a specified web page are recorded in a single file.

#### API changes [#api-changes-1]

* Adds `web` as a value for `mode` in the request URL for web page recording.
* Adds `scene` as a new parameter in the `acquire `method for setting the application of the cloud recording resources.
* Adds `"web_recorder_service"` as an extension service in the `extensionServiceConfig` parameter of the [`start`](/en/api-reference/api-ref/cloud-recording/start) method.
* Adds the following callbacks, which report the status of web page recording:
* [`web_recorder_started`](../reference/rest-api-overview#70-web_recorder_started)
* [`web_recorder_stopped`](../reference/rest-api-overview#71-web_recorder_stopped)
* [`web_recorder_capability_limit`](../reference/rest-api-overview#72-web_recorder_capability_limit)

### 2020.09.16 [#20200916]

This release improved the stability and performance of the recording service, and fixed the following issues:

* Failure to subscribe to a low-quality stream.
* Occasional failure to record a whole call.

### 2020.07.21 [#20200721]

This release adds the following new feature and API changes:

**New feature**

#### ApsaraVideo for VoD [#apsaravideo-for-vod]

In composite recording mode, you can now upload recorded files to [ApsaraVideo for VoD](https://www.alibabacloud.com/help/doc-detail/51236.htm) for further processing.

**API changes**

* [`start`](/en/api-reference/api-ref/cloud-recording/start) adds the `extensionServiceConfig` parameter for specifying the configurations of ApsaraVideo for VoD.
* Adds the [`vod_started`](../reference/rest-api-overview#60-vod_started) and the [`vod_triggered`](../reference/rest-api-overview#61-vod_triggered) callbacks, which report the status of uploading recorded files to ApsaraVideo for VoD.

### 2020.06.12 [#20200612]

**New features**

#### Flexible user ID subscription [#flexible-user-id-subscription]

This release provides a more flexible user ID subscription feature, enabling you to set up a whitelist or blacklist for audio and video subscriptions. You can also update the subscription lists during the cloud recording. For details, see [Set up subscription lists](/en/realtime-media/cloud-recording/build/customize-the-recording/subscription).

#### Callback for high availability [#callback-for-high-availability]

This release adds the [`session_failover`](../reference/rest-api-overview#12-session_failover) event, which occurs when the high availability mechanism is enabled and reports the new recording user ID.

**API changes**

* In [`start`](/en/api-reference/api-ref/cloud-recording/start) adds the `unSubscribeVideoUids` and `unSubscribeAudioUids` parameters for setting up subscription blacklists.
* Adds [`update`](/en/api-reference/api-ref/cloud-recording/update) for updating the subscription lists during the cloud recording.
* Adds the `session_failover` event.

### 2020.05.09 [#20200509]

This release adds support for Kingsoft Cloud.

### 2020.04.17 [#20200417]

Cloud Recording now supports taking screenshots of the video streams in individual recording mode. See [Capture Screenshots](/en/realtime-media/cloud-recording/build/start-a-recording/screen-capture) for details.

### 2019.12.16 [#20191216]

This release improved the availability of the cloud recording service. When a server is disconnected or when the process is killed, the cloud recording automatically switches to a new server to resume the service. See [Fault processing when a cloud recording server is disconnected or the process killed](/en/realtime-media/cloud-recording/product-overview) for more information.

**API Changes**

In the [`acquire`](/en/api-reference/api-ref/cloud-recording/acquire) method, adds the `resourceExpiredHour` parameter for setting the time limit for all cloud recording method calls.

Adds the `session_exit` event, which reports the exit status of the cloud recording service.

### 2019.11.15 [#20191115]

You can now use the `query` method to get the names of the recorded files immediately after the recording starts.

### 2019.10.24 [#20191024]

This release supports Tencent Cloud as one of the third-party cloud storages.

### 2019.10.08 [#20191008]

**New features**

#### 1. Individual recording [#1-individual-recording]

The RESTful API adds individual recording mode, which supports recording the audio and video of each user ID separately. See [Individual Recording](/en/realtime-media/cloud-recording/build/start-a-recording/individual-mode) for details. Meanwhile, Agora provides the Audio & Video File Merging script, which you can use to merge the audio and video files generated in individual mode. See [Merge Audio and Video Files](/en/realtime-media/cloud-recording/build/process-recorded-files/merge-files) for details.

#### 2. Record specified user IDs [#2-record-specified-user-ids]

The RESTful API adds the `subscribeAudioUids` and `subscribeVideoUids` parameters, which allow you to record only specified user IDs.

#### 3. Customize the directory of the recorded files [#3-customize-the-directory-of-the-recorded-files]

The RESTful API adds the `fileNamePrefix` parameter, which allows you to specify the directory where you want to store the recorded files in the third-party cloud storage.

#### 4. Timestamp when the stream state changes [#4-timestamp-when-the-stream-state-changes]

The RESTful API callback service adds the `recorder_audio_stream_state_changed` and `recorder_video_stream_state_changed` events to report the time when the state of the audio or video stream changes, as well as the corresponding user ID.

#### 5. Format Converter script [#5-format-converter-script]

Agora provides the Format Converter script, which you can use to convert between multiple file formats, such as TS, MP3, and MP4. See [Convert File Format](/en/realtime-media/cloud-recording/build/process-recorded-files/convert-format) for details.

#### 6. Synchronized playback [#6-synchronized-playback]

You can achieve synchronized playback between the recorded files and other stream files, such as online whiteboards, courseware, and messages, by using the timestamp when the recording starts. You can get the timestamp by using the RESTful API callback service, or by parsing the M3U8 file. See [Synchronized Playback](/en/realtime-media/cloud-recording/build/process-recorded-files/playback) for details.

**Improvement**

When an error occurs, you receive the error message in the HTTP response body, instead of just the error code. See [Agora Cloud Recording RESTful API](../reference/rest-api-overview#error-codes-for-the-agora-cloud-recording-service) for detailed information about the error codes.

**Fixed issue**

When uploading fails after you use the wrong `bucket` and `key` values of the third-party cloud storage, Agora Cloud Recording returns an error instead of uploading the recorded files to Agora Cloud Backup.

### 2019.07.22 [#20190722]

**New features**

#### Customized video layout [#customized-video-layout]

The RESTful API adds a customized layout for the recording video. See [Set Video Layout](../develop/layout#customize-the-video-layout) for details.

You can set the `mixedVideoLayout` parameter as `3` and set the regions for each user in the `layoutConfig` parameter when starting a recording.

You can update the layout anytime during the recording by the `updateLayout` method.

#### Customized background color [#customized-background-color]

The RESTful API adds the `backgroundColor` parameter to support customized background colors for the video layout.

#### Timestamps [#timestamps]

To get the accurate starting time of a recording, the RESTful API provides the Unix timestamp of when the first slicing starts in the response of the `query` method. The RESTful API callback service adds the `recorder_slice_start` event to report the time when the first slicing starts and the time when the last recording fails.

**Improvement**

Optimizes the verification of whether `resourceId` corresponds with `uid` and `cname` when calling the RESTful API.

**Fixed issue**

Fixed minor issues in the default video layout (floating layout).

### 2019.07.02 [#20190702]

* Changes the default background color in the composite layout to black.
* Reduces video freeze under poor network conditions.

### 2019.06.13 [#20190613]

This release supports RESTful APIs. With the RESTful APIs, you can use Agora Cloud Recording through HTTP requests without integrating the SDK.

See the following documents for details:

* [RESTful API Quickstart](/en/realtime-media/cloud-recording/index): Start cloud recording with RESTful APIs.
* [RESTful API Reference](/en/api-reference/api-ref/cloud-recording): Details of the RESTful API methods.
* [RESTful API Callback Service](../reference/rest-api-overview): Enable the callback service to receive notifications of Agora Cloud Recording.

### 2019.04.30 [#20190430]

This is the first release of Agora Cloud Recording with the following functions:

* High-quality voice and video recordings.
* Mixed-stream voice and video recordings of all users in a channel.
* Three composite video layouts: float (default), best fit, and vertical.
* Third-party cloud storage. Agora Cloud Recording supports Amazon S3, and Alibaba Cloud.
* Provides C++ and Java SDK packages.

<a id="notifications" />

## Notifications [#notifications]

### 2022.10 [#202210]

* After you enable Notifications, your server receives the events that you subscribe to in the form of HTTPS requests.
* To improve communication security between the Notifications and your server, Agora SDRTN® uses signatures
  for identity verification.
* As of this release, you can use Notifications in conjunction with this product.