Page tree
Skip to end of metadata
Go to start of metadata

How do you check the recording permissions?

• iOS/macOS: The first system launch will prompt you to set the recording permissions. If you manually close the settings, you can query the system interface by calling AVAudioSession.sharedInstance().recordPermission()[iOS8.0+] to check the recording permissions.

• Android: Different manufacturers implement different methods to check the recording permissions. The Agora Native SDK can detect a recording failure and report an ERR_ADM_RECORD_AUDIO_FAILED (1018) error code, but this method may not cover all phones. Your app can prompt the user to check the recording permissions by reporting the recording error code.

Can I record in an audio or video call?

Yes, Agora provides recording API methods and allows you to store recorded files on specified servers.

Should I use the Agora Recording Server, Agora Recording SDK, or CDN Recording?

The Agora Recording SDK is the recommended solution for all users.

Is the recording trigger controlled by the server?


How does the server know when to join a channel and the channel details since the recording is triggered by the server?

The server decides when to join a channel (start recording) or leave a channel (stop recording) through your signaling layer. Joining a channel with the Agora Recording SDK is similar joining a channel with the Agora Native SDK at the client side.

How do I know when the recording is complete?

Automatic recording mode: If no one is in the channel when the idle time is up, the Agora Recording SDK stops recording and leaves the channel. The application monitoring the leaveChannel callback indicates that the recording is complete and moves to the next step, such as upload the recording file to another server.

How do I customize the recording file and set the directory of the recording file?

To customize the recording file, you need to configure the CFG file. The SDK package has a hidden .cfg.json file under Agora_Recording_SDK_for_Linux_FULL/samples/cpp. You can refer to the method of setting the output file path and filename. See Recording API.

For example, the recording file needs to be saved as "root directory/dates/uid.aac" where /home/Agora_Recording_SDK_for_Linux_FULL/samples/recording_output is the root directory.

Can I record the voice or video of a specific user?

This function is not supported. You will record the audio or video of all users.

Must the Recording SDK use the same channel profile as the Agora Native/Web SDK?

Yes. If not, issues may occur.

When will the recording stop when I use the command line to record?

The recording stops in one of the following scenarios when you use the command line to record:

  • Press Ctrl + C.
  • When you set the idle value to configure the channel idle duration, and If no user in the channel succeeds the predefined duration, the channel will be disconnected and the recording will be stopped automatically. The default value is 300 seconds.

  • No labels