Agora RTC Objective-C API Reference  Refactor
CHANGES

Note: Please update this file for every Agora API change you do. Simply fill in your updates in the Working section below.

Agora High Level APIs (Working)

API (2022-07-13)

AgoraMediaBase.h adjust the route enum sequence

API (2022-7-7)

AgoraBase.h

Deleted:

  • VideoEncoderConfiguration::codecType not used ,reserved

API (2022-07-07)

AgoraBase.h

Modified:

  • Add operator== for VideoFormat

API (2022-06-30)

IAgoraMediaPlayerSource.h

Deleted:

  • IMediaPlayerSource's muteAudio & isAudioMuted & muteVideo & isVideoMuted

API (2022-07-12)

AgoraBase.h

Deleted:

  • ClientRoleOptions.stopMicrophoneRecording
  • ClientRoleOptions.stopPreview

API (2022-06-29)

AgoraMediaBase.h

Deleted:

  • ERR_NET_NOBUFS = 15,
  • ERR_WATERMARK_PARAM = 124,
  • ERR_WATERMARK_PATH = 125,
  • ERR_WATERMARK_PNG = 126,
  • ERR_WATERMARKR_INFO = 127,
  • ERR_WATERMARK_ARGB = 128,
  • ERR_WATERMARK_READ = 129,
  • ERR_LOGOUT_OTHER = 400,
  • ERR_LOGOUT_USER = 401,
  • ERR_LOGOUT_NET = 402,
  • ERR_LOGOUT_KICKED = 403,
  • ERR_LOGOUT_TOKEN_EXPIRED = 405,
  • ERR_LOGOUT_OLDVERSION = 406,
  • ERR_LOGOUT_TOKEN_WRONG = 407,
  • ERR_LOGOUT_ALREADY_LOGOUT = 408,
  • ERR_LOGIN_OTHER = 420,
  • ERR_LOGIN_NET = 421,
  • ERR_LOGIN_FAILED = 422,
  • ERR_LOGIN_CANCELED = 423,
  • ERR_LOGIN_TOKEN_EXPIRED = 424,
  • ERR_LOGIN_TOKEN_KICKED = 427,
  • ERR_LOGIN_ALREADY_LOGIN = 428,
  • ERR_JOIN_CHANNEL_OTHER = 440,
  • ERR_SEND_MESSAGE_OTHER = 440,
  • ERR_SEND_MESSAGE_TIMEOUT = 441,
  • ERR_QUERY_USERNUM_OTHER = 450,
  • ERR_QUERY_USERNUM_TIMEOUT = 451,
  • ERR_QUERY_USERNUM_BYUSER = 452,
  • ERR_LEAVE_CHANNEL_OTHER = 460,
  • ERR_LEAVE_CHANNEL_KICKED = 461,
  • ERR_LEAVE_CHANNEL_BYUSER = 462,
  • ERR_LEAVE_CHANNEL_LOGOUT = 463,
  • ERR_LEAVE_CHANNEL_DISCONNECTED = 464,
  • ERR_INVITE_OTHER = 470,
  • ERR_INVITE_REINVITE = 471,
  • ERR_INVITE_NET = 472,
  • ERR_INVITE_PEER_OFFLINE = 473,
  • ERR_INVITE_TIMEOUT = 474,
  • ERR_INVITE_CANT_RECV = 475,
  • ERR_START_CALL = 1002,
  • ERR_START_CAMERA = 1003,
  • ERR_START_VIDEO_RENDER = 1004,
  • ERR_ADM_JAVA_RESOURCE = 1006,
  • ERR_ADM_SAMPLE_RATE = 1007,
  • ERR_ADM_RUNTIME_PLAYOUT_ERROR = 1015,
  • ERR_ADM_RUNTIME_RECORDING_ERROR = 1017,
  • ERR_ADM_RECORD_AUDIO_FAILED = 1018,
  • ERR_ADM_INIT_LOOPBACK = 1022,
  • ERR_ADM_START_LOOPBACK = 1023,
  • ERR_ADM_NO_PERMISSION = 1027,
  • ERR_ADM_RECORD_AUDIO_IS_ACTIVE = 1033,
  • ERR_ADM_ANDROID_JNI_JAVA_RESOURCE = 1101,
  • ERR_ADM_ANDROID_JNI_NO_RECORD_FREQUENCY = 1108,
  • ERR_ADM_ANDROID_JNI_NO_PLAYBACK_FREQUENCY = 1109,
  • ERR_ADM_ANDROID_JNI_JAVA_START_RECORD = 1111,
  • ERR_ADM_ANDROID_JNI_JAVA_START_PLAYBACK = 1112,
  • ERR_ADM_ANDROID_JNI_JAVA_RECORD_ERROR = 1115,
  • ERR_ADM_ANDROID_OPENSL_CREATE_ENGINE = 1151,
  • ERR_ADM_ANDROID_OPENSL_CREATE_AUDIO_RECORDER = 1153,
  • ERR_ADM_ANDROID_OPENSL_START_RECORDER_THREAD = 1156,
  • ERR_ADM_ANDROID_OPENSL_CREATE_AUDIO_PLAYER = 1157,
  • ERR_ADM_ANDROID_OPENSL_START_PLAYER_THREAD = 1160,
  • ERR_ADM_IOS_INPUT_NOT_AVAILABLE = 1201,
  • ERR_ADM_IOS_ACTIVATE_SESSION_FAIL = 1206,
  • ERR_ADM_IOS_VPIO_INIT_FAIL = 1210,
  • ERR_ADM_IOS_VPIO_REINIT_FAIL = 1213,
  • ERR_ADM_IOS_VPIO_RESTART_FAIL = 1214,
  • ERR_ADM_IOS_SET_RENDER_CALLBACK_FAIL = 1219,
  • ERR_ADM_IOS_SESSION_SAMPLERATR_ZERO = 1221,
  • ERR_ADM_WIN_CORE_INIT = 1301,
  • ERR_ADM_WIN_CORE_INIT_RECORDING = 1303,
  • ERR_ADM_WIN_CORE_INIT_PLAYOUT = 1306,
  • ERR_ADM_WIN_CORE_INIT_PLAYOUT_NULL = 1307,
  • ERR_ADM_WIN_CORE_START_RECORDING = 1309,
  • ERR_ADM_WIN_CORE_CREATE_REC_THREAD = 1311,
  • ERR_ADM_WIN_CORE_CAPTURE_NOT_STARTUP = 1314,
  • ERR_ADM_WIN_CORE_CREATE_RENDER_THREAD = 1319,
  • ERR_ADM_WIN_CORE_RENDER_NOT_STARTUP = 1320,
  • ERR_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322,
  • ERR_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323,
  • ERR_ADM_WIN_WAVE_INIT = 1351,
  • ERR_ADM_WIN_WAVE_INIT_RECORDING = 1353,
  • ERR_ADM_WIN_WAVE_INIT_MICROPHONE = 1354,
  • ERR_ADM_WIN_WAVE_INIT_PLAYOUT = 1355,
  • ERR_ADM_WIN_WAVE_INIT_SPEAKER = 1356,
  • ERR_ADM_WIN_WAVE_START_RECORDING = 1357,
  • ERR_ADM_WIN_WAVE_START_PLAYOUT = 1358,
  • ERR_ADM_NO_RECORDING_DEVICE = 1359,
  • ERR_ADM_NO_PLAYOUT_DEVICE = 1360,
  • ERR_VDM_WIN_DEVICE_IN_USE = 1502,
  • ERR_VCM_UNKNOWN_ERROR = 1600,
  • RR_VCM_ENCODER_INIT_ERROR = 1601,
  • ERR_VCM_ENCODER_ENCODE_ERROR = 1602,
  • ERR_VCM_ENCODER_SET_ERROR = 1603,

