Skip to main content

You are viewing Agora Docs forBetaproducts and features. Switch to Docs

Individual recording with postponed transcoding

If the individual transcoding recording does not meet your business needs, you can set up postponed transcoding. When set, Cloud Recording transcodes the recording file to generate an MP4 file within 24 hours after recording (or within 48 hours in special cases) and uploads it to the third-party cloud storage you specify.

Note
In the postponed transcoding scenario, the recorded files are cached on the Agora edge server for no longer than 24 hours. If your business is sensitive to information security, carefully consider whether to use the postponed transcoding in view of data compliance. If you have any questions, contact Agora technical support.

The request example is as follows:


_52
{
_52
"cname": "httpClient463224",
_52
"uid": "527841",
_52
"clientRequest": {
_52
"token": "<token if any>",
_52
// highlight-start
_52
"appsCollection": {
_52
"combinationPolicy": "postpone_transcoding"
_52
},
_52
"transcodeOptions": {
_52
"container": {
_52
"format": "mp4"
_52
},
_52
"transConfig": {
_52
"transMode": "postponeTranscoding"
_52
}
_52
},
_52
// highlight-end
_52
"recordingConfig": {
_52
"channelType": 1,
_52
"streamTypes": 2,
_52
"streamMode": "default",
_52
"videoStreamType": 0,
_52
"maxIdleTime": 30,
_52
"subscribeAudioUids": [
_52
"123",
_52
"456"
_52
],
_52
"subscribeVideoUids": [
_52
"123",
_52
"456"
_52
],
_52
"subscribeUidGroup": 0
_52
},
_52
"recordingFileConfig": {
_52
"avFileType": [
_52
"hls"
_52
]
_52
},
_52
"storageConfig": {
_52
"vendor": 2,
_52
"region": 3,
_52
"bucket": "xxxxx",
_52
"accessKey": "xxxxx",
_52
"secretKey": "xxxxx",
_52
"fileNamePrefix": [
_52
"directory1",
_52
"directory2"
_52
]
_52
}
_52
}
_52
}

Set up the following clientRequest configurations:

  • Set the appsCollection.combinationPolicy field to postpone_transcoding.
  • Set the transcodeOptions.transConfig.transMode field to postponeTranscoding.
  • Set the field format as needed. For supported values, see the API documentation.
vundefined