Recording a summary of frequently asked questions

How to record a single stream ？

• The console is configured as Global automatic recording , Each single stream in the room will be automatically recorded when streaming , For details, please refer to Global automatic recording .
• The console is configured as Specify user recording , The stream to be recorded is set when entering the room TRTCParams Medium userDefineRecordId Parameters are OK , For details, please refer to Specify user recording （SDK API）.
• If you do not want global automatic recording , At the same time, the platform does not support SDK API, It can be broadcast live through the cloud Live recording Make a separate recording .

How to record mixed stream ？

• If configured Global automatic recording , Mixed stream will also be recorded automatically .
• If configured Specify user recording , And use the server REST API Trigger mixed flow , Specify parameters in the mixed stream interface OutputParams.RecordId, You can start mixed stream recording , For details, please refer to Mixed flow parameters OutputParams.
• If configured Specify user recording , And use the client SDK API Trigger mixed flow , The anchor set up when he entered the room TRTCParams Medium userDefineRecordId Parameter mixed stream will be recorded , For details, please refer to Specify user recording （SDK API）.

When does the recording begin ？

• A single stream pushes the stream for a few seconds （ Network latency and keyframe waiting ） Start recording after .
• Mixed flow is going on for a few seconds （ Network latency and keyframe waiting ） Start recording after .

When will the recording end ？

• The recording of a single stream ends after the stream is cut off , If the continuation time is set , Recording ended after disconnection continuation timeout .
• If you call the client SDK setMixTranscodingConfig() Triggered mixed flow , When the host stream exits or is called again setMixTranscodingConfig() And set the parameter to null End of time .
• If you call the server REST API StartMCUMixTranscode Triggered mixed flow , Automatically stop after all users check out , Or call halfway StopMCUMixTranscode Manual stop .

When do the recording files and callbacks occur ？

• Recording complete 5 Minutes later, the recorded file will be transferred to the cloud on demand platform and a callback will be triggered .
• If the continuation time is set , You need to superimpose the continuation timeout time on the above waiting time . Set the continuation time , The intermediate cut-off recording will not end , There will be no recording files or callbacks .
• MP4、FLV and AAC The type has the maximum duration of a single file （ The console can be configured ） Limit , When the maximum duration is exceeded, a recording file and a callback will be generated , Then continue to generate a new recording file .

How to get the recording file ？

• You can manually find and play on demand through the on-demand console REST API lookup , For details, please refer to Find the recording file .
• You can get the download address of the recording file in time through callback , For details, please refer to Receive recorded files .

The recording file did not generate a check

• The call is not established normally or the upstream streaming time is too short （ Suggest streaming 30 More than seconds ） Recording files may not be generated , You can check whether the data in the above line is normal through the dashboard .
• If configured Specify user recording , When entering the room TRTCParams Medium userDefineRecordId No settings , The single stream will not be recorded .
• If configured Specify user recording , And use the server REST API Trigger mixed flow , No parameters are specified in the mixed stream interface OutputParams.RecordId, Mixed stream will not record .
• If configured Specify user recording , And use the client SDK API Trigger mixed flow , The anchor is not set userDefineRecordId, Mixed stream will not record .

The recording callback did not receive the troubleshooting

• First, check whether the recording file is generated through the console , If not generated , Preliminary troubleshooting can be carried out according to the previous method . File search can refer to Find the recording file .
• If a recording file is generated but no callback is received , You can check whether the callback has been configured correctly . Callback configuration reference Receive recorded files .
• If the callback is configured correctly , You can check whether the server can handle the callback normally , Such as through curl Simulate and test whether the callback request can be processed normally .

Why are so many recording files generated ？

• If the Global automatic recording , Every stream in the room will be recorded automatically .
• If the continuation time is not configured , A new recording file will be generated each time the stream is cut off and pushed again .
• MP4、FLV and AAC Type has a single file maximum duration limit , When the maximum duration is exceeded, a recording file and a callback will be generated , Then continue to generate a new recording file .
• If the room triggers mixed flow for many times , Multiple mixed stream recording files may be generated .