API (2022-06-29)

AgoraBase.h

Modified:

  • set value to VIDEO_SOURCE_TYPE enumeration explicitly

API (2022-06-23)

AgoraMediaBase.h

Add:

  • Add camera capture souce type enumeration

API (yyyy-mm-dd)

Purpose of this change

API file name #1

Add: Short description

  • Foo()
  • Bar()

Modified: Short description

  • Changes Foo() to Foo1()
  • Changes Bar() to Bar1()

Deleted: Short description

  • Deleted Foo()

API (2022-06-22)

IAgoraMediaPlayerSource.h

Modify:

  • Modify onPositionChanged with position_ms

API (2022-06-15)

AgoraBase.h

Add:

  • Add define INVALID_DISPLAY_ID 0xffff

API (2022-06-20)

AgoraBase.h

Modified:

  • default use broadcast when we set decrecated channel profiles

API (2022-06-09)

AgoraBase.h

Modified:

  • delete channel profile of cloud gaming

API (2022-06-01)

AgoraBase.h

Modified:

  • fix CONNECTION_CHANGED_TOO_MANY_BROADCASTERS comment error

API (2022-06-9)

AgoraBase.h

Modified:

  • Explicitly set the enumeration value.

API (2022-06-05)

AgoraMediaBase.h

Modified:

  • remove vendor from ContentInspectModule
  • remove token from ContentInspectModule
  • remove callbackUrl from ContentInspectModule
  • remove ContentWorkType from ContentInspectConfig
  • remove DeviceworkType from ContentInspectConfig

API (2022-05-24)

AgoraBase.h

Delete:

  • Delete ScreenAudioParameters::allowCaptureCurrentApp for iOS and Android

API (2022-05-24)

IAgoraLog.h

Add:

  • add enum item LOG_LEVEL_API_CALL in LOG_LEVEL

API (2022-05-16)

AgoraBase.h

Modified:

  • fix enum QUALITY_TYPE

API (2022-05-15)

Remove AUDIENCE_LATENCY_LEVEL_HIGH_LATENCY. It is only used for argus reporting. No need to expose in public header.

AgoraBase.h

Deleted: AUDIENCE_LATENCY_LEVEL_TYPE.AUDIENCE_LATENCY_LEVEL_HIGH_LATENCY

API (2022-05-31)

AgoraBase.h

Add:

  • add enum SIMULCAST_STREAM_MODE

API (2022-05-11)

AgoraMediaBase.h

Add:

  • add PERMISSION_TYPE::SCREEN_CAPTURE

API (2022-05-10)

AgoraMediaBase.h

Add:

  • enum WLACC_MESSAGE_REASON
  • enum WLACC_SUGGEST_ACTION

API (2022-05-08)

API changes for Screen Capture

- enable initWithDisplayId for Windows

API (2021-05-04)

AgoraBase.h

Modify:

  • add operator function < to VideoFormat

API (2022-05-01)

[NMS-1572]: add vp9 encoder and decoder.

AgoraBase.h

Modified:

  • VIDEO_CODEC_VP9.

API (2022-04-22)

AgoraBase.h

Add:

  • add screen capture parameter for mobile platform, ScreenVideoParameters, ScreenAudioParameters and ScreenCaptureParameters2

API (2022-04-15)

[NMS-1630]: Add start echo test with config.

AgoraBase.h

Add:

  • struct EchoTestConfiguration.

API (2022-5-09)

AgoraMediaBase.h

Add:

  • enum CONTENT_INSPECT_WORK_TYPE

    - enum CONTENT_INSPECT_VENDOR

Modified:

  • struct ContentInspectModule

    - struct ContentInspectConfig

Deleted:

  • struct SnapShotConfig

API (2022-04-28)

AgoraMediaPlayerTypes.h enum MEDIA_PLAYER_EVENT

add player events PLAYER_EVENT_TRY_OPEN_START = 16, PLAYER_EVENT_TRY_OPEN_SUCCEED = 17, PLAYER_EVENT_TRY_OPEN_FAILED = 18,

API (2022-4-27)

AgoraBase.h

Add:

  • enum CAPTURE_BRIGHTNESS_LEVEL_TYPE

API (2022-4-26)

IAgoraParameter.h

Add:

  • KEY_RTC_VIDEO_HARDWARE_ENCODEING che.hardware_encoding
  • KEY_RTC_VIDEO_H264_HWENC che.video.h264.hwenc
  • KEY_RTC_VIDEO_HARDWARE_DECODING che.hardware_decoding
  • KEY_RTC_VIDEO_CODEC_INDEX che.video.videoCodecIndex

API (2022-4-26)

AgoraBase.h

Modified:

  • Change LOCAL_VIDEO_STREAM_ERROR::LOCAL_VIDEO_STREAM_ERROR_SYSTEM_PRESSURE value to 9

AgoraBase.h

Add:

  • Add LOCAL_VIDEO_STREAM_ERROR::LOCAL_VIDEO_STREAM_ERROR_DEVICE_NOT_FOUND

API (2022-4-7)

Add: add RTMP_STREAM_PUBLISH_ERROR_INVALID_PRIVILEGE.

API (2022-3-28)

AgoraMediaPlayerTypes.h

Modified:

  • Change url[kMaxPathLength] to const char* url
  • Change uri[kMaxPathLength] to const char* uri

API (2022-4-20)

AgoraMediaBase.h

Modified: Change VIDEO_PIXEL_UNKOWN to VIDEO_PIXEL_DEFAULT IVideoFrameObserver::getVideoPixelFormatPreference, return VIDEO_PIXEL_DEFAULT by default

API (2022-03-24)

AgoraMediaBase.h

Add:

  • typedef unsigned int video_track_id_t;

API (2022-04-27)

AgoraBase.h

Modified:

  • change reason REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK trigger by states of
  • REMOTE_VIDEO_STATE_FROZEN -> REMOTE_VIDEO_STATE_STOPPED

API (2022-04-22)

AgoraBase.h

Add:

  • ClientRoleOptions bool stopMicrophoneRecording with default value true

API (2022-04-20)

AgoraBase.h

Modified:

API (2022-04-18)

IAgoraParameter.h

Deleted: Remove audio related public parameters.

API (2022-04-14)

IAgoraMediaPlayerSource.h

API (2022-04-14)

marked deprecated

  • virtual int openWithCustomSource(int64_t startPos, media::base::IMediaPlayerCustomDataProvider* provider) = 0

API (2022-04-14)

AgoraOptional.h

Deleted: Fix unuse parameter warnings.

API (2022-04-13)

AgoraBase.h

Deleted: Remove AUDIO_SCENARIO_HIGH_DEFINITION for AUDIO_SCENARIO_TYPE

API (2022-04-15)

AgoraBase.h

Modified: modify comment

API (2022-04-20)

AgoraBase.h

Add:

  • SpatialAudioParams::speaker_attenuation

API (2022-04-14)

add params to struct MediaSource

IAgoraMediaPlayerSource.h

Add:

