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

Cilla-luodan · Cilla-luodan · commit 5f3bc9bdbcee · 2024-01-25T11:17:48.000+08:00
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
@@ -36,7 +36,7 @@ This release has optimized the implementation of some functions, involving renam
    | `MediaPlayerError`        | `MediaPlayerReason`           |
    | `RtmpStreamPublishErrorType`  | `RtmpStreamPublishReason`     |
 
-   **Note:** For specific renaming of enumerations, please refer to [API changes](#api-change).
+   **Note:** For specific renaming of enumerations, please refer to [API changes](#apichange).
 
 2. **Channel media relay**
 
@@ -133,7 +133,6 @@ This release has optimized the implementation of some functions, involving renam
    - The [`onLocalVideoStateChanged`](API/callback_irtcengineeventhandler_onlocalvideostatechanged.html) callback is improved with the inclusion of the `localVideoStreamReasonScreenCaptureAutoFallback` enumeration, signaling 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 [`onPlayerCacheStats`](API/callback_imediaplayersourceobserver_onplayercachestats.html) callback is added to reports 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 reports 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. (Android, iOS)
    - This release optimizes the SDK's domain name resolution strategy, improving the stability of calling `setLocalAccessPoint` 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.
@@ -148,6 +147,8 @@ This release fixed the following issues:
 
 #### API changes
 
+<a name="apichange"></a>
+
 **Added**
 
 - [`onTranscodedStreamLayoutInfo`](API/callback_irtcengineeventhandler_ontranscodedstreamlayoutinfo.html)(Android, iOS)
@@ -158,7 +159,6 @@ This release fixed the following issues:
 - [`onPlayerCacheStats`](API/callback_imediaplayersourceobserver_onplayercachestats.html)
 - [`onPlayerPlaybackStats`](API/callback_imediaplayersourceobserver_onplayerplaybackstats.html)
 - [`PlayerPlaybackStats`](API/class_playerplaybackstats.html)
-- The `kMusicContentCenterReasonHttpInternalError` enumeration in `MusicContentCenterStateReason` (Android, iOS)
 - The `earMonitorDelay` and `aecEstimatedDelay` members in [`LocalAudioStats`](API/class_localaudiostats.html)
 - [`queryDeviceScore`](API/api_irtcengine_querydevicescore.html)
 - The `customVideoSource` enumeration in [`MediaSourceType`](API/enum_mediasourcetype.html)
@@ -237,14 +237,6 @@ This release fixed the following issues:
   - `rtmpStreamPublishErrorNetDown`
   - `rtmpStreamPublishErrorInvalidPrivilege`
   - `rtmpStreamUnpublishErrorOk`
-- `MusicContentCenterStatusCode` is renamed as `MusicContentCenterStateReason`, and the `StatusErr` in all enumerators is changed to `Reason`: (Android, iOS)
-  - `kMusicContentCenterStatusErrGateway`
-  - `kMusicContentCenterStatusErrPermissionAndResource`
-  - `kMusicContentCenterStatusErrInternalDataParse`
-  - `kMusicContentCenterStatusErrMusicLoading`
-  - `kMusicContentCenterStatusErrMusicDecryption`
-- `kMusicContentCenterStatusOk` is changed to `kMusicContentCenterReasonOk` (Android, iOS)
-- `kMusicContentCenterStatusErr` is changed to `kMusicContentCenterReasonError` (Android, iOS)
 
 **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
@@ -27,13 +27,13 @@ This release has optimized the implementation of some functions, involving renam
    | `OnDirectCdnStreamingStateChanged` | `error`                 | `reason`                |
    | `OnRtmpStreamingStateChanged`      | `errCode`               | `reason`                |
 
-   | Original enumeration class   | Current enumeration class    |
-   | ---------------------------- | ---------------------------- |
-   | `LOCAL_AUDIO_STREAM_ERROR`   | `LOCAL_AUDIO_STREAM_ERROR`   |
-   | `LOCAL_VIDEO_STREAM_ERROR`   | `LOCAL_VIDEO_STREAM_ERROR`   |
-   | `DIRECT_CDN_STREAMING_ERROR` | `DIRECT_CDN_STREAMING_ERROR` |
-   | `MEDIA_PLAYER_ERROR`         | `MEDIA_PLAYER_ERROR`         |
-   | `RTMP_STREAM_PUBLISH_ERROR`  | `RTMP_STREAM_PUBLISH_ERROR`  |
+   | Original enumeration class   | Current enumeration class     |
+   | ---------------------------- | ----------------------------- |
+   | `LOCAL_AUDIO_STREAM_ERROR`   | `LOCAL_AUDIO_STREAM_REASON`   |
+   | `LOCAL_VIDEO_STREAM_ERROR`   | `LOCAL_VIDEO_STREAM_REASON`   |
+   | `DIRECT_CDN_STREAMING_ERROR` | `DIRECT_CDN_STREAMING_REASON` |
+   | `MEDIA_PLAYER_ERROR`         | `MEDIA_PLAYER_REASON`         |
+   | `RTMP_STREAM_PUBLISH_ERROR`  | `RTMP_STREAM_PUBLISH_REASON`  |
 
    **Note:** For specific renaming of enumerations, please refer to [API changes](#change).
 
@@ -51,9 +51,9 @@ This release has optimized the implementation of some functions, involving renam
 
    This release makes the following modifications to the enumerations in the [LOCAL_VIDEO_STREAM_REASON](API/enum_localvideostreamreason.html) class:
 
-   - The value of `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_PAUSED` (formerly `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_PAUSED`) has been changed from 23 to 28.
-   - The value of `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_RESUMED` (formerly `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_RESUMED`) has been changed from 24 to 29.
-   - The `LOCAL_VIDEO_STREAM_ERROR_CODEC_NOT_SUPPORT` enumeration has been changed to `LOCAL_VIDEO_STREAM_ERROR_CODEC_NOT_SUPPORT`.
+   - The value of `LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_PAUSED` (formerly `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_PAUSED`) has been changed from 23 to 28.
+   - The value of `LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_RESUMED` (formerly `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_RESUMED`) has been changed from 24 to 29.
+   - The `LOCAL_VIDEO_STREAM_ERROR_CODEC_NOT_SUPPORT` enumeration has been changed to `LOCAL_VIDEO_STREAM_REASON_CODEC_NOT_SUPPORT`.
 
 #### New features
 
@@ -129,7 +129,7 @@ This release fixed the following issues:
 
 **Added**
 
-- The ` subviewUid` member in [VideoCanvas](API/class_videocanvas.html)
+- The `subviewUid` member in [VideoCanvas](API/class_videocanvas.html)
 - [EnableCustomAudioLocalPlayback](API/api_irtcengine_enablecustomaudiolocalplayback.html)
 - [QueryDeviceScore](API/api_irtcengine_querydevicescore.html)
 - The `CUSTOM_VIDEO_SOURCE` enumeration in [MEDIA_SOURCE_TYPE](API/enum_mediasourcetype.html)
@@ -143,7 +143,7 @@ This release fixed the following issues:
 
 - All `ERROR` fields in the following enumerations are changed to `REASON`:
 
-- - `LOCAL_AUDIO_STREAM_ERROR_OK`
+  - `LOCAL_AUDIO_STREAM_ERROR_OK`
   - `LOCAL_AUDIO_STREAM_ERROR_FAILURE`
   - `LOCAL_AUDIO_STREAM_ERROR_DEVICE_NO_PERMISSION`
   - `LOCAL_AUDIO_STREAM_ERROR_DEVICE_BUSY`
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
@@ -37,7 +37,7 @@ This release has optimized the implementation of some functions, involving renam
    | `DirectCdnStreamingReason` | `DirectCdnStreamingReason` |
    | `MediaPlayerReason`        | `MediaPlayerReason`        |
 
-   **Note:** For specific renaming of enumerations, please refer to [API changes](Chunk916049832.html#apichange).
+   **Note:** For specific renaming of enumerations, please refer to [API changes](C#apichange).
 
 3. **Channel media relay**
 
@@ -149,7 +149,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 `MUSIC_CONTENT_CENTER_STATUS_ERR_HTTP_INTERNAL` is added to suggest that an internal error in HTTP. You can try again later.
 
 #### Issues fixed
 
@@ -160,6 +159,8 @@ This release fixed the following issues:
 
 #### API changes
 
+<a name="apichange"></a>
+
 **Added**
 
 - [`onTranscodedStreamLayoutInfo`](API/callback_irtcengineeventhandler_ontranscodedstreamlayoutinfo.html)
@@ -172,7 +173,6 @@ This release fixed the following issues:
 - [`onPlayerCacheStats`](API/callback_imediaplayersourceobserver_onplayercachestats.html)
 - [`onPlayerPlaybackStats`](API/callback_imediaplayersourceobserver_onplayerplaybackstats.html)
 - [`PlayerPlaybackStats`](API/class_playerplaybackstats.html)
-- The `MUSIC_CONTENT_CENTER_STATUS_ERR_HTTP_INTERNAL` enumeration in `MusicContentCenterStateReason`
 - [`startPlaybackDeviceTest`](API/api_iaudiodevicemanager_startplaybackdevicetest.html)
 - [`stopPlaybackDeviceTest`](API/api_iaudiodevicemanager_stopplaybackdevicetest.html)
 - The `earMonitorDelay` and `aecEstimatedDelay` members in [LocalAudioStats](API/class_localaudiostats.html)
@@ -237,14 +237,6 @@ This release fixed the following issues:
   - `RTMP_STREAM_PUBLISH_ERROR_NET_DOWN`
   - `RTMP_STREAM_PUBLISH_ERROR_INVALID_PRIVILEGE`
   - `RTMP_STREAM_UNPUBLISH_ERROR_OK`
-- `MusicContentCenterStatusCode` is renamed as `MusicContentCenterStateReason`, and the `STATUS_ERR` in all enumerators is changed to `STATE_REASON`:
-  - `MUSIC_CONTENT_CENTER_STATUS_ERR_GATEWAY`
-  - `MUSIC_CONTENT_CENTER_STATUS_ERR_PERMISSION_AND_RESOURCE`
-  - `MUSIC_CONTENT_CENTER_STATUS_ERR_INTERNAL_DATA_PARSE`
-  - `MUSIC_CONTENT_CENTER_STATUS_ERR_MUSIC_LOADING`
-  - `MUSIC_CONTENT_CENTER_STATUS_ERR_MUSIC_DECRYPTION`
-- `MUSIC_CONTENT_CENTER_STATUS_OK` is changed to `MUSIC_CONTENT_CENTER_STATE_REASON_OK`
-- `MUSIC_CONTENT_CENTER_STATUS_ERR` is changed to `MUSIC_CONTENT_CENTER_STATE_REASON_ERROR`
 
 **Deleted**
 
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
@@ -18,13 +18,13 @@ This release has optimized the implementation of some functions, involving renam
    | `onPlayerSourceStateChanged`       | `ec`                    | `reason`                |
    | `onRtmpStreamingStateChanged`      | `errCode`               | `reason`                |
 
-   | Original enumeration class   | Current enumeration class    |
-   | ---------------------------- | ---------------------------- |
-   | `LOCAL_AUDIO_STREAM_ERROR`   | `LOCAL_AUDIO_STREAM_ERROR`   |
-   | `LOCAL_VIDEO_STREAM_ERROR`   | `LOCAL_VIDEO_STREAM_ERROR`   |
-   | `DIRECT_CDN_STREAMING_ERROR` | `DIRECT_CDN_STREAMING_ERROR` |
-   | `MEDIA_PLAYER_ERROR`         | `MEDIA_PLAYER_ERROR`         |
-   | `RTMP_STREAM_PUBLISH_ERROR`  | `RTMP_STREAM_PUBLISH_ERROR`  |
+   | Original enumeration class   | Current enumeration class     |
+   | ---------------------------- | ----------------------------- |
+   | `LOCAL_AUDIO_STREAM_ERROR`   | `LOCAL_AUDIO_STREAM_REASON`   |
+   | `LOCAL_VIDEO_STREAM_ERROR`   | `LOCAL_VIDEO_STREAM_REASON`   |
+   | `DIRECT_CDN_STREAMING_ERROR` | `DIRECT_CDN_STREAMING_REASON` |
+   | `MEDIA_PLAYER_ERROR`         | `MEDIA_PLAYER_REASON`         |
+   | `RTMP_STREAM_PUBLISH_ERROR`  | `RTMP_STREAM_PUBLISH_REASON`  |
 
    **Note:** For specific renaming of enumerations, please refer to [API changes](#change).
 
@@ -42,9 +42,9 @@ This release has optimized the implementation of some functions, involving renam
 
    This release makes the following modifications to the enumerations in the [LOCAL_VIDEO_STREAM_ERROR](API/enum_localvideostreamreason.html) class:
 
-   - The value of `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_PAUSED` (formerly `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_PAUSED`) has been changed from 23 to 28.
-   - The value of `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_RESUMED` (formerly `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_RESUMED`) has been changed from 24 to 29.
-   - The `LOCAL_VIDEO_STREAM_ERROR_CODEC_NOT_SUPPORT` enumeration has been changed to `LOCAL_VIDEO_STREAM_ERROR_CODEC_NOT_SUPPORT`.
+   - The value of `LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_PAUSED` (formerly `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_PAUSED`) has been changed from 23 to 28.
+   - The value of `LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_RESUMED` (formerly `LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_RESUMED`) has been changed from 24 to 29.
+   - The `LOCAL_VIDEO_STREAM_ERROR_CODEC_NOT_SUPPORT` enumeration has been changed to `LOCAL_VIDEO_STREAM_REASON_CODEC_NOT_SUPPORT`.
 
 4. **Audio loopback capturing**
 
@@ -130,7 +130,7 @@ This release fixed the following issues:
 
 **Added**
 
-- The ` subviewUid` member in [VideoCanvas](API/class_videocanvas.html)
+- The `subviewUid` member in [VideoCanvas](API/class_videocanvas.html)
 - [enableCustomAudioLocalPlayback](API/api_irtcengine_enablecustomaudiolocalplayback.html)
 - [queryDeviceScore](API/api_irtcengine_querydevicescore.html)
 - The `CUSTOM_VIDEO_SOURCE` enumeration in [MEDIA_SOURCE_TYPE](API/enum_mediasourcetype.html)
