Merge branch 'release/rtc-ng/4.3' of https://github.com/AgoraIO/agora_doc_source into release/rtc-ng/4.3

jinyuagora · jinyuagora · commit e7289e36064a · 2024-01-25T11:09:37.000+08:00
diff --git a/markdown/RTC 4.x/release-notes/en-US/framework/release_electron_ng.md b/markdown/RTC 4.x/release-notes/en-US/framework/release_electron_ng.md
@@ -41,8 +41,8 @@ This release has optimized the implementation of some functions, involving renam
 
    This release makes the following modifications to the enumerations in the [LocalVideoStreamReason](API/enum_localvideostreamreason.html) class:
 
-   - The value of `LocalVideoStreamReasonScreenCapturePaused` (formerly `LocalVideoStreamReasonScreenCapturePaused`) has been changed from 23 to 28. (Windows)
-   - The value of `LocalVideoStreamReasonScreenCaptureResumed` (formerly `LocalVideoStreamReasonScreenCaptureResumed`) has been changed from 24 to 29. (Windows)
+   - The value of `LocalVideoStreamReasonScreenCapturePaused` (formerly `LocalVideoStreamReasonScreenCapturePaused`) has been changed from 23 to 28.
+   - The value of `LocalVideoStreamReasonScreenCaptureResumed` (formerly `LocalVideoStreamReasonScreenCaptureResumed`) has been changed from 24 to 29.
    - The `LocalVideoStreamReasonCodecNotSupport` enumeration has been changed to `LocalVideoStreamReasonCodecNotSupport`.
 
 4. **Audio loopback capturing**
@@ -85,7 +85,7 @@ This release has optimized the implementation of some functions, involving renam
 
    This release optimizes the scheduling mechanism for internal tasks within the SDK, with improvements in the following aspects:
 
-   - The speed of vieo rendering and audio playback for both remote and local first frames improves by 10% to 20%.
+   - The speed of video rendering and audio playback for both remote and local first frames improves by 10% to 20%.
    - The API call duration and response time are reduced by 5% to 50%.
    - The SDK's parallel processing capability significantly improves, delivering higher video quality (720P, 24 fps) even on lower-end devices. Additionally, image processing remains more stable in scenarios involving high resolutions and frame rates.
    - The stability of the SDK is further enhanced, leading to a noticeable decrease in the crash rate across various specific scenarios.
@@ -107,7 +107,7 @@ This release has optimized the implementation of some functions, involving renam
 
    This release also includes the following improvements:
 
-   - The [onLocalVideoStateChanged](API/callback_irtcengineeventhandler_onlocalvideostatechanged.html) callback is improved with the inclusion of the `LocalVideoStreamReasonScreenCaptureAutoFallback` enumeration, singaling unexpected errors during the screen sharing process (potentially due to window blocking failure), resulting in performance degradation without impacting the screen sharing process itself. (Windows)
+   - The [onLocalVideoStateChanged](API/callback_irtcengineeventhandler_onlocalvideostatechanged.html) callback is improved with the inclusion of the `LocalVideoStreamReasonScreenCaptureAutoFallback` enumeration, singaling unexpected errors during the screen sharing process (potentially due to window blocking failure), resulting in performance degradation without impacting the screen sharing process itself. 
    - This release optimizes the SDK's domain name resolution strategy, improving the stability of calling to resolve domain names in complex network environments.
    - When passing in an image with transparent background as the virtual background image, the transparent background can be filled with customized color.
    - This release adds the `earMonitorDelay` and `aecEstimatedDelay` members in [LocalAudioStats](API/class_localaudiostats.html) to report ear monitor delay and acoustic echo cancellation (AEC) delay, respectively.
@@ -139,64 +139,64 @@ This release fixed the following issues:
 **Modified**
 
 - All `ERROR` fields in the following enumerations are changed to `REASON`:
-  - `LocalAudioStreamReasonOk`
-  - `LocalAudioStreamReasonFailure`
-  - `LocalAudioStreamReasonDeviceNoPermission`
-  - `LocalAudioStreamReasonDeviceBusy`
-  - `LocalAudioStreamReasonRecordFailure`
-  - `LocalAudioStreamReasonEncodeFailure`
-  - `LocalAudioStreamReasonRecordInvalidId` (Windows)
-  - `LocalAudioStreamReasonPlayoutInvalidId` (Windows)
-  - `LocalVideoStreamReasonOk`
-  - `LocalVideoStreamReasonFailure`
-  - `LocalVideoStreamReasonDeviceNoPermission`
-  - `LocalVideoStreamReasonDeviceBusy`
-  - `LocalVideoStreamReasonCaptureFailure`
-  - `LocalVideoStreamReasonCodecNotSupport`
-  - `LocalVideoStreamReasonDeviceNotFound`
-  - `LocalVideoStreamReasonDeviceDisconnected`
-  - `LocalVideoStreamReasonDeviceInvalidId`
-  - `LocalVideoStreamReasonScreenCaptureWindowMinimized`
-  - `LocalVideoStreamReasonScreenCaptureWindowClosed`
-  - `LocalVideoStreamReasonScreenCaptureWindowOccluded`
-  - `DirectCdnStreamingReasonOk`
-  - `DirectCdnStreamingReasonFailed`
-  - `DirectCdnStreamingReasonAudioPublication`
-  - `DirectCdnStreamingReasonVideoPublication`
-  - `DirectCdnStreamingReasonNetConnect`
-  - `DirectCdnStreamingReasonBadName`
-  - `PlayerReasonNone`
-  - `PlayerReasonInvalidArguments`
-  - `PlayerReasonInternal`
-  - `PlayerReasonNoResource`
-  - `PlayerReasonInvalidMediaSource`
-  - `PlayerReasonUnknownStreamType`
-  - `PlayerReasonObjNotInitialized`
-  - `PlayerReasonCodecNotSupported`
-  - `PlayerReasonVideoRenderFailed`
-  - `PlayerReasonInvalidState`
-  - `PlayerReasonUrlNotFound`
-  - `PlayerReasonInvalidConnectionState`
-  - `PlayerReasonSrcBufferUnderflow`
-  - `PlayerReasonInterrupted`
-  - `PlayerReasonNotSupported`
-  - `PlayerReasonTokenExpired`
-  - `PlayerReasonUnknown`
-  - `RtmpStreamPublishReasonOk`
-  - `RtmpStreamPublishReasonInvalidArgument`
-  - `RtmpStreamPublishReasonEncryptedStreamNotAllowed`
-  - `RtmpStreamPublishReasonConnectionTimeout`
-  - `RtmpStreamPublishReasonInternalServerError`
-  - `RtmpStreamPublishReasonRtmpServerError`
-  - `RtmpStreamPublishReasonTooOften`
-  - `RtmpStreamPublishReasonReachLimit`
-  - `RtmpStreamPublishReasonNotAuthorized`
-  - `RtmpStreamPublishReasonStreamNotFound`
-  - `RtmpStreamPublishReasonFormatNotSupported`
-  - `RtmpStreamPublishReasonNotBroadcaster`
-  - `RtmpStreamPublishReasonTranscodingNoMixStream`
-  - `RtmpStreamPublishReasonNetDown`
-  - `RtmpStreamPublishReasonInvalidPrivilege`
+  - `LocalAudioStreamErrorOk`
+  - `LocalAudioStreamErrorFailure`
+  - `LocalAudioStreamErrorDeviceNoPermission`
+  - `LocalAudioStreamErrorDeviceBusy`
+  - `LocalAudioStreamErrorRecordFailure`
+  - `LocalAudioStreamErrorEncodeFailure`
+  - `LocalAudioStreamErrorRecordInvalidId` (Windows)
+  - `LocalAudioStreamErrorPlayoutInvalidId` (Windows)
+  - `LocalVideoStreamErrorOk`
+  - `LocalVideoStreamErrorFailure`
+  - `LocalVideoStreamErrorDeviceNoPermission`
+  - `LocalVideoStreamErrorDeviceBusy`
+  - `LocalVideoStreamErrorCaptureFailure`
+  - `LocalVideoStreamErrorCodecNotSupport`
+  - `LocalVideoStreamErrorDeviceNotFound`
+  - `LocalVideoStreamErrorDeviceDisconnected`
+  - `LocalVideoStreamErrorDeviceInvalidId`
+  - `LocalVideoStreamErrorScreenCaptureWindowMinimized`
+  - `LocalVideoStreamErrorScreenCaptureWindowClosed`
+  - `LocalVideoStreamErrorScreenCaptureWindowOccluded`
+  - `DirectCdnStreamingErrorOk`
+  - `DirectCdnStreamingErrorFailed`
+  - `DirectCdnStreamingErrorAudioPublication`
+  - `DirectCdnStreamingErrorVideoPublication`
+  - `DirectCdnStreamingErrorNetConnect`
+  - `DirectCdnStreamingErrorBadName`
+  - `PlayerErrorNone`
+  - `PlayerErrorInvalidArguments`
+  - `PlayerErrorInternal`
+  - `PlayerErrorNoResource`
+  - `PlayerErrorInvalidMediaSource`
+  - `PlayerErrorUnknownStreamType`
+  - `PlayerErrorObjNotInitialized`
+  - `PlayerErrorCodecNotSupported`
+  - `PlayerErrorVideoRenderFailed`
+  - `PlayerErrorInvalidState`
+  - `PlayerErrorUrlNotFound`
+  - `PlayerErrorInvalidConnectionState`
+  - `PlayerErrorSrcBufferUnderflow`
+  - `PlayerErrorInterrupted`
+  - `PlayerErrorNotSupported`
+  - `PlayerErrorTokenExpired`
+  - `PlayerErrorUnknown`
+  - `RtmpStreamPublishErrorOk`
+  - `RtmpStreamPublishErrorInvalidArgument`
+  - `RtmpStreamPublishErrorEncryptedStreamNotAllowed`
+  - `RtmpStreamPublishErrorConnectionTimeout`
+  - `RtmpStreamPublishErrorInternalServerError`
+  - `RtmpStreamPublishErrorRtmpServerError`
+  - `RtmpStreamPublishErrorTooOften`
+  - `RtmpStreamPublishErrorReachLimit`
+  - `RtmpStreamPublishErrorNotAuthorized`
+  - `RtmpStreamPublishErrorStreamNotFound`
+  - `RtmpStreamPublishErrorFormatNotSupported`
+  - `RtmpStreamPublishErrorNotBroadcaster`
+  - `RtmpStreamPublishErrorTranscodingNoMixStream`
+  - `RtmpStreamPublishErrorNetDown`
+  - `RtmpStreamPublishErrorInvalidPrivilege`
   - `RtmpStreamUnpublishErrorOk`
 
 **Deleted**