IAgoraMediaPlayerSource.h

API (2021-04-09)

AgoraBase.h

Add:

  • enum EXPERIENCE_POOR_REASON
  • RemoteAudioStats.qualityChangedReason

API (2022-4-1)

AgoraBase.h

Delete:

  • Delete IVideoEncodedImageReceiver

API (2022-4-1)

AgoraMediaBase.h

Add:

API (2022-04-08)

AgoraBase.h

Add:

  • enum TCcMode
  • struct SenderOptions

API (2022-3-31)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_AUDIO_OBOE_ENABLE_EXCLUSIVE_MODE

API (2022-3-31)

AgoraBase.h

Add:

  • struct LowlightEnhanceOptions
  • struct VideoDenoiserOptions
  • struct ColorEnhanceOptions

API (2022-03-28)

AgoraMediaBase.h

Add:

  • AudioPcmFrame::source_type
  • AudioPcmFrame::handle_timing
  • IAudioFrameObserverBase::AudioFrame::source_type
  • IAudioFrameObserverBase::AudioFrame::handle_time_us

API (2022-3-24)

AgoraMediaBase.h

Modified:

  • Change VideoSubscribtionOptions vars from raw type to Optional
  • Delete a explicit constructor of VideoSubscribtionOptions

API (2022-3-23)

Add: Add alphaBuffer to VideoFrame.

API (2022-03-22)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_AUDIO_INPUT_CHANNELS

API (2022-03-17)

AgoraMediaBase.h

Add:

  • enum AUDIO_FRAME_POSITION
  • struct AudioParams

Add Interface for IAudioFrameObserver:

  • virtual int getObservedAudioFramePosition() = 0;
  • virtual AudioParams getPlaybackAudioParams() = 0;
  • virtual AudioParams getRecordAudioParams() = 0;
  • virtual AudioParams getMixedAudioParams() = 0;

API (2022-03-15)

Add field in struct LocalAudioStats

AgoraBase.h

Modified: add audioDeviceDelay in struct LocalAudioStats

  • struct LocalAudioStats
  • audioDeviceDelay

API (2022-03-05)

AgoraBase.h

Add:

  • QUALITY_ADAPT_INDICATION quality_adapt_indication

API (2022-03-01)

AgoraBase.h

Add:

  • AUDIO_EFFECT_PRESET::ROOM_ACOUSTICS_VIRTUAL_SURROUND_SOUND

API (2022-02-28)

AgoraBase.h

** Del:**

  • make CHANNEL_PROFILE_COMMUNICATION_1v1 deprecated

API (2022-02-28)

multiple head files

Modified:

  • fix param warnings on xcode

API (2022-02-25)

add HKMC and US Area Code

AgoraBase.h

Add: add HKMC and US Area Code

API (2022-02-24)

AgoraBase.h

Add:

  • add LOCAL_AUDIO_STREAM_ERROR_NO_RECORDING_DEVICE
  • add LOCAL_AUDIO_STREAM_ERROR_NO_PLAYOUT_DEVICE
  • add LOCAL_AUDIO_STREAM_ERROR_INTERRUPTED
  • add LOCAL_AUDIO_STREAM_ERROR_RECORD_INVALID_ID
  • add LOCAL_AUDIO_STREAM_ERROR_PLAYOUT_INVALID_ID

API (2022-02-16)

AgoraBase.h

Add:

  • add AUDIO_RECORDING_QUALITY_ULTRA_HIGH for enum AUDIO_RECORDING_QUALITY_TYPE
  • add recordingChannel for struct AudioRecordingConfiguration
  • Add params SegmentationProperty for virtual background Setting

API (2022-02-11)

API (2022-01-24)

add function: play and cache at the same time

AgoraMediaPlayerTypes.h

Add:

  • MEDIA_PLAYER_EVENT PLAYER_EVENT_REACH_CACHE_FILE_MAX_COUNT
  • MEDIA_PLAYER_EVENT PLAYER_EVENT_REACH_CACHE_FILE_MAX_SIZE
  • struct CacheStatistics;
  • struct MediaSource;

IAgoraMediaPlayerSource.h

Add:

  • virtual int openWithMediaSource(const media::base::MediaSource &source) = 0;

API (2021-11-16)

AgoraBase.h

Modified:

  • enum ERROR_CODE_TYPE adds "ERR_INVALID_USER_ACCOUNT = 134"

API (2022-02-10)

AgoraBase.h

Add:

  • enum AUDIO_SESSION_OPERATION_RESTRICTION

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_AUDIO_KEEP_AUDIOSESSION

API (2022-02-08)

AgoraBase.h

Add:

  • add struct VideoSubscriptionOptions

API (2022-01-29)

AgoraMediaBase.h

Add:

  • struct AudioEncodedFrameInfo

API (2022-02-09)

AgoraBase.h

Modified:

  • struct EncodedVideoFrameInfo(remove renderTimeMs/internalSendTs, add captureTimeMs)
  • struct EncodedAudioFrameInfo(add captureTimeMs)

API (2022-02-14)

AgoraBase.h

Add:

  • enum VIDEO_VIEW_SETUP_MODE::VIDEO_VIEW_SETUP_REPLACE

API (2022-01-27)

AgoraMediaPlayerTypes.h

IAgoraMediaPlayerSource.h

Modified:

  • enum MEDIA_PLAYER_STATE
  • enum MEDIA_PLAYER_ERROR
  • enum MEDIA_PLAYER_EVENT
  • struct PlayerUpdatedInfo
  • onPlayerEvent

API (2022-01-21)

AgoraBase.h

Modify:

  • LOCAL_VIDEO_STREAM_ERROR_CAPTURE_INBACKGROUND
  • LOCAL_VIDEO_STREAM_ERROR_CAPTURE_MULTIPLE_FOREGROUND_APPS
  • LOCAL_VIDEO_STREAM_ERROR_DEVICE_NOT_FOUND
  • LOCAL_VIDEO_STREAM_ERROR_DEVICE_DISCONNECTED
  • LOCAL_VIDEO_STREAM_ERROR_DEVICE_INVALID_ID
  • LOCAL_VIDEO_STREAM_ERROR_DEVICE_SYSTEM_PRESSURE
  • LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_OCCLUDED
  • LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_NOT_SUPPORTED

API (2021-12-02)

AgoraBase.h

AgoraMediaBase.h

Modified:

  • Change sampleCount in AudioPcmDataInfo to samplesPerChannel and channelNum

API (2021-12-28)

AgoraMediaBase.h

Add:

  • struct AdvancedAudioOptions
  • enum AUDIO_PROCESSING_CHANNELS

API (2021-12-27)

AgoraBase.h

Deleted:

  • AUDIO_REVERB_PRESET
  • VOICE_CHANGER_PRESET

API (2021-12-20)

AgoraMediaBase.h

Add: add texture related parameters into VideoFrame. eg: sharedContext,textureId and matrix

API (2022-02-15)

AgoraMediaBase.h

Add:

API (2022-04-20)

AgoraMediaBase.h

Modify:

API (2021-12-23)

AgoraBase.h

Add:

  • struct SpatialAudioParams

API (2021-12-27)

AgoraBase.h

Add: Update VideoTrackInfo

  • uint32_t observationPosition;

AgoraMediaBase.h

