Sets whether or not to record audio only:

• true: Enables audio recording and disables video recording.
• false: (Default) Enables both audio and video recording.

Used together with isVideoOnly:

• If isAudioOnly is true and isVideoOnly is false, only records audio.
• If isAudioOnly is false and isVideoOnly is true, only records video.
• If isAudioOnly is false and isVideoOnly is false, records both audio and video.
• isAudioOnly and isVideoOnly can not be set as true at the same time.

Sets whether or not to record video only:

• true: Enables video recording and disable audio recording.
• false: (Default) Enables both audio and video recording.

Used together with isAudioOnly:

• If isAudioOnly is true and isVideoOnly is false, only records audio.
• If isAudioOnly is false and isVideoOnly is true, only records video.
• If isAudioOnly is false and isVideoOnly is false, records both audio and video.
• isAudioOnly and isVideoOnly can not be set as true at the same time.

Sets whether or not to enable the composite recording mode.

• true: Enables composite recording mode, which means the audio of all uids is mixed in an audio file and the video of all uids is mixed in a video file. You can set the audio profile of the recording file by the audioProfile parameter and set the video profile by the mixResolution parameter.
• false: (Default) Enables individual recording mode, which means one audio or video file for each uid. The sampling rate of the recording file is 48 kHz, and the bitrate and audio channel number of the recording file are the same as those of the original audio stream.

If you set isMixingEnabled as true, mixedVideoAudio allows you to mix the audio and video in an MP4 file in real time. For more information, see MIXED_AV_CODEC_TYPE.

If you set isMixingEnabled as true, mixResolution allows you to set the video profile, including the width, height, frame rate, and bitrate. The default setting is 360 x 640, 15 fps, 500 Kbps.

Note

Agora only supports the following frame rates: 1 fps, 7 fps, 10 fps, 15 fps, 24 fps, 30 fps and 60 fps. The default value is 15 fps. If you set the frame rate as other values, the SDK uses the default value.

See the Video Profile Table.

When the whole channel is encrypted, the recording SDK uses decryptionMode to enable the built-in decryption function:

• "aes-128-xts": AES-128, XTS mode
• "aes-128-ecb": AES-128, ECB mode
• "aes-256-xts": AES-256, XTS mode

The default value is NULL.

Note

The decryption method of the recording application must be the same as that of the Native/Web SDK.

The decryption password when decryption mode is enabled. The default value is NULL.

Sets the path of AgoraCoreService. The default path of AgoraCoreService is Agora_Recording_SDK_for_Linux_FULL/bin/.

Sets the path of the recorded files. The default value is NULL.

After setting recordFileRootDir, the subdirectory will be automatically generated according to the date of the recording.

Sets the path of the configuration file. The default value is NULL.

In the configuration file, you can set the absolute directory of the output, but the subdirectory will not be generated automatically. The content in the configuration file must be in JSON format, such as {"Recording_Dir" : "<recording path>"}. You cannot change "Recording_Dir".

Sets the video decoding format. See VIDEO_FORMAT_TYPE.

Note

When VIDEO_FORMAT_TYPE = 1, 2, 3 or 4, isMixingEnabled cannot be set as true.

Sets the audio decoding format. See AUDIO_FORMAT_TYPE.

Note

When AUDIO_FORMAT_TYPE = 1, 2 or 3, isMixingEnabled cannot be set as true.

Sets the lowest UDP port. The default value is 0. Ensure that the value of highUdpPort - lowUdpPort ≥ 6.

Sets the highest UDP port. The default value is 0. Ensure that the value of highUdpPort - lowUdpPort ≥ 6.

Sets a time period. The value must be ≥ 3 seconds. The default value is 300 seconds.

When the Agora Recording SDK is recording, if there is no user in the channel after a time period of idleLimitSec, it automatically stops recording and leaves the channel.

Note

We charge you this time period.

Sets the interval of the screen capture. The interval must be longer than 1 second and the default value is 5 seconds.

Note

captureInterval is only valid when decodeVideo is set as 3, 4 or 5.

Sets whether or not to detect the users who speak.

• ≤ 0: (Default) Do not detect the users who speak.
• > 0: Sets the interval (ms) of detecting the users who speak. Agora recommends setting the interval to be longer than 200 ms. When the SDK detects the users who speak, the SDK returns the UID of the user who speaks loudest in the onActiveSpeaker callback and returns the UIDs of all users who speak and their voice volumes in the onAudioVolumeIndication callback.

Sets the channel mode. See CHANNEL_PROFILE_TYPE.

streamType takes effect only when the Agora Native SDK/Web SDK enables the dual-stream mode (high stream by default). See REMOTE_VIDEO_STREAM_TYPE.

Sets whether to start the recording automatically or manually:

• 0: (Default) Automatically
• 1: Manually

If you wish to call startService and stopService, then choose Manually.

Deploys the Enterprise Proxy. It allows you to record the content with the Intranet server. For details, please contact support@agora.io.

If you set isMixingEnabled as true, mixResolution allows you to set the audio profile of the recording file:

• AUDIO_PROFILE_DEFAULT = 0: (Default) Sampling rate of 48 kHz, communication encoding, mono, and a bitrate of up to 48 Kbps.
• AUDIO_PROFILE_MUSIC_HIGH_QUALITY = 1: Sampling rate of 48 kHz, music encoding, mono, and a bitrate of up to 128 Kbps.
• AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO = 2: Sampling rate of 48 kHz, music encoding, stereo, and a bitrate of up to 192 Kbps.

Sets the path of the default background image of the canvas in composite recording mode. If defaultVideoBgPath is not set, the cavas displays the background color.

Note

Only supports local images in JPEG format.

Sets the path of the default background image of users in composite recording mode.

The background image is displayed when a user is online and does not send any video stream. If defaultUserBgPath is not set, the the user region displays the background color.

Note

• Only supports local images in JPEG format.
• The background image is not displayed for users using the Agora Web SDK.