diff --git a/markdown/RTC 4.x/release-notes/en-US/framework/release_flutter_ng.md b/markdown/RTC 4.x/release-notes/en-US/framework/release_flutter_ng.md
@@ -108,7 +108,7 @@ This release has optimized the implementation of some functions, involving renam
 
    This release optimizes the scheduling mechanism for internal tasks within the SDK, with improvements in the following aspects:
 
-   - The speed of vieo rendering and audio playback for both remote and local first frames improves by 10% to 20%.
+   - The speed of video rendering and audio playback for both remote and local first frames improves by 10% to 20%.
    - The API call duration and response time are reduced by 5% to 50%.
    - The SDK's parallel processing capability significantly improves, delivering higher video quality (720P, 24 fps) even on lower-end devices. Additionally, image processing remains more stable in scenarios involving high resolutions and frame rates.
    - The stability of the SDK is further enhanced, leading to a noticeable decrease in the crash rate across various specific scenarios.
diff --git a/markdown/RTC 4.x/release-notes/en-US/framework/release_rn_ng.md b/markdown/RTC 4.x/release-notes/en-US/framework/release_rn_ng.md
@@ -55,6 +55,8 @@ This release has optimized the implementation of some functions, involving renam
 
    This release makes the following modifications to the enumerations in the [LocalVideoStreamReason](API/enum_localvideostreamreason.html) class:
 