Add: Update IVideoFrameObserver

  • bool onPreEncodeVideoFrame(VideoFrame& videoFrame)
  • bool onSecondaryPreEncodeCameraVideoFrame(VideoFrame& videoFrame)
  • bool onPreEncodeScreenVideoFrame(VideoFrame& videoFrame)
  • bool onSecondaryPreEncodeScreenVideoFrame(VideoFrame& videoFrame)
  • uint32_t getObservedFramePosition()

API (2021-12-20)

AgoraMediaBase.h

Add: add texture related parameters matrix into ExternalVideoFrame.

API (2021-12-10)

AgoraBase.h

Add:

  • QUALITY_ADAPT_INDICATION quality_adapt_indication

API (2021-12-10)

AgoraBase.h

Add:

  • CONNECTION_CHANGED_SAME_UID_LOGIN = 19
  • CONNECTION_CHANGED_TOO_MANY_BROADCASTERS = 20
  • enum CLIENT_ROLE_CHANGE_FAILED_REASON

API (2021-12-27)

AgoraBase.h

Add: RTMP_STREAM_UNPUBLISH_ERROR_OK = 100

API (2021-12-24)

IAgoraMediaPlayerSource.h

Add:

  • onAudioVolumeIndication

API (2021-12-20)

AgoraMediaBase.h

Add: add texture related parameters into VideoFrame. eg: sharedContext,textureId and matrix

API (2020-12-02)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_AUDIO_OBOE_ENABLE
  • Add new key KEY_RTC_AUDIO_ENABLE_HARDWARE_EAR_MONITOR

API (2021-12-02)

support AES-XTS/AES-GCM/AES-ECB for media packet encryption

AgoraBase.h

Add: ENCRYPTION_MODE

  • AES_128_XTS
  • AES_128_ECB
  • AES_256_XTS
  • AES_128_GCM
  • AES_256_GCM

API (2021-12-1)

AgoraBase.h Modify LiveTranscoding:add mutiple watermark and background image

Add: add AdvancedFeature

API (2021-11-30)

AgoraBase.h

Modified:

API (2021-11-24)

AgoraBase.h AgoraMediaBase.h Modify

  • Replace tab with spaces
  • Adjust code indent

API (2021-11-24)

AgoraBase.h Add:

  • enum EXPERIENCE_QUALITY_TYPE
  • RemoteAudioStats.qoeQuality

API (2021-11-17)

AgoraBase.h

Add:

  • struct DeviceInfo

API (2021-11-02)

AgoraBase.h

Modify

  • Make parameter const in copy assignment function

API (2021-10-29)

AgoraBase.h

Add

  • AGORA_IID_CLOUD_SPATIAL_AUDIO
  • AGORA_IID_LOCAL_SPATIAL_AUDIO

API (2021-11-16)

IAgoraMediaPlayerSource.h

Modified:

  • virtual void onPlayerInfoUpdated(const media::base::PlayerUpdatedInfo& info) = 0;

AgoraMediaPlayerTypes.h

Add:

  • PlayerUpdatedInfo

API (2021-10-29)

IAgoraMediaPlayerSource.h

Modified:

  • virtual void onPlayerInfoUpdated(const media::base::PlayerUpdatedInfo& info) = 0;

AgoraMediaPlayerTypes.h

Add:

  • PlayerUpdatedInfo

API (2021-10-22)

AgoraBase.h

Add:

  • LOCAL_VIDEO_STREAM_ERROR.LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_MINIMIZED = 11
  • LOCAL_VIDEO_STREAM_ERROR.LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_CLOSED = 12

API (2021-10-19)

AgoraBase.h

Modified:

  • Change the structure name from AudioFileRecordingConfig to AudioRecordingConfiguration

API (2020-09-29)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_AUDIO_FORCE_BLUETOOTH_A2DP
  • Add new key KEY_RTC_AUDIO_USE_MEDIA_VOLUME_IN_BLUETOOTH

API (2021-09-27)

AgoraMediaBase.h

Add:

API (2021-10-12)

AgoraBase.h

Add:

  • double voicePitch for struct AudioVolumeInfo

API (2021-10-11)

Add: AUDIENCE_LATENCY_LEVEL_TYPE.AUDIENCE_LATENCY_LEVEL_HIGH_LATENCY = 3

API (2021-09-26)

AgoraMediaBase.h

Add:

  • Add EXTERNAL_VIDEO_SOURCE_TYPE

API (2021-09-30)

delete rtc.enable_built_in_media_encryption

IAgoraParameter.h

Deleted:

  • rtc.enable_built_in_media_encryption

API (2021-10-09)

add new enum in MPK module add new parameter in onPlayerEvent

AgoraMediaPlayerTypes.h

Add:

  • PLAYER_PRELOAD_EVENT:PLAYER_PRELOAD_EVENT_BEGIN
  • PLAYER_PRELOAD_EVENT:PLAYER_PRELOAD_EVENT_COMPLETE
  • PLAYER_PRELOAD_EVENT:PLAYER_PRELOAD_EVENT_ERROR
  • MEDIA_PLAYER_EVENT:PLAYER_EVENT_SWITCH_BEGIN
  • MEDIA_PLAYER_EVENT:PLAYER_EVENT_SWITCH_COMPLETE
  • MEDIA_PLAYER_EVENT:PLAYER_EVENT_SWITCH_ERROR
  • MEDIA_PLAYER_EVENT:PLAYER_EVENT_FIRST_DISPLAYED
  • MEDIA_PLAYER_EVENT:PLAYER_EVENT_IDS_UPDATE

IAgoraMediaPlayerSource.h

Add:

  • Add new parameter int64_t elapsedTime
  • Add new parameter const char* message
  • onPlayerEvent()
  • int openWithAgoraCDNSrc(const char* src, int64_t startPos)
  • int getAgoraCDNLineCount()
  • int switchAgoraCDNLineByIndex(int index)
  • int getCurrentAgoraCDNIndex()
  • int enableAutoSwitchAgoraCDN(bool enable)
  • int renewAgoraCDNSrcToken(const char* token, int64_t ts)
  • int switchAgoraCDNSrc(const char* src, bool syncPts = false)
  • int switchSrc(const char* src, bool syncPts)
  • int preloadSrc(const char* src, int64_t startPos)
  • int playPreloadedSrc(const char* src)

API (2021-11-6)

Add gateway rtt in Rtcstats

AgoraBase.h

API (2021-09-23)

Add copy assignment operator and copy constructor

AgoraBase.h

Add:

  • EncodedVideoFrameInfo& operator=(const EncodedVideoFrameInfo& rhs)
  • VideoEncoderConfiguration& operator=(const VideoEncoderConfiguration& rhs)

AgoraMediaBase.h

Add:

  • AudioPcmFrame(const AudioPcmFrame& src)

API (2021-09-17)

time_utils.h

Modified:

  • C98 standard update

API (2021-09-24)

AgoraBase.h

Add:

  • Add struct VirtualBackgroundSource for virtual background Setting

API (2021-09-03)

AgoraBase.h

Add:

  • Add RELAY_EVENT_PAUSE_SEND_PACKET_TO_DEST_CHANNEL_SUCCESS for CHANNEL_MEDIA_RELAY_EVENT
  • Add RELAY_EVENT_PAUSE_SEND_PACKET_TO_DEST_CHANNEL_FAILED for CHANNEL_MEDIA_RELAY_EVENT
  • Add RELAY_EVENT_RESUME_SEND_PACKET_TO_DEST_CHANNEL_SUCCESS for CHANNEL_MEDIA_RELAY_EVENT
  • Add RELAY_EVENT_RESUME_SEND_PACKET_TO_DEST_CHANNEL_FAILED for CHANNEL_MEDIA_RELAY_EVENT

