From c49d771bf7065a68d55df51ace8475c9883ac1f8 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Fri, 23 Feb 2024 15:07:18 +0800 Subject: [PATCH 01/13] New translations --- en-US/dita/RTC-NG/API/class_watermarkoptions.dita | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/dita/RTC-NG/API/class_watermarkoptions.dita b/en-US/dita/RTC-NG/API/class_watermarkoptions.dita index fb85cb788ea..6145bbe80e9 100644 --- a/en-US/dita/RTC-NG/API/class_watermarkoptions.dita +++ b/en-US/dita/RTC-NG/API/class_watermarkoptions.dita @@ -154,7 +154,7 @@ class WatermarkOptions { visibleInPreview - Is the watermark visible in the local preview view?
    + Whether the watermark is visible in the local preview view:
    • : (Default) The watermark is visible in the local preview view.
    • : The watermark is not visible in the local preview view.
    From c95e193549ebee410cf1d9cf7b3de827b146f33f Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Fri, 23 Feb 2024 16:07:51 +0800 Subject: [PATCH 02/13] New translations --- .../API/api_irtcengine_enableextension.dita | 25 +++++++++---------- .../API/api_irtcengine_registerextension.dita | 16 +++++++++--- .../api_irtcengine_setlocalaccesspoint.dita | 2 +- ..._irtcengine_setlowlightenhanceoptions.dita | 4 +-- .../api_irtcengine_startscreencapture.dita | 10 ++++---- ...tcengineeventhandler_onextensionerror.dita | 2 +- ...engineeventhandler_onextensionstarted.dita | 2 +- ...engineeventhandler_onextensionstopped.dita | 2 +- en-US/dita/RTC-NG/API/rtc_api_overview.dita | 4 +-- 9 files changed, 38 insertions(+), 29 deletions(-) diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_enableextension.dita b/en-US/dita/RTC-NG/API/api_irtcengine_enableextension.dita index 72230f61c5c..f43bb471983 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_enableextension.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_enableextension.dita @@ -13,12 +13,13 @@

    - public abstract int enableExtension(String provider, String extension, boolean enable); - - (int)enableExtensionWithVendor:(NSString * __nonnull)provider extension:(NSString * __nonnull)extension enabled:(BOOL)enabled; - - virtual int enableExtension( - const char* provider, const char* extension, bool enable=true, agora::media::MEDIA_SOURCE_TYPE type = agora::media::UNKNOWN_MEDIA_SOURCE) = 0; - + public abstract int enableExtension( + String provider, String extension, boolean enable, Constants.MediaSourceType sourceType); + - (int)enableExtensionWithVendor:(NSString * __nonnull)provider + extension:(NSString * __nonnull)extension + enabled:(BOOL)enabled + sourceType:(AgoraMediaSourceType)sourceType NS_SWIFT_NAME(enableExtension(withVendor:extension:enabled:sourceType:)); + virtual int enableExtension(const char* provider, const char* extension, bool enable=true, agora::media::MEDIA_SOURCE_TYPE type = agora::media::UNKNOWN_MEDIA_SOURCE) = 0; UFUNCTION(BlueprintCallable, Category = "Agora|RtcEngineProxy") int EnableExtension(FString provider, FString extension, bool enable = true, EMEDIA_SOURCE_TYPE type = EMEDIA_SOURCE_TYPE::UNKNOWN_MEDIA_SOURCE); abstract enableExtension( @@ -70,13 +71,11 @@

- - type - Type of media source. See .In this method, this parameter supports only the following two settings:
    -
  • The default value is .
    • -
  • If you want to use the second camera to capture video, set this parameter to .
    • -
- + + type + sourceType + Source type of the extension. See . +
<ph keyref="return-section-title"/> diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita b/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita index 1c35083ed85..c7c162e6628 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita @@ -13,8 +13,11 @@

- - + public abstract int registerExtension( + String provider, String extension, Constants.MediaSourceType sourceType); + - (int)registerExtensionWithVendor:(NSString * __nonnull)provider + extension:(NSString * __nonnull)extension + sourceType:(AgoraMediaSourceType)sourceType NS_SWIFT_NAME(registerExtension(withVendor:extension:sourceType:)); virtual int registerExtension(const char* provider, const char* extension, agora::media::MEDIA_SOURCE_TYPE type = agora::media::UNKNOWN_MEDIA_SOURCE) = 0; UFUNCTION(BlueprintCallable, Category = "Agora|RtcEngineProxy") @@ -45,7 +48,14 @@

After the extension is loaded, you can call this method to register the extension.

-

This method applies to Windows only.

+ +
    +
  • 调用该方法前，需要先调用 加载插件。
    • +
  • 调用该方法前，需要先在 Xcode 中将插件动态库（.xcframework）链接至你的工程。
    • +
  • 调用该方法前，需要先调用 加载插件。
    • +
  • 对于 SDK 外部的插件（例如云市场插件、SDK 拓展插件），在调用 前需要调用该方法注册。
    • +
+
Parameters diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita index fce22bdd91c..552c0eb0620 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita @@ -2,7 +2,7 @@ <ph keyref="setLocalAccessPoint" /> - Configure the connection with the native access module of the Agora network private media server. + 配置与声网私有媒体服务器接入模块的连接。 diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita index 61e89dc7a3d..99105e9611b 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita @@ -45,7 +45,7 @@
  • Call this method after calling .
  • Dark light enhancement has certain requirements for equipment performance. The low-light enhancement feature has certain performance requirements on devices. If your device overheats after you enable low-light enhancement, Agora recommends modifying the low-light enhancement options to a less performance-consuming level or disabling low-light enhancement entirely.
    • -
  • Both this method and can turn on low-light enhancement:
      +
    • Both this method and can turn on low-light enhancement:
      • When you use the SDK to capture video, Agora recommends this method (this method only works for video captured by the SDK).
      • When you use an external video source to implement custom video capture, or send an external video source to the SDK, Agora recommends using .
      • @@ -68,7 +68,7 @@ type - The type of the video source. See . + The type of the video source, see .
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita b/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita index 4d41c715542..1c798620a08 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita @@ -42,9 +42,7 @@
  • If you are using the custom audio source instead of the SDK to capture audio, Agora recommends you add the keep-alive processing logic to your application to avoid screen sharing stopping when the application goes to the background.
  • This feature requires high-performance device, and Agora recommends that you use it on iPhone X and later models.
  • This method relies on the iOS screen sharing dynamic library AgoraReplayKitExtension.xcframework. If the dynamic library is deleted, screen sharing cannot be enabled normally.
    • -
  • On the Android platform, make sure the user has granted the app screen capture permission.
    • -
  • Make sure that the Android API level is not earlier than 21, otherwise, the SDK reports error codes (16) and (2).
    • -
  • To capture system audio during screen sharing, ensure that the Android API level is not earlier than 29 as well; otherwise, the SDK reports the error code (3).
    • +
  • 在 Android 平台上，如果用户未授予 App 屏幕采集权限，SDK 会上报 (2) 回调。
  • On Android 9 and later, to avoid the application being killed by the system after going to the background, Agora recommends you add the foreground service android.permission.FOREGROUND_SERVICE to the /app/Manifests/AndroidManifest.xml file.
  • Due to performance limitations, screen sharing is not supported on Android TV.
  • Due to system limitations, if you are using Huawei phones, do not adjust the video encoding resolution of the screen sharing stream during the screen sharing, or you could experience crashes.
    • @@ -66,8 +64,10 @@

    When the method call succeeds, there is no return value; when fails, the exception is thrown; and you need to catch the exception and handle it accordingly. See for details and resolution suggestions.

    • 0: Success.
      • -
    • < 0: Failure.
        -
      • -2: The parameter is null.
        • +
      • < 0: Failure. See for details and resolution suggestions.
          +
        • -2 (iOS 平台): 参数为空。
          • +
        • -2 (Anroid 平台): 系统版本过低，请确保 Android API 级别不低于 21。
          • +
        • -3 (Anroid 平台): 无法采集系统音频，请确保 Android API 级别不低于 29。
     diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita index 627de9cc12a..1145de75167 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita @@ -45,7 +45,7 @@

    -

    When calling () fails or the extension runs in error, the extension triggers this callback and reports the error code and reason.

    +

    When calling () fails or the extension runs in error, the extension triggers this callback and reports the error code and reason.

    Parameters diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita index 127ce49bb41..61da0525ec2 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita @@ -29,7 +29,7 @@

    -

    After a successful call of (), the extension triggers this callback.

    +

    成功创建音频或视频插件后，插件会触发该回调。

    Parameters diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita index 47c92d380af..6da8b9340db 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita @@ -29,7 +29,7 @@

    -

    After a successful call of (), this callback is triggered.

    +

    成功销毁音频或视频插件后，插件会触发该回调。

    Parameters diff --git a/en-US/dita/RTC-NG/API/rtc_api_overview.dita b/en-US/dita/RTC-NG/API/rtc_api_overview.dita index 124a7e36f97..43546861dd0 100644 --- a/en-US/dita/RTC-NG/API/rtc_api_overview.dita +++ b/en-US/dita/RTC-NG/API/rtc_api_overview.dita @@ -2542,9 +2542,9 @@ - + - (For Windows only) + From bb3714f634248f173b1515a9ce34b1ff5f537dca Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Wed, 28 Feb 2024 11:25:41 +0800 Subject: [PATCH 03/13] New translations --- ..._irtcengineeventhandler_onchannelmediarelaystatechanged.dita | 2 +- en-US/dita/RTC-NG/API/class_spatialaudioparams.dita | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita index fa035514613..2138d2f0090 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita @@ -63,7 +63,7 @@ channelMediaRelayStateDidChange:(AgoraChannelMediaRelayState)state

    The error code of the channel media relay.

    • (0): Everything is normal.
    • (1): An error occurs in the server response.
      • -
    • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error can also occur if your project has not enabled co-host token authentication. You can to enable the service for cohosting across channels before starting a channel media relay.
      • +
    • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error may also be caused by the current App ID not enabling the channel media relay service. You can to enable the service for cohosting across channels before starting a channel media relay.
    • (3): The SDK fails to access the service, probably due to limited resources of the server.
    • 4: The server fails to send the relay request.
    • 5: The server fails to accept the relay request.
      • diff --git a/en-US/dita/RTC-NG/API/class_spatialaudioparams.dita b/en-US/dita/RTC-NG/API/class_spatialaudioparams.dita index 7e84fe8562e..e8dbb07552e 100644 --- a/en-US/dita/RTC-NG/API/class_spatialaudioparams.dita +++ b/en-US/dita/RTC-NG/API/class_spatialaudioparams.dita @@ -258,7 +258,7 @@ struct FSpatialAudioParams
      -
    • This parameter is suitable for scenarios where the sound source is moving at high speed (for example, racing games). It is not recommended for common audio and video interactive scenarios (for example, voice chat, cohosting, or online KTV).
      • +
    • This parameter is suitable for scenarios where the sound source is moving at high speed (for example, racing games). It is not recommended for common audio and video interactive scenarios (for example, voice chat, co-streaming, or online KTV).
    • When this parameter is enabled, Agora recommends that you set a regular period (such as 30 ms), and then call the , , and methods to continuously update the relative distance between the sound source and the receiver. The following factors can cause the Doppler effect to be unpredictable or the sound to be jittery: the period of updating the distance is too long, the updating period is irregular, or the distance information is lost due to network packet loss or delay.
     From 9fe28c2d0c0bad293c8b1c4f2206b5ede06a376d Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Wed, 28 Feb 2024 12:13:03 +0800 Subject: [PATCH 04/13] New translations --- ...cengineeventhandler_onchannelmediarelaystatechanged.dita | 2 +- en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita index 2138d2f0090..7fbb925ee1a 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita @@ -63,7 +63,7 @@ channelMediaRelayStateDidChange:(AgoraChannelMediaRelayState)state

    The error code of the channel media relay.

    • (0): Everything is normal.
    • (1): An error occurs in the server response.
      • -
    • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error may also be caused by the current App ID not enabling the channel media relay service. You can to enable the service for cohosting across channels before starting a channel media relay.
      • +
    • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error may also be caused by the current App ID not enabling the channel media relay service. You can to enable the service.
    • (3): The SDK fails to access the service, probably due to limited resources of the server.
    • 4: The server fails to send the relay request.
    • 5: The server fails to accept the relay request.
      • diff --git a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita index 7e219aae697..a7d6f010100 100644 --- a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita +++ b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita @@ -19,8 +19,8 @@

      2: No server response.

      -

      You can call to leave the channel.

      -

      This error can also occur if your project has not enabled co-host token authentication. You can to enable the service for cohosting across channels before starting a channel media relay.

      +

      This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel.

      +

      This error can also occur if your project does not enable the channel media relay service. You can contact to enable the service.

       @@ -45,7 +45,7 @@ - 8: The SDK disconnects from the server due to poor network connections. You can call to leave the channel. + 8: The SDK disconnects from the server due to poor network connections. You can call the method to leave the channel. From b1678b23c414263d0d30a06142449daafa3ffc2d Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Wed, 28 Feb 2024 12:16:56 +0800 Subject: [PATCH 05/13] New translations --- ..._irtcengineeventhandler_onchannelmediarelaystatechanged.dita | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita index 7fbb925ee1a..84a08db2608 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita @@ -63,7 +63,7 @@ channelMediaRelayStateDidChange:(AgoraChannelMediaRelayState)state

      The error code of the channel media relay.

      • (0): Everything is normal.
      • (1): An error occurs in the server response.
        • -
      • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error may also be caused by the current App ID not enabling the channel media relay service. You can to enable the service.
        • +
      • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error can also occur if your project does not enable the channel media relay service. You can to enable the service.
      • (3): The SDK fails to access the service, probably due to limited resources of the server.
      • 4: The server fails to send the relay request.
      • 5: The server fails to accept the relay request.
        • From cd609cbd75f1c362fb85e0a4e9925dd91b2df698 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Thu, 29 Feb 2024 11:03:05 +0800 Subject: [PATCH 06/13] New translations --- .../dita/RTC-NG/API/api_imediaplayer_selectmultiaudiotrack.dita | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/dita/RTC-NG/API/api_imediaplayer_selectmultiaudiotrack.dita b/en-US/dita/RTC-NG/API/api_imediaplayer_selectmultiaudiotrack.dita index ed89cffcafa..05508742016 100644 --- a/en-US/dita/RTC-NG/API/api_imediaplayer_selectmultiaudiotrack.dita +++ b/en-US/dita/RTC-NG/API/api_imediaplayer_selectmultiaudiotrack.dita @@ -1,6 +1,6 @@ - + <ph keyref="selectMultiAudioTrack"/> Selects the audio tracks that you want to play on your local device and publish to the channel respectively. From 5e2d98a1ff4363e841c47ccc7ed9ad69de4528da Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Thu, 29 Feb 2024 11:39:55 +0800 Subject: [PATCH 07/13] New translations --- .../RTC-NG/API/api_irtcengine_registerextension.dita | 8 ++++---- .../RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita | 4 ++-- .../API/api_irtcengine_setlowlightenhanceoptions.dita | 8 ++++---- .../RTC-NG/API/api_irtcengine_startscreencapture.dita | 10 +++++----- ...llback_irtcengineeventhandler_onextensionerror.dita | 2 +- ...back_irtcengineeventhandler_onextensionstarted.dita | 2 +- ...back_irtcengineeventhandler_onextensionstopped.dita | 2 +- 7 files changed, 18 insertions(+), 18 deletions(-) diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita b/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita index c7c162e6628..8ef831aa962 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita @@ -50,10 +50,10 @@

        After the extension is loaded, you can call this method to register the extension.

          -
        • 调用该方法前，需要先调用 加载插件。
          • -
        • 调用该方法前，需要先在 Xcode 中将插件动态库（.xcframework）链接至你的工程。
          • -
        • 调用该方法前，需要先调用 加载插件。
          • -
        • 对于 SDK 外部的插件（例如云市场插件、SDK 拓展插件），在调用 前需要调用该方法注册。
          • +
        • Before calling this method, you need to call to load the extension first.
          • +
        • Before calling this method, you need to link the extension dynamic library (.xcframework) to your project in Xcode.
          • +
        • Before calling this method, you need to call to load the extension first.
          • +
        • For extensions external to the SDK (e.g. Extensions Marketplace extensions, SDK extensions), you need to call this method before calling .
    diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita index 552c0eb0620..d50b4c551ee 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita @@ -2,7 +2,7 @@ <ph keyref="setLocalAccessPoint" /> - 配置与声网私有媒体服务器接入模块的连接。 + Configures the connection with the access module of the Agora network private media server. @@ -26,7 +26,7 @@
    Details -

    After successfully deploying the Agora private media server and integrating Agora Native SDK v4.0.0 on the intranet terminal, you can call this method to specify the Local Access Point and assign the Native access module to the SDK.

    +

    After successfully deploying the Agora private media server and integrating Agora Native SDK v4.x on the intranet terminal, you can call this method to specify the Local Access Point and assign the access module to the SDK.

    • This method takes effect only after the Agora hybrid cloud solution is deployed. You can contact to get to know more about the Agora hybrid cloud solution.
      • diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita index 99105e9611b..3af4daaa686 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita @@ -45,7 +45,7 @@
      • Call this method after calling .
      • Dark light enhancement has certain requirements for equipment performance. The low-light enhancement feature has certain performance requirements on devices. If your device overheats after you enable low-light enhancement, Agora recommends modifying the low-light enhancement options to a less performance-consuming level or disabling low-light enhancement entirely.
        • -
      • Both this method and can turn on low-light enhancement:
          +
        • Both this method and can turn on low-light enhancement:
          • When you use the SDK to capture video, Agora recommends this method (this method only works for video captured by the SDK).
          • When you use an external video source to implement custom video capture, or send an external video source to the SDK, Agora recommends using .
          • @@ -57,9 +57,9 @@ enabled enable - Whether to enable low-light enhancement function:
            -
          • : Enable low-light enhancement function.
            • -
          • : (Default) Disable low-light enhancement function.
            • + Whether to enable low-light enhancement:
              +
            • : Enable low-light enhancement.
              • +
            • : (Default) Disable low-light enhancement.
             diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita b/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita index 1c798620a08..bfff8ed65f6 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita @@ -29,7 +29,7 @@
    Details -

    There are two ways to start screen sharing, you can choose one according to your needs:

      +

      There are two options for enabling screen sharing. You can choose the one that best suits your specific scenario:

      • Call this method before joining a channel, then call to join channel and set publishScreenCaptureVideo to to start screen sharing.
      • Call this method after joining a channel, then call and set publishScreenCaptureVideo to to start screen sharing.

      @@ -42,7 +42,7 @@
    • If you are using the custom audio source instead of the SDK to capture audio, Agora recommends you add the keep-alive processing logic to your application to avoid screen sharing stopping when the application goes to the background.
    • This feature requires high-performance device, and Agora recommends that you use it on iPhone X and later models.
    • This method relies on the iOS screen sharing dynamic library AgoraReplayKitExtension.xcframework. If the dynamic library is deleted, screen sharing cannot be enabled normally.
      • -
    • 在 Android 平台上，如果用户未授予 App 屏幕采集权限，SDK 会上报 (2) 回调。
      • +
    • On the Android platform, if the user has not granted the app screen capture permission, the SDK reports the (2) callback.
    • On Android 9 and later, to avoid the application being killed by the system after going to the background, Agora recommends you add the foreground service android.permission.FOREGROUND_SERVICE to the /app/Manifests/AndroidManifest.xml file.
    • Due to performance limitations, screen sharing is not supported on Android TV.
    • Due to system limitations, if you are using Huawei phones, do not adjust the video encoding resolution of the screen sharing stream during the screen sharing, or you could experience crashes.
      • @@ -65,9 +65,9 @@
      • 0: Success.
      • < 0: Failure. See for details and resolution suggestions.
          -
        • -2 (iOS 平台): 参数为空。
          • -
        • -2 (Anroid 平台): 系统版本过低，请确保 Android API 级别不低于 21。
          • -
        • -3 (Anroid 平台): 无法采集系统音频，请确保 Android API 级别不低于 29。
          • +
        • -2 (iOS platform): Empty parameter.
          • +
        • -2 (Android platform): The system version is too low. Ensure that the Android API level is not lower than 21.
          • +
        • -3 (Android platform): Unable to capture system audio. Ensure that the Android API level is not lower than 29.
    diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita index 1145de75167..9445076f6b8 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita @@ -45,7 +45,7 @@

    -

    When calling () fails or the extension runs in error, the extension triggers this callback and reports the error code and reason.

    +

    The extension will trigger this callback and report the error code and error reason when the extension fails to enable or an error occurs during its operation.

    Parameters diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita index 61da0525ec2..3ba8eb244ef 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita @@ -29,7 +29,7 @@

    -

    成功创建音频或视频插件后，插件会触发该回调。

    +

    The extension will trigger this callback after it is successfully enabled.

    Parameters diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita index 6da8b9340db..1623f68e68a 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita @@ -29,7 +29,7 @@

    -

    成功销毁音频或视频插件后，插件会触发该回调。

    +

    The extension will trigger this callback after it is successfully destroyed.

    Parameters From 06e2902fa2f4c473736214374978118bdc04a5a7 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Thu, 29 Feb 2024 12:00:16 +0800 Subject: [PATCH 08/13] New translations --- en-US/dita/RTC-NG/API/api_irtcengine_setainsmode.dita | 2 +- en-US/dita/RTC-NG/API/class_channelmediaoptions.dita | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setainsmode.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setainsmode.dita index e8bdbbb3ff1..ea9a82f2511 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_setainsmode.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_setainsmode.dita @@ -44,7 +44,7 @@
    Applicable scenarios -

    In scenarios such as co-hosting, online education and video meeting, this function can detect and reduce background noises to improve experience.

    +

    In scenarios such as co-streaming, online education and video meeting, this function can detect and reduce background noises to improve experience.

    Parameters diff --git a/en-US/dita/RTC-NG/API/class_channelmediaoptions.dita b/en-US/dita/RTC-NG/API/class_channelmediaoptions.dita index 1ad59d37c6d..35b7ba9decd 100644 --- a/en-US/dita/RTC-NG/API/class_channelmediaoptions.dita +++ b/en-US/dita/RTC-NG/API/class_channelmediaoptions.dita @@ -812,7 +812,7 @@ class ChannelMediaOptions {
      -
    • This parameter only applies to scenarios involving cohosting across channels. The cohosts need to call the method to join the other host's channel as an audience member, and set isInteractiveAudience to .
      • +
    • This parameter only applies to co-streaming scenarios. The cohosts need to call the method to join the other host's channel as an audience member, and set isInteractiveAudience to .
    • This parameter takes effect only when the user role is .
     From 14251b441d6d0b6b4d64f7d10504a3f593b951b4 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Thu, 29 Feb 2024 14:25:00 +0800 Subject: [PATCH 09/13] New translations --- en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita | 2 +- .../RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita | 2 +- ...rtcengineeventhandler_onchannelmediarelaystatechanged.dita | 4 ++-- en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita | 4 ++-- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita b/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita index 8ef831aa962..233689cbe51 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_registerextension.dita @@ -53,7 +53,7 @@
  • Before calling this method, you need to call to load the extension first.
  • Before calling this method, you need to link the extension dynamic library (.xcframework) to your project in Xcode.
  • Before calling this method, you need to call to load the extension first.
    • -
  • For extensions external to the SDK (e.g. Extensions Marketplace extensions, SDK extensions), you need to call this method before calling .
    • +
  • For extensions external to the SDK (such as Extensions Marketplace extensions and SDK extensions), you need to call this method before calling .
    • diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita index 3af4daaa686..63e476eafdd 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_setlowlightenhanceoptions.dita @@ -68,7 +68,7 @@ type - The type of the video source, see . + The type of the video source. See .
    diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita index 84a08db2608..0ab82ad3238 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita @@ -63,13 +63,13 @@ channelMediaRelayStateDidChange:(AgoraChannelMediaRelayState)state

    The error code of the channel media relay.

    • (0): Everything is normal.
    • (1): An error occurs in the server response.
      • -
    • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error can also occur if your project does not enable the channel media relay service. You can to enable the service.
      • +
    • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error can also occur if the channel media relay service is not enabled in the project. You can contact to enable the service.
    • (3): The SDK fails to access the service, probably due to limited resources of the server.
    • 4: The server fails to send the relay request.
    • 5: The server fails to accept the relay request.
    • 6: The server fails to receive the media stream.
    • 7: The server fails to send the media stream.
      • -
    • (8): The SDK disconnects from the server due to poor network connections. You can call the method to leave the channel.
      • +
    • (8): The SDK disconnects from the server due to poor network connections. You can call to leave the channel.
    • (9): An internal error occurs in the server.
    • (10): The token of the source channel has expired.
    • (11): The token of the destination channel has expired.
      • diff --git a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita index a7d6f010100..c85e0555fdd 100644 --- a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita +++ b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita @@ -19,7 +19,7 @@

      2: No server response.

      -

      This error may be caused by poor network connections. If this error occurs when initiating a cross-channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel.

      +

      This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel.

      This error can also occur if your project does not enable the channel media relay service. You can contact to enable the service.

       @@ -45,7 +45,7 @@ - 8: The SDK disconnects from the server due to poor network connections. You can call the method to leave the channel. + 8: The SDK disconnects from the server due to poor network connections. You can call to leave the channel. From e65c8460f79e1d506e625139dee903d42c5f6c35 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Thu, 29 Feb 2024 14:27:25 +0800 Subject: [PATCH 10/13] New translations --- en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita | 2 +- ..._irtcengineeventhandler_onchannelmediarelaystatechanged.dita | 2 +- .../API/callback_irtcengineeventhandler_onextensionerror.dita | 2 +- .../API/callback_irtcengineeventhandler_onextensionstarted.dita | 2 +- en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita index d50b4c551ee..b38dc8dcfa2 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita @@ -26,7 +26,7 @@
    Details -

    After successfully deploying the Agora private media server and integrating Agora Native SDK v4.x on the intranet terminal, you can call this method to specify the Local Access Point and assign the access module to the SDK.

    +

    After successfully deploying the Agora private media server and integrating the RTC SDK on the intranet terminal, you can call this method to specify the Local Access Point and assign the access module to the SDK.

    • This method takes effect only after the Agora hybrid cloud solution is deployed. You can contact to get to know more about the Agora hybrid cloud solution.
      • diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita index 0ab82ad3238..af21a3bebc8 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onchannelmediarelaystatechanged.dita @@ -63,7 +63,7 @@ channelMediaRelayStateDidChange:(AgoraChannelMediaRelayState)state

      The error code of the channel media relay.

      • (0): Everything is normal.
      • (1): An error occurs in the server response.
        • -
      • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel. This error can also occur if the channel media relay service is not enabled in the project. You can contact to enable the service.
        • +
      • (2): No server response. This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during channel media relay, you can call to leave the channel. This error can also occur if the channel media relay service is not enabled in the project. You can contact to enable the service.
      • (3): The SDK fails to access the service, probably due to limited resources of the server.
      • 4: The server fails to send the relay request.
      • 5: The server fails to accept the relay request.
        • diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita index 9445076f6b8..bde47ba4034 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionerror.dita @@ -45,7 +45,7 @@

    -

    The extension will trigger this callback and report the error code and error reason when the extension fails to enable or an error occurs during its operation.

    +

    In case of extension enabling failure or runtime errors, the extension triggers this callback and reports the error code along with the reasons.

    Parameters diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita index 3ba8eb244ef..348a2e93f17 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstarted.dita @@ -29,7 +29,7 @@

    -

    The extension will trigger this callback after it is successfully enabled.

    +

    The extension triggers this callback after it is successfully enabled.

    Parameters diff --git a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita index c85e0555fdd..53fa6a5c5a4 100644 --- a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita +++ b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita @@ -19,7 +19,7 @@

    2: No server response.

    -

    This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during the cross-channel media relay, you can call to leave the channel.

    +

    This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during channel media relay, you can call to leave the channel.

    This error can also occur if your project does not enable the channel media relay service. You can contact to enable the service.

     From 2b3acac08c1952b165b65e0cdf40ecd7dadd3831 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Thu, 29 Feb 2024 14:29:04 +0800 Subject: [PATCH 11/13] New translations --- .../dita/RTC-NG/API/api_irtcengine_startscreencapture.dita | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita b/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita index bfff8ed65f6..aba065cbc60 100644 --- a/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita +++ b/en-US/dita/RTC-NG/API/api_irtcengine_startscreencapture.dita @@ -65,9 +65,9 @@
    • 0: Success.
    • < 0: Failure. See for details and resolution suggestions.
        -
      • -2 (iOS platform): Empty parameter.
        • -
      • -2 (Android platform): The system version is too low. Ensure that the Android API level is not lower than 21.
        • -
      • -3 (Android platform): Unable to capture system audio. Ensure that the Android API level is not lower than 29.
        • +
      • -2 (iOS platform): Empty parameter.
        • +
      • -2 (Android platform): The system version is too low. Ensure that the Android API level is not lower than 21.
        • +
      • -3 (Android platform): Unable to capture system audio. Ensure that the Android API level is not lower than 29.
    From a61a3e95b7cf96d1731ae94161da779017925f36 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Thu, 29 Feb 2024 14:29:56 +0800 Subject: [PATCH 12/13] New translations --- en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita index 53fa6a5c5a4..8aee52c5fcd 100644 --- a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita +++ b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita @@ -20,7 +20,7 @@

    2: No server response.

    This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during channel media relay, you can call to leave the channel.

    -

    This error can also occur if your project does not enable the channel media relay service. You can contact to enable the service.

    +

    This error can also occur if the channel media relay service is not enabled in the project. You can contact to enable the service.

     From f3c0a844564ddd48f4c9cee7be53dfafdfd8df87 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Thu, 29 Feb 2024 14:32:27 +0800 Subject: [PATCH 13/13] New translations --- .../API/callback_irtcengineeventhandler_onextensionstopped.dita | 2 +- en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita index 1623f68e68a..842f1cc8786 100644 --- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita +++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onextensionstopped.dita @@ -29,7 +29,7 @@

    -

    The extension will trigger this callback after it is successfully destroyed.

    +

    The extension triggers this callback after it is successfully destroyed.

    Parameters diff --git a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita index 8aee52c5fcd..0679ec723d2 100644 --- a/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita +++ b/en-US/dita/RTC-NG/API/enum_channelmediarelayerror.dita @@ -20,7 +20,7 @@

    2: No server response.

    This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during channel media relay, you can call to leave the channel.

    -

    This error can also occur if the channel media relay service is not enabled in the project. You can contact to enable the service.

    +

    This error can also occur if the channel media relay service is not enabled in the project. You can contact to enable the service.