+   - The value of `LocalVideoStreamReasonScreenCapturePaused` (formerly `LocalVideoStreamReasonScreenCapturePaused`) has been changed from 23 to 28.
+   - The value of `LocalVideoStreamReasonScreenCaptureResumed` (formerly `LocalVideoStreamReasonScreenCaptureResumed`) has been changed from 24 to 29.
    - The `LocalVideoStreamReasonCodecNotSupport` enumeration has been changed to `LocalVideoStreamReasonCodecNotSupport`.
 
 #### New features
@@ -98,7 +100,7 @@ This release has optimized the implementation of some functions, involving renam
 
    This release optimizes the scheduling mechanism for internal tasks within the SDK, with improvements in the following aspects:
 
-   - The speed of vieo rendering and audio playback for both remote and local first frames improves by 10% to 20%.
+   - The speed of video rendering and audio playback for both remote and local first frames improves by 10% to 20%.
    - The API call duration and response time are reduced by 5% to 50%.
    - The SDK's parallel processing capability significantly improves, delivering higher video quality (720P, 24 fps) even on lower-end devices. Additionally, image processing remains more stable in scenarios involving high resolutions and frame rates.
    - The stability of the SDK is further enhanced, leading to a noticeable decrease in the crash rate across various specific scenarios.
@@ -125,7 +127,6 @@ This release has optimized the implementation of some functions, involving renam
    - This release adds the `earMonitorDelay` and `aecEstimatedDelay` members in [LocalAudioStats](API/class_localaudiostats.html) to report ear monitor delay and acoustic echo cancellation (AEC) delay, respectively.
    - The [onPlayerCacheStats](API/callback_imediaplayersourceobserver_onplayercachestats.html) callback is added to report the statistics of the media file being cached. This callback is triggered once per second after file caching is started.
    - The [onPlayerPlaybackStats](API/callback_imediaplayersourceobserver_onplayerplaybackstats.html) callback is added to report the statistics of the media file being played. This callback is triggered once per second after the media file starts playing. You can obtain information like the audio and video bitrate of the media file through [PlayerPlaybackStats](API/class_playerplaybackstats.html).
-   - An error code `kMusicContentCenterReasonHttpInternalError` is added to suggest that an internal error in HTTP. You can try again later.
 
 #### Issues fixed
 
@@ -154,61 +155,61 @@ This release fixed the following issues:
 
 - `routeBluetooth` is renamed as`RouteBluetoothDeviceHFP`
 - All `ERROR` fields in the following enumerations are changed to `REASON`:
-  - `LocalAudioStreamReasonOk`
-  - `LocalAudioStreamReasonFailure`
-  - `LocalAudioStreamReasonDeviceNoPermission`
-  - `LocalAudioStreamReasonDeviceBusy`
-  - `LocalAudioStreamReasonRecordFailure`
-  - `LocalAudioStreamReasonEncodeFailure`
-  - `LocalVideoStreamReasonOk`
-  - `LocalVideoStreamReasonFailure`
-  - `LocalVideoStreamReasonDeviceNoPermission`
-  - `LocalVideoStreamReasonDeviceBusy`
-  - `LocalVideoStreamReasonCaptureFailure`
-  - `LocalVideoStreamReasonCodecNotSupport`
-  - `LocalVideoStreamReasonCaptureInbackground` (iOS)
-  - `LocalVideoStreamReasonCaptureMultipleForegroundApps` (iOS)
-  - `LocalVideoStreamReasonDeviceNotFound`
-  - `LocalVideoStreamReasonDeviceDisconnected`
-  - `LocalVideoStreamReasonDeviceInvalidId`
-  - `DirectCdnStreamingReasonOk`
-  - `DirectCdnStreamingReasonFailed`
-  - `DirectCdnStreamingReasonAudioPublication`
-  - `DirectCdnStreamingReasonVideoPublication`
-  - `DirectCdnStreamingReasonNetConnect`
-  - `DirectCdnStreamingReasonBadName`
-  - `PlayerReasonNone`
-  - `PlayerReasonInvalidArguments`
-  - `PlayerReasonInternal`
-  - `PlayerReasonNoResource`
-  - `PlayerReasonInvalidMediaSource`
-  - `PlayerReasonUnknownStreamType`
-  - `PlayerReasonObjNotInitialized`
-  - `PlayerReasonCodecNotSupported`
-  - `PlayerReasonVideoRenderFailed`
-  - `PlayerReasonInvalidState`
-  - `PlayerReasonUrlNotFound`
-  - `PlayerReasonInvalidConnectionState`
-  - `PlayerReasonSrcBufferUnderflow`
-  - `PlayerReasonInterrupted`
-  - `PlayerReasonNotSupported`
-  - `PlayerReasonTokenExpired`
-  - `PlayerReasonUnknown`
-  - `RtmpStreamPublishReasonOk`
-  - `RtmpStreamPublishReasonInvalidArgument`
-  - `RtmpStreamPublishReasonEncryptedStreamNotAllowed`
-  - `RtmpStreamPublishReasonConnectionTimeout`
-  - `RtmpStreamPublishReasonInternalServerError`
-  - `RtmpStreamPublishReasonRtmpServerError`
-  - `RtmpStreamPublishReasonTooOften`
-  - `RtmpStreamPublishReasonReachLimit`
-  - `RtmpStreamPublishReasonNotAuthorized`
-  - `RtmpStreamPublishReasonStreamNotFound`
-  - `RtmpStreamPublishReasonFormatNotSupported`
-  - `RtmpStreamPublishReasonNotBroadcaster`
-  - `RtmpStreamPublishReasonTranscodingNoMixStream`
-  - `RtmpStreamPublishReasonNetDown`
-  - `RtmpStreamPublishReasonInvalidPrivilege`
+  - `LocalAudioStreamErrorOk`
+  - `LocalAudioStreamErrorFailure`
+  - `LocalAudioStreamErrorDeviceNoPermission`
+  - `LocalAudioStreamErrorDeviceBusy`
+  - `LocalAudioStreamErrorRecordFailure`
+  - `LocalAudioStreamErrorEncodeFailure`
+  - `LocalVideoStreamErrorOk`
+  - `LocalVideoStreamErrorFailure`
+  - `LocalVideoStreamErrorDeviceNoPermission`
+  - `LocalVideoStreamErrorDeviceBusy`
+  - `LocalVideoStreamErrorCaptureFailure`
+  - `LocalVideoStreamErrorCodecNotSupport`
+  - `LocalVideoStreamErrorCaptureInbackground` (iOS)
+  - `LocalVideoStreamErrorCaptureMultipleForegroundApps` (iOS)
+  - `LocalVideoStreamErrorDeviceNotFound`
+  - `LocalVideoStreamErrorDeviceDisconnected`
+  - `LocalVideoStreamErrorDeviceInvalidId`
+  - `DirectCdnStreamingErrorOk`
+  - `DirectCdnStreamingErrorFailed`
+  - `DirectCdnStreamingErrorAudioPublication`
+  - `DirectCdnStreamingErrorVideoPublication`
+  - `DirectCdnStreamingErrorNetConnect`
+  - `DirectCdnStreamingErrorBadName`
+  - `PlayerErrorNone`
+  - `PlayerErrorInvalidArguments`
+  - `PlayerErrorInternal`
+  - `PlayerErrorNoResource`
+  - `PlayerErrorInvalidMediaSource`
+  - `PlayerErrorUnknownStreamType`
+  - `PlayerErrorObjNotInitialized`
+  - `PlayerErrorCodecNotSupported`
+  - `PlayerErrorVideoRenderFailed`
+  - `PlayerErrorInvalidState`
+  - `PlayerErrorUrlNotFound`
+  - `PlayerErrorInvalidConnectionState`
+  - `PlayerErrorSrcBufferUnderflow`
+  - `PlayerErrorInterrupted`
+  - `PlayerErrorNotSupported`
+  - `PlayerErrorTokenExpired`
+  - `PlayerErrorUnknown`
+  - `RtmpStreamPublishErrorOk`
+  - `RtmpStreamPublishErrorInvalidArgument`
+  - `RtmpStreamPublishErrorEncryptedStreamNotAllowed`
+  - `RtmpStreamPublishErrorConnectionTimeout`
+  - `RtmpStreamPublishErrorInternalServerError`
+  - `RtmpStreamPublishErrorRtmpServerError`
+  - `RtmpStreamPublishErrorTooOften`
+  - `RtmpStreamPublishErrorReachLimit`
+  - `RtmpStreamPublishErrorNotAuthorized`
+  - `RtmpStreamPublishErrorStreamNotFound`
+  - `RtmpStreamPublishErrorFormatNotSupported`
+  - `RtmpStreamPublishErrorNotBroadcaster`
+  - `RtmpStreamPublishErrorTranscodingNoMixStream`
+  - `RtmpStreamPublishErrorNetDown`
+  - `RtmpStreamPublishErrorInvalidPrivilege`
   - `RtmpStreamUnpublishErrorOk`
 
 **Deleted**