API (2021-09-02)

AgoraBase.h

Add:

  • Add thread priority definition

API (2021-08-12)

add time_utils.h

time_utils.h

Add:

  • add class NtpTime

API (2021-10-19)

AgoraBase.h

Deleted:

  • AudioVolumeInfo.userId

API (2021-09-15)

IAgoraParameter.h

Add:

  • Add KEY_RTC_VIDEO_HW_DECODER_PROVIDER

API (2021-08-21)

AgoraBase.h

Add:

  • Add ULTRA_HIGH_QUALITY_VOICE for VOICE_BEAUTIFIER_PRESET

API (2021-08-27)

Update class IVideoFrameObserver

AgoraMediaBase.h

Modified:

  • Changes int getRotationApplied() to bool getRotationApplied()

API (2021-09-24)

AgoraBase.h

Modified: Update TranscodingVideoStream

  • Changes sourceType from VIDEO_SOURCE_TYPE to MEDIA_SOURCE_TYPE

AgoraMediaBase.h

Add: Update MEDIA_SOURCE_TYPE

  • Add AUDIO_PLAYOUT_SOURCE = 0,
  • Add AUDIO_RECORDING_SOURCE = 1,
  • Add PRIMARY_CAMERA_SOURCE = 2,
  • Add SECONDARY_CAMERA_SOURCE = 3,
  • Add PRIMARY_SCREEN_SOURCE = 4,
  • Add SECONDARY_SCREEN_SOURCE = 5,
  • Add CUSTOM_VIDEO_SOURCE = 6,
  • Add MEDIA_PLAYER_SOURCE = 7,
  • Add RTC_IMAGE_PNG_SOURCE = 8,
  • Add RTC_IMAGE_JPEG_SOURCE = 9,
  • Add RTC_IMAGE_GIF_SOURCE = 10,
  • Add REMOTE_VIDEO_SOURCE = 11,
  • Add TRANSCODED_VIDEO_SOURCE = 12,
  • Add UNKNOWN_MEDIA_SOURCE = 100

API (2021-08-05)

Add a non-const version of operator->

AgoraOptional.h

Add:

  • T* Optional::operator->()

API (2021-07-29)

Add types of enum REMOTE_VIDEO_STATE_REASON Add client role options

AgoraBase.h

Add:

  • REMOTE_VIDEO_STATE_REASON_VIDEO_STREAM_TYPE_CHANGE_TO_LOW = 10,
  • REMOTE_VIDEO_STATE_REASON_VIDEO_STREAM_TYPE_CHANGE_TO_HIGH = 11,
  • enum AUDIENCE_LATENCY_LEVEL_TYPE
  • struct ClientRoleOptions

API (2021-07-15)

Add types of enum REMOTE_VIDEO_STATE_REASON

AgoraBase.h

Add:

  • REMOTE_VIDEO_STATE_REASON_VIDEO_STREAM_TYPE_CHANGE_TO_LOW = 10,
  • REMOTE_VIDEO_STATE_REASON_VIDEO_STREAM_TYPE_CHANGE_TO_HIGH = 11,

API (2021-07-20)

AgoraBase.h

Add:

  • Add struct BeautyOptions for Beauty Parameter Setting

API (2021-07-19)

AgoraMediaBase.h

Modified:

  • onPlaybackAudioFrameBeforeMixing(uid_t uid, AudioFrame& audioFrame) to onPlaybackAudioFrameBeforeMixing(base::user_id_t userId, AudioFrame& audioFrame)

    API (2021-07-15)

AgoraMediaBase.h

Add:

  • add AUDIO_DUAL_MONO_MODE

API (2021-08-30)

AgoraMediaBase.h

Add:

  • add enum CONTENT_INSPECT_TYPE
  • add struct ContentInspectModule
  • add struct ContentInspectConfig
  • add struct SnapShotConfig
  • add class ISnapshotCallback

API (2021-07-06)

AgoraMediaBase.h

Modified:

  • void onFrame(AudioPcmFrame* frame)

API (2021-06-18)

Add methods for media player source

IAgoraMediaPlayerSource.h

Add:

  • add method muteAudio()
  • add method isAudioMuted()
  • add method muteVideo()
  • add method isVideoMuted()

API (2021-06-15)

Add methods for streaming source interfance and observer

IAgoraMediaStreamingSource.h

Add:

  • add method IMediaStreamingSource::parseMediaInfo()
  • add method IMediaStreamingSourceObserver::onOpenDone()
  • add method IMediaStreamingSourceObserver::onSeekDone()

API (2021-08-16)

AgoraBase.h

Add:

  • VideoTrackInfo.channelId

Delete:

  • RtcStats.connectionId
  • VideoTrackInfo.connectionId
  • TranscodingVideoStream.connectionId

AgoraMediaBase.h

Modified:

  • bool onRenderVideoFrame(rtc::uid_t uid, rtc::conn_id_t connectionId, VideoFrame& videoFrame) to bool onRenderVideoFrame(const char* channelId, rtc::uid_t remoteUid, VideoFrame& videoFrame)

API (2021-07-21)

AgoraBase.h

Add:

  • add ERR_NO_SERVER_RESOURCES to ERROR_CODE_TYPE

API (2021-09-15)

AgoraBase.h

Add:

  • AUDIO_CODEC_TYPE.AUDIO_CODEC_LPCNET

API (2021-07-21)

AgoraMediaBase.h

Add:

  • class IAudioFrameObserverBase
  • onPlaybackAudioFrameBeforeMixing(base::user_id_t userId, AudioFrame& audioFrame)

API (2021-11-09)

AgoraBase.h

Add:

  • RemoteAudioStats.totalActiveTime
  • RemoteAudioStats.publishDuration

API (2020-07-06)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_AUDIO_FORCE_USE_MEDIA_VOLUME

API (2021-06-07)

Rename AES-GCM to AES-GCM2

API (2021-07-06)

AgoraMediaBase.h

Add:

  • Add AudioRoute::ROUTE_HDMI
  • Add AudioRoute::ROUTE_USB

AgoraBase.h

Modified:

  • rename ENCRYPTION_MODE::AES_128_GCM to ENCRYPTION_MODE::AES_128_GCM2
  • rename ENCRYPTION_MODE::AES_256_GCM to ENCRYPTION_MODE::AES_256_GCM2

API (2020-05-31)

Parse media info from url.

IAgoraMediaStreamingSource.h

Add:

  • ParseMediaInfo

API (2021-05-25)

adding operator== function for VideoDimensions and SimulcastStreamConfig

AgoraBase.h

Add:

  • bool operator==(const VideoDimensions& rhs) const
  • bool operator==(const SimulcastStreamConfig& rhs) const

API (2020-05-24)

Support compute audio spectrum.

AgoraMediaBase.h

Modified:

  • Update comments

API (2021-05-22)

Modify note of AUDIO_SCENARIO_TYPE::AUDIO_SCENARIO_CHATROOM

AgoraBase.h

Modified:

  • note of AUDIO_SCENARIO_TYPE::AUDIO_SCENARIO_CHATROOM

API (2021-06-02)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_ENABLE_BUILT_IN_MEDIA_ENCRYPTION

API (2020-05-15)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_AUDIO_INPUT_SAMPLE_RATE

API (2020-05-13)

Support compute audio spectrum.

AgoraMediaBase.h

Modified:

  • struct UserAudioSpectrumInfo
  • IAudioSpectrumObserver

API (2021-05-12)

IAgoraParameter.h

Add: Add parameter key KEY_RTC_AUDIO_MAX_TARGET_DELAY

API (2020-05-11)

Support Freeze check on media player based ffmpeg.

AgoraMediaPlayerTypes.h

Add: Add in definition of MEDIA_PLAYER_EVENT

  • PLAYER_EVENT_FREEZE_START
  • PLAYER_EVENT_FREEZE_STOP

API (2021-05-10)

Add some protection

AgoraBase.h

Modified:

  • DownlinkNetworkInfo

API (2021-05-06)

Add switches for c++11 features

API (2020-05-05)

Support R/W recording audio frame observer.

AgoraMediaBase.h

Modified: Move in definition of RAW_AUDIO_FRAME_OP_MODE_TYPE

API (2021-05-06)

Delete RemoteVideoStreamInfo and refine DownlinkNetworkInfo.

AgoraBase.h

Deleted:

  • RemoteVideoStreamInfo

Modified:

  • refine DownlinkNetworkInfo.

API (2020-04-30)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_AUDIO_OPENSL_MODE

API (2020-04-29)

AgoraBase.h

Add:

  • AUDIO_SCENARIO_TYPE::AUDIO_SCENARIO_CHORUS

API (2021-04-30)

AgoraBase.h

Add:

  • LOCAL_VIDEO_STREAM_ERROR::LOCAL_VIDEO_STREAM_ERROR_BACKGROUD
  • LOCAL_VIDEO_STREAM_ERROR::LOCAL_VIDEO_STREAM_ERROR_MULTIPLE_FOREGROUND_APPS
  • LOCAL_VIDEO_STREAM_ERROR::LOCAL_VIDEO_STREAM_ERROR_SYSTEM_PRESSURE

API (2021-04-28)

AgoraBase.h

Add:

  • Add field mosValue for struct RemoteAudioStats

API (2021-04-20)

Support AES-GCM encryption for media packet

AgoraBase.h

Add:

  • ENCRYPTION_MODE::AES_128_GCM
  • ENCRYPTION_MODE::AES_256_GCM
  • EncryptionConfig::encryptionKdfSalt

API (2020-04-19)

Add copy assignment for AudioPcmFrame.

AgoraMediaBase.h

Add: Add AudioPcmFrame & operator=(const AudioPcmFrame & src)

API (2020-04-19)

Add audio effect preset enum.

AgoraBase.h

Add: Add VOICE_BEAUTIFIER_PRESET, AUDIO_EFFECT_PRESET, VOICE_CONVERSION_PRESET

API (2021-04-16)

AgoraMediaBase.h

Add:

  • Add new struct AudioSpectrumInfo
  • Add new interface IAudioSpectrumObserver

    API (2021-04-07)

AgoraBase.h

Add:

  • add AudioEncodedFrameObserverConfig
  • add IAudioEncodedFrameObserver

API (2021-04-15)

Add support for win arm64

AgoraBase.h

Add:

  • Add support for win arm64

Deleted:

  • ENCRYPTION_MODE::AES_128_XTS
  • ENCRYPTION_MODE::AES_128_ECB
  • ENCRYPTION_MODE::AES_256_XTS

API (2021-04-15)

add chatroom audio scenario

AgoraBase.h

Deleted:

  • Deleted enum AUDIO_SCENARIO_TYPE::AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT
  • Deleted enum AUDIO_SCENARIO_TYPE::AUDIO_SCENARIO_EDUCATION
  • Deleted enum AUDIO_SCENARIO_TYPE::AUDIO_SCENARIO_SHOWROOM

Modify:

  • modify enum AUDIO_SCENARIO_TYPE::AUDIO_SCENARIO_CHATROOM_GAMING to AUDIO_SCENARIO_TYPE::AUDIO_SCENARIO_CHATROOM

API (2021-04-06)

AgoraMediaBase.h

Add:

  • Add new interface IVideoEncodedFrameObserver

API (2021-03-31)

IAgoraMediaStreamingSource.h

Add:

  • add interface IMediaStreamingSource

API (2021-03-26)

Add new parameters in ScreenCaptureParameters

AgoraBase.h

Add:

  • Add new parameter bool captureMouseCursor
  • Add new parameter bool windowFocus

API (2021-03-24)

AgoraBase.h

Add:

  • add struct EAR_MONITORING_FILTER_TYPE

API file name #2

API (2021-04-22)

AgoraMediaPlayerTypes.h

Add:

  • Add new enum value MEDIA_PLAYER_ERROR::PLAYER_ERROR_NO_PERMISSION
  • Add new enum value MEDIA_PLAYER_ERROR::PLAYER_ERROR_INTERRUPTED

API (2020-04-01)

add MEDIA_PLAYER_EVENT enum and api in AgoraMediaPlayerTypes.h

AgoraMediaPlayerTypes.h

Add:

  • add PLAYER_EVENT_BUFFER_LOW and PLAYER_EVENT_BUFFER_RECOVER

IAgoraMediaPlayerSource.h

Add:

  • setPlayerOption
  • onPlayBufferUpdated

API (2020-03-26)

modify struct VideoTrackInfo

API (2021-03-25)

AgoraBase.h

Add:

  • add DataStreamConfig

API (2020-03-19)

modify to adapt c++ 11

API (2021-03-11)

AgoraBase.h

Add:

  • add err_num : ERR_PCMSEND_FORMAT and ERR_PCMSEND_BUFFEROVERFLOW

API (2021-03-09)

Modify PLAYER_STATE_STOPPED

AgoraMediaPlayerTypes.h

Modify:

  • PLAYER_STATE_STOPPED

API (2021-03-09)

Add new parameters in ScreenCaptureParameters

AgoraBase.h

Add:

  • Add new parameter view_t *excludeWindowList
  • Add new parameter int excludeWindowCount

API (2021-02-19)

Add VIDEO_CODEC_GENERIC_JPEG enum Add parameter key

AgoraBase.h

Add:

  • Add VIDEO_CODEC_GENERIC_JPEG

IAgoraParameter.h

Add: Add parameter key KEY_RTC_VIDEO_CODEC_TYPE

API (2021-01-28)

Add new configurable keys

IAgoraParameter.h

Add:

  • Add new key KEY_RTC_VIDEO_HW_ENCODER_PROVIDER

API (2021-11-17)

AgoraMediaBase.h

Modified:

  • IAudioFrameObserverBase::onRecordAudioFrame(const char* channelId, AudioFrame& audioFrame)
  • IAudioFrameObserverBase::onPlaybackAudioFrame(const char* channelId, AudioFrame& audioFrame)
  • IAudioFrameObserverBase::onMixedAudioFrame(const char* channelId, AudioFrame& audioFrame)
  • IAudioFrameObserverBase::onPlaybackAudioFrameBeforeMixing(const char* channelId, base::user_id_t userId, AudioFrame& audioFrame)
  • IAudioFrameObserver::onPlaybackAudioFrameBeforeMixing(const char* channelId, rtc::uid_t uid, AudioFrame& audioFrame)

API (2021-01-12)

Change definition of bytes_per_sample without channel