diff --git a/markdown/RTC 4.x/release-notes/en-US/framework/release_unity_ng.md b/markdown/RTC 4.x/release-notes/en-US/framework/release_unity_ng.md
@@ -89,7 +89,7 @@ This release has optimized the implementation of some functions, involving renam
 
    This release optimizes the scheduling mechanism for internal tasks within the SDK, with improvements in the following aspects:
 
-   - The speed of vieo rendering and audio playback for both remote and local first frames improves by 10% to 20%.
+   - The speed of video rendering and audio playback for both remote and local first frames improves by 10% to 20%.
    - The API call duration and response time are reduced by 5% to 50%.
    - The SDK's parallel processing capability significantly improves, delivering higher video quality (720P, 24 fps) even on lower-end devices. Additionally, image processing remains more stable in scenarios involving high resolutions and frame rates.
    - The stability of the SDK is further enhanced, leading to a noticeable decrease in the crash rate across various specific scenarios.
diff --git a/markdown/RTC 4.x/release-notes/en-US/native/release_android_ng.md b/markdown/RTC 4.x/release-notes/en-US/native/release_android_ng.md
@@ -110,7 +110,7 @@ This release has optimized the implementation of some functions, involving renam
 
    This release optimizes the scheduling mechanism for internal tasks within the SDK, with improvements in the following aspects:
 
-   - The speed of vieo rendering and audio playback for both remote and local first frames improves by 10% to 20%.
+   - The speed of video rendering and audio playback for both remote and local first frames improves by 10% to 20%.
    - The API call duration and response time are reduced by 5% to 50%.
    - The SDK's parallel processing capability significantly improves, delivering higher video quality (720P, 24 fps) even on lower-end devices. Additionally, image processing remains more stable in scenarios involving high resolutions and frame rates.
    - The stability of the SDK is further enhanced, leading to a noticeable decrease in the crash rate across various specific scenarios.
diff --git a/markdown/RTC 4.x/release-notes/en-US/native/release_ios_ng.md b/markdown/RTC 4.x/release-notes/en-US/native/release_ios_ng.md
@@ -107,7 +107,7 @@ This release has optimized the implementation of some functions, involving renam
 
    This release optimizes the scheduling mechanism for internal tasks within the SDK, with improvements in the following aspects:
 
-   - The speed of vieo rendering and audio playback for both remote and local first frames improves by 10% to 20%.
+   - The speed of video rendering and audio playback for both remote and local first frames improves by 10% to 20%.
    - The API call duration and response time are reduced by 5% to 50%.
    - The SDK's parallel processing capability significantly improves, delivering higher video quality (720P, 24 fps) even on lower-end devices. Additionally, image processing remains more stable in scenarios involving high resolutions and frame rates.
    - The stability of the SDK is further enhanced, leading to a noticeable decrease in the crash rate across various specific scenarios.
diff --git a/markdown/RTC 4.x/release-notes/en-US/native/release_mac_ng.md b/markdown/RTC 4.x/release-notes/en-US/native/release_mac_ng.md
diff --git a/markdown/RTC 4.x/release-notes/en-US/native/release_windows_ng.md b/markdown/RTC 4.x/release-notes/en-US/native/release_windows_ng.md