AgoraMediaBase.h

Add:

  • enum BYTES_PER_SAMPLE

Modified:

  • change param type of AudioFrame::bytesPerSample from size_t to enum BYTES_PER_SAMPLE

API (2021-01-21)

Change enum order

AgoraBase.h

Modified:

  • Change the order of VIDEO_SOURCE_CUSTOM and VIDEO_SOURCE_MEDIA_PLAYER

API file name #2

API (2021-03-03)

API (2020-12-24)

AgoraMediaBase.h

Add:

  • enum MAX_METADATA_SIZE_TYPE
  • Add metadata_buffer and metadata_size for struct ExternalVideoFrame

API (2020-12-11)

AgoraBase.h

Modified: getAograCertificateVerifyResult —> getAgoraCertificateVerifyResult

API (2020-12-07)

AgoraBase.h

Add:

Deleted: License's API

  • int agora_genCredential(agora::util::AString &credential, const char <em>path)
  • int agora_verifyCertificate(const char *cert, const char *path);
  • void agora_registerLicenseCallback(agora::base::LicenseCallback callback);
  • void agora_unregisterLicenseCallback();

API (2020-12-21)

Add:

AgoraBase.h

  • Add enum STREAM_SUBSCRIBE_STATE
  • Add enum STREAM_PUBLISH_STATE

API (2020-10-16)

Modify the comments of DEGRADATION_PREFERENCE.

AgoraBase.h

Modify:

  • enum DEGRADATION_PREFERENCE

API (2020-10-12)

Add camera direction for configuration.

AgoraBase.h

Add:

  • enum CAMERA_DIRECTION
  • struct CameraCapturerConfiguration

API (2020-09-28)

Add mirror mode to VideoEncoderConfiguration.

AgoraBase.h

Add:

  • Mirror mode (VIDEO_MIRROR_MODE_TYPE) in VideoEncoderConfiguration

API (2020-09-27)

Add mirror mode to VideoCanvas.

AgoraBase.h

Add:

  • Mirror mode (VIDEO_MIRROR_MODE_TYPE) in VideoCanvas

API (2021-02-02)

Add DownlinkNetworkInfo and modify NetworkInfo

AgoraBase.h

Add:

  • struct DownlinkNetworkInfo

Modified:

  • Changes struct NetworkInfo to struct UplinkNetworkInfo

API (2020-09-23)

AgoraBase.h

Add:

  • Add VIDEO_SOURCE_MEDIA_PLAYER for enum VIDEO_SOURCE_TYPE
  • Add field priv_size for struct VideoCanvas

AgoraMediaBase.h

Add:

  • Add onMediaPlayerVideoFrame() member function for IVideoFrameObserver

API (2020-11-25)

Modify REMOTE_VIDEO_STREAM_TYPE.

AgoraBase.h

Add:

  • enum VIDEO_STREAM_TYPE

Deleted:

  • Deleted enum REMOTE_VIDEO_STREAM_TYPE

Modified:

  • Changes Add VIDEO_STREAM_TYPE streamType to EncodedVideoFrameInfo

API (2020-11-24)

Add tx/rxPacketLossRate in RtcStats.

AgoraBase.h

Add:

  • RtcStats::txPacketLossRate
  • RtcStats::rxPacketLossRate

API (2020-11-14)

AgoraMediaPlayerTypes.h

Add:

- MEDIA_PLAYER_STATE::PLAYER_STATE_PLAYBACK_ALL_LOOPS_COMPLETED

API (2020-11-12)

  • CHANNEL_PROFILE_TYPE::CHANNEL_PROFILE_LIVE_BROADCASTING2

AgoraBase.h

CHANNEL_PROFILE_TYPE::CHANNEL_PROFILE_LIVE_BROADCASTING2

API (2020-11-09)

AgoraBase.h

Add: License's API

  • int agora_genCredential(agora::util::AString &credential, const char <em>path)
  • int agora_verifyCertificate(const char *cert, const char *path);
  • void agora_registerLicenseCallback(agora::base::LicenseCallback callback);
  • void agora_unregisterLicenseCallback();

License's Callback

  • class LicenseCallback;

Modified: License's Error Code Types

  • ERR_LICENSE_CREDENTIAL_INVALID = 131,
  • ERR_CERT_RAW = 157,
  • ERR_CERT_JSON_PART = 158,
  • ERR_CERT_JSON_INVAL = 159,
  • ERR_CERT_JSON_NOMEM = 160,
  • ERR_CERT_CUSTOM = 161,
  • ERR_CERT_CREDENTIAL = 162,
  • ERR_CERT_SIGN = 163,
  • ERR_CERT_FAIL = 164,
  • ERR_CERT_BUF = 165,
  • ERR_CERT_NULL = 166,
  • ERR_CERT_DUEDATE = 167,
  • ERR_CERT_REQUEST = 168,

API (2020-09-04)

AgoraBase.h

Modified: Refine AGORA_API definitions to keep aligned with agora_api.h

AgoraRefPtr.h

Modified: Add operator*().

IAgoraLog.h

Modified: Add log related constants.

IAgoraMediaPlayerSource.h

Modified: Change the 'int' parameters to 'int64_t' to keep aligned with the other APIs.

API (2020-09-09)

Modify EncodedVideoFrameInfo.

AgoraBase.h

Modify: Modify EncodedVideoFrameInfo.

  • Remove packetizationMode.

API (2020-09-11)

Add enum NETWORK_TYPE.

AgoraBase.h

Add:

  • enum NETWORK_TYPE

API (2020-09-04)

Add more methods to IVideoFrameObserver.

AgoraMediaBase.h

Modified:

  • Changes Add getVideoFormatPreference/getRotationApplied/getMirrorApplied to IVideoFrameObserver

API (2020-09-03)

AgoraBase.h

Modified: add members of RtcStats

  • packetsBeforeFirstKeyFramePacket
  • firstAudioPacketDurationAfterUnmute
  • firstVideoPacketDurationAfterUnmute
  • firstVideoKeyFramePacketDurationAfterUnmute
  • firstVideoKeyFrameDecodedDurationAfterUnmute
  • firstVideoKeyFrameRenderedDurationAfterUnmute

API (2020-08-19)

AgoraMediaBase.h

Add: OpenGL type

  • enum EGL_CONTEXT_TYPE

Add: Video Buffer types

  • VIDEO_BUFFER_TYPE::VIDEO_BUFFER_ARRAY
  • VIDEO_BUFFER_TYPE::VIDEO_BUFFER_TEXTURE

Add: Texture related parameter

  • ExternalVideoFrame::eglContext
  • ExternalVideoFrame::eglType
  • ExternalVideoFrame::textureId

API (2020-08-14)

Add enum

AgoraBase.h

Add: Add enum

  • VIDEO_SOURCE_TYPE

API (2020-08-04)

AgoraBase.h

Add:

  • AUDIO_CODEC_TYPE::AUDIO_CODEC_G722
  • AUDIO_PROFILE_TYPE::AUDIO_PROFILE_IOT

API (2020-07-29)

AgoraMediaBase.h

Add struct AudioParameters Rename some fields of struct AudioPcmFrame

API (2020-07-14)

IAgoraMediaPlayerSource.h

Modify: Change include dir.

API (2020-07-06)

AgoraBase.h

Modify: Change include dir.

API (2020-07-01)

AgoraBase.h

Modify: Remove string UID.

API (2020-06-27)

Make include path correct

API (2020-06-18)

Modify EncodedVideoFrameInfo.

AgoraBase.h

Modify: Modify EncodedVideoFrameInfo.

  • Remove packetizationMode.

API (2020-06-17) Change namespace to avoid confliect with media_server_library

AgoraOptional.h

Modified: Change namespace

  • Changes base::Optional to base_utils::Optional

API (2020-06-17)

Fix header file macro

AgoraOptional.h

Add: Add string_value to Optional

  • Optional::string_value()

Modified:

  • BASE_OPTIONAL_H_ to AGORA_OPTIONAL_H_

API (2020-05-29)

Updated docs for the following header files:

API (2020-06-22)

IAgoraMediaPlayerSource.h

Modified:

  • setLooping(bool looping) to setLoopCount(int loopCount)

API (2020-06-10)

Add NetworkInfo for feedback to user

AgoraBase.h

Add: Add NetworkInfo

  • struct NetworkInfo

API (2020-06-08)

IAgoraMediaPlayerSource.h

Add: Add new Api in Media Player

  • takeScreenshot()
  • selectInternalSubtitle()
  • setExternalSubtitle()

API (2020-06-08)

AgoraBase.h

Modified:

  • REMOTE_VIDEO_STREAM_STATE rename to REMOTE_VIDEO_STATE
  • Changes REMOTE_VIDEO_STATE_PLAYING to REMOTE_VIDEO_STATE_DECODING

REMOTE_VIDEO_STATE_REASON

  • REMOTE_VIDEO_STATE_REASON_INTERNAL
  • REMOTE_VIDEO_STATE_REASON_NETWORK_CONGESTION
  • REMOTE_VIDEO_STATE_REASON_NETWORK_RECOVERY
  • REMOTE_VIDEO_STATE_REASON_LOCAL_MUTED
  • REMOTE_VIDEO_STATE_REASON_LOCAL_UNMUTED
  • REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED
  • REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED
  • REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE
  • REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK
  • REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY

API (2020-06-03)

Move IAgoraMediaPlayerSource.h from api2 to here, and add getSourceId() for IMediaPlayerSource

Add:

AgoraMediaBase.h

Add enum MEDIA_PLAYER_SOURCE_TYPE.

API (2020-05-31)

AgoraMediaBase.h

Add:

  • Add enum MEDIA_PLAYER_PLAYBACK_SPEED.

IAgoraMeidaPlayerSource.h

Add: Add new Api in Media Player

  • setPlaybackSpeed()
  • selectAudioTrack()
  • setPlayerOption()

AgoraMeidaPlayerTypes.h

Add: Move Media Player related declaration from AgoraMediaBase.h to AgoraMeidaPlayerTypes.h

  • enum MEDIA_PLAYER_STATE
  • enum MEDIA_PLAYER_ERROR
  • enum MEDIA_PLAYER_PLAYBACK_SPEED
  • enum MEDIA_STREAM_TYPE
  • enum MEDIA_PLAYER_EVENT
  • struct MediaStreamInfo
  • enum MEDIA_PLAYER_METADATA_TYPE

AgoraMediaBase.h

Delete: Move Media Player related declaration from AgoraMediaBase.h to AgoraMeidaPlayerTypes.h

  • enum MEDIA_PLAYER_STATE
  • enum MEDIA_PLAYER_ERROR
  • enum MEDIA_PLAYER_PLAYBACK_SPEED
  • enum MEDIA_STREAM_TYPE
  • enum MEDIA_PLAYER_EVENT
  • struct MediaStreamInfo
  • enum MEDIA_PLAYER_METADATA_TYPE

API (2020-06-09)

Modify PacketOptions.

AgoraMediaBase.h

Modified: Add audioLevelIndication into PacketOptions.

  • PacketOptions: Add member audioLevelIndication

API (2020-05-28)

Modify VideoEncoderConfiguration and VIDEO_CODEC_TYPE

AgoraBase.h

Modified:

  • Add member enableGenericH264 for VideoEncoderConfiguration
  • Add new type VIDEO_CODEC_GENERIC(6) for enum VIDEO_CODEC_TYPE
  • Add new type VIDEO_FRAME_TYPE_DROPPABLE_FRAME(6) for enum VIDEO_FRAME_TYPE

API (2020-05-22)

Add:

AgoraMediaBase.h

Add enum VIDEO_OBSERVER_POSITION.

API (2020-05-12)

Add:

AgoraMediaBase.h

Add data member videoRotation in struct MediaStreamInfo.

API (2020-05-12)

Add lastmile and connection state enum

AgoraBase.h

Add: Add lastmile and connection state enum

  • enum LASTMILE_PROBE_RESULT_STATE
  • struct LastmileProbeOneWayResult
  • struct LastmileProbeResult
  • struct LastmileProbeConfig
  • enum CONNECTION_CHANGED_REASON_TYPE
  • struct LastmileProbeConfig
  • enum AUDIO_REVERB_PRESET
  • struct ScreenCaptureParameters
  • enum VOICE_CHANGER_PRESET

API (2020-05-09)

AgoraBase.h

Add: Add AUDIO_SCENARIO_HIGH_DEFINITION for AUDIO_SCENARIO_TYPE

API (2021-05-26)

Add:

AgoraBase.h

Add enum DISABLE to disable VQC to DEGRADATION_PREFERENCE

API (2021-09-15)

AgoraBase.h

Add: Add renderer struct and enum

  • Enum VIDEO_VIEW_SETUP_MODE

Add: Add Struct for Fish Correction

  • Struct FishCorrectionParams

API (2021-09-24)

AgoraBase.h

Modify: moidfy enableAudioVolumeIndication support vad

API (2022-03-25)

AgoraBase.h

Add: Add AUDIO_SCENARIO_MEETING to enum AUDIO_SCENARIO_TYPE

AgoraMediaBase.h

Add: Add ROUTE_DISPLAYPORT and ROUTE_AIRPLAY to enum AudioRoute

API (2022-04-29)

AgoraBase.h

Delete: Delete useless iOS adm error code

API (2022-05-09)

AgoraBase.h

Add

  • AGORA_IID_MEDIA_RECORDER

AgoraMediaBase.h

Add: Add Struct adn Enum for MediaRecorder

  • Enum MediaRecorderContainerFormat
  • Enum MediaRecorderStreamType
  • Enum RecorderState
  • Enum RecorderErrorCode
  • Struct MediaRecorderConfiguration
  • Struct RecorderInfo
  • Class IMediaRecorderObserver

API (2022-06-07)

AgoraBase.h

Add:

REMOTE_VIDEO_STATE_REASON

  • REMOTE_VIDEO_STATE_REASON_SDK_IN_BACKGROUND

API (2022-05-16)

AgoraBase.h

Add

  • ScreenCaptureParameters add highLightColor,highLightWidth,enableHighLight

API (2021-06-09)

AgoraMediaBase.h

Modified:

  • virtual void OnEncodedVideoFrameReceived (rtc::uid_t uid, const uint8_t* imageBuffer, size_t length,const rtc::EncodedVideoFrameInfo& videoEncodedFrameInfo) = 0;

API (2021-06-13)

AgoraBase.h

Modified:

  • FishCorrectionParams to FishEyeCorrectionParams and use CamelCase

API (2021-06-29)

AgoraBase.h

Delete:

  • delete FishEyeCorrectionParams