From 0f4243d7c9affc5239e2cb82b28d6228237b02f6 Mon Sep 17 00:00:00 2001
From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com>
Date: Thu, 24 Oct 2024 16:18:25 +0800
Subject: [PATCH] New translations
---
...iaengine_registervideoencodedframeobserver.dita | 2 +-
...pi_imediaengine_registervideoframeobserver.dita | 2 +-
...api_imediarecorder_enablemainqueuedispatch.dita | 14 +++++++-------
.../API/api_imediarecorder_removealllisteners.dita | 10 +++++-----
.../API/api_irtcengine_enablelocalaudio.dita | 2 +-
.../dita/RTC-NG/API/api_irtcengine_getcallid.dita | 2 +-
.../API/api_irtcengine_geterrordescription.dita | 4 ++--
.../RTC-NG/API/api_irtcengine_joinchannel.dita | 2 +-
.../RTC-NG/API/api_irtcengine_joinchannel2.dita | 4 ++--
.../RTC-NG/API/api_irtcengine_playeffect3.dita | 2 +-
.../api_irtcengine_sendcustomreportmessage.dita | 2 +-
.../API/api_irtcengine_sendstreammessage.dita | 6 +++---
.../RTC-NG/API/api_irtcengine_setclientrole2.dita | 2 +-
...cengine_setdefaultaudioroutetospeakerphone.dita | 2 +-
.../API/api_irtcengine_setlocalaccesspoint.dita | 2 +-
.../API/api_irtcengine_setlocalrendermode.dita | 3 +--
...tcengine_setremotevideosubscriptionoptions.dita | 11 +++++------
.../RTC-NG/API/api_irtcengine_setuplocalvideo.dita | 2 +-
.../API/api_irtcengine_startlastmileprobetest.dita | 2 +-
.../api_irtcengine_startlocalvideotranscoder.dita | 4 ++--
..._irtcengine_startrtmpstreamwithtranscoding.dita | 2 +-
...ngineeventhandler_oncamerafocusareachanged.dita | 2 +-
...irtcengineeventhandler_onclientrolechanged.dita | 2 +-
...ngineeventhandler_onconnectionstatechanged.dita | 10 +++++-----
...ngineeventhandler_onlocalvideostatechanged.dita | 2 +-
...neeventhandler_onrtmpstreamingstatechanged.dita | 2 +-
...lback_ivideoframeobserver_getmirrorapplied.dita | 8 ++++----
...ack_ivideoframeobserver_getrotationapplied.dita | 8 ++++----
.../dita/RTC-NG/API/class_channelmediaoptions.dita | 4 ++--
.../dita/RTC-NG/API/class_lastmileproberesult.dita | 6 +++---
en-US/dita/RTC-NG/API/class_remoteaudiostats.dita | 2 +-
.../API/class_videoencoderconfiguration.dita | 2 +-
en-US/dita/RTC-NG/API/enum_errorcodetype.dita | 2 +-
.../RTC-NG/API/enum_localvideostreamreason.dita | 6 +++---
en-US/dita/RTC-NG/API/enum_qualitytype.dita | 2 +-
35 files changed, 69 insertions(+), 71 deletions(-)
diff --git a/en-US/dita/RTC-NG/API/api_imediaengine_registervideoencodedframeobserver.dita b/en-US/dita/RTC-NG/API/api_imediaengine_registervideoencodedframeobserver.dita
index a41c8d43e0b..cdcff658f94 100644
--- a/en-US/dita/RTC-NG/API/api_imediaengine_registervideoencodedframeobserver.dita
+++ b/en-US/dita/RTC-NG/API/api_imediaengine_registervideoencodedframeobserver.dita
@@ -30,7 +30,7 @@
Details
- If you only want to observe encoded video frames (such as h.264 format) without decoding and rendering the video, Agora recommends that you implement one class through this method. 有关详细的实现步骤,详见。
+ If you only want to observe encoded video frames (such as H.264 format) without decoding and rendering the video, Agora recommends that you implement one class through this method. For detailed implementation steps, please refer to .
Call this method before joining a channel.
diff --git a/en-US/dita/RTC-NG/API/api_imediaengine_registervideoframeobserver.dita b/en-US/dita/RTC-NG/API/api_imediaengine_registervideoframeobserver.dita
index f2b4442176f..8b4f79df006 100644
--- a/en-US/dita/RTC-NG/API/api_imediaengine_registervideoframeobserver.dita
+++ b/en-US/dita/RTC-NG/API/api_imediaengine_registervideoframeobserver.dita
@@ -29,7 +29,7 @@
Applicable scenarios
- After registering the raw video observer, you can use the obtained raw video data in various video pre-processing scenarios, such as virtual backgrounds and image enhacement by yourself. 有关详细的实现步骤,详见。
+ After registering the raw video observer, you can use the obtained raw video data in various video pre-processing scenarios, such as virtual backgrounds and image enhacement by yourself. For detailed implementation steps, please refer to .
Agora provides an open source sample project on GitHub for your reference.
diff --git a/en-US/dita/RTC-NG/API/api_imediarecorder_enablemainqueuedispatch.dita b/en-US/dita/RTC-NG/API/api_imediarecorder_enablemainqueuedispatch.dita
index 5935f98a089..55aae955583 100644
--- a/en-US/dita/RTC-NG/API/api_imediarecorder_enablemainqueuedispatch.dita
+++ b/en-US/dita/RTC-NG/API/api_imediarecorder_enablemainqueuedispatch.dita
@@ -1,12 +1,12 @@
-
+
Enables/Disables dispatching delegate methods to the main queue.
-
+
@@ -25,7 +25,7 @@
Details
- If disabled, the app should dispatch UI operations to the main queue.
+ If disabled, the app should dispatch UI operations to the main queue.
Parameters
@@ -34,8 +34,8 @@
enabled
- - : Dispatch delegate methods to the main queue.
- - : Do not dispatch delegate methods to the main queue.
+ - : Dispatch delegate methods to the main queue.
+ - : Do not dispatch delegate methods to the main queue.
@@ -44,8 +44,8 @@
Returns
- 0: Success.
- - < 0: Failure.
+ - < 0: Failure. See for details and resolution suggestions.
-
\ No newline at end of file
+
diff --git a/en-US/dita/RTC-NG/API/api_imediarecorder_removealllisteners.dita b/en-US/dita/RTC-NG/API/api_imediarecorder_removealllisteners.dita
index 44a2ac1905b..6b8fb80f9e3 100644
--- a/en-US/dita/RTC-NG/API/api_imediarecorder_removealllisteners.dita
+++ b/en-US/dita/RTC-NG/API/api_imediarecorder_removealllisteners.dita
@@ -1,12 +1,12 @@
-
+
Removes all listeners for the specified event.
-
+
@@ -30,9 +30,9 @@
Parameters
-
-
+
+
-
\ No newline at end of file
+
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita b/en-US/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita
index c51873834b7..7e914640742 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita
@@ -34,7 +34,7 @@
Applicable scenarios
- 该方法不影响远端音频流的接收和播放。 () 适用于只接收远端音频而不发送本地采集音频的场景。
+ This method does not affect receiving the remote audio streams. () is suitable for scenarios where the user wants to receive remote audio streams without sending locally captured audio.
Call timing
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_getcallid.dita b/en-US/dita/RTC-NG/API/api_irtcengine_getcallid.dita
index 97b3d83233e..5ca2d1a95c7 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_getcallid.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_getcallid.dita
@@ -26,7 +26,7 @@
- When a user joins a channel on a client, a callId is generated to identify the call from the client. 你可以调用该方法获取 callId 参数,然后在调用 、 等方法时填入。
+ When a user joins a channel on a client, a callId is generated to identify the call from the client. You can call this method to get callId, and pass it in when calling methods such as and .
Call timing
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_geterrordescription.dita b/en-US/dita/RTC-NG/API/api_irtcengine_geterrordescription.dita
index 7970f98adab..0165ecded3a 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_geterrordescription.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_geterrordescription.dita
@@ -33,12 +33,12 @@
code
error
- SDK 报告的错误码。
+ The error code reported by the SDK.
Returns
- 具体的错误描述。
+ The specific error description.
\ No newline at end of file
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_joinchannel.dita b/en-US/dita/RTC-NG/API/api_irtcengine_joinchannel.dita
index a277eb83703..e141152103c 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_joinchannel.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_joinchannel.dita
@@ -72,7 +72,7 @@
uid
- The user ID. This parameter is used to identify the user in the channel for real-time audio and video interaction. You need to set and manage user IDs yourself, and ensure that each user ID in the same channel is unique. This parameter is a 32-bit signed integer. The value range is from -231-1 to 231-1. This parameter is a 32-bit unsigned integer. The value range is 1 to 232-1. If the user ID is not assigned (or set to 0), the SDK assigns a random user ID and returns it in the callback. Your application must record and maintain the returned user ID, because the SDK does not do so.
+ The user ID. This parameter is used to identify the user in the channel for real-time audio and video interaction. You need to set and manage user IDs yourself, and ensure that each user ID in the same channel is unique. This parameter is a 32-bit signed integer. The value range is from -231 to 231-1. This parameter is a 32-bit unsigned integer. The value range is 1 to 232-1. If the user ID is not assigned (or set to 0), the SDK assigns a random user ID and returns it in the callback. Your application must record and maintain the returned user ID, because the SDK does not do so.
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_joinchannel2.dita b/en-US/dita/RTC-NG/API/api_irtcengine_joinchannel2.dita
index 3e5522224b7..6042c627122 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_joinchannel2.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_joinchannel2.dita
@@ -95,7 +95,7 @@
uid
- The user ID. This parameter is used to identify the user in the channel for real-time audio and video interaction. You need to set and manage user IDs yourself, and ensure that each user ID in the same channel is unique. This parameter is a 32-bit signed integer. The value range is from -231-1 to 231-1. This parameter is a 32-bit unsigned integer. The value range is 1 to 232-1. If the user ID is not assigned (or set to 0), the SDK assigns a random user ID and returns it in the callback. Your application must record and maintain the returned user ID, because the SDK does not do so.
+ The user ID. This parameter is used to identify the user in the channel for real-time audio and video interaction. You need to set and manage user IDs yourself, and ensure that each user ID in the same channel is unique. This parameter is a 32-bit signed integer. The value range is from -231 to 231-1. This parameter is a 32-bit unsigned integer. The value range is 1 to 232-1. If the user ID is not assigned (or set to 0), the SDK assigns a random user ID and returns it in the callback. Your application must record and maintain the returned user ID, because the SDK does not do so.
options
@@ -116,7 +116,7 @@
-2: The parameter is invalid. For example, the token is invalid, the uid parameter is not set to an integer, or the value of a member in is invalid. You need to pass in a valid parameter and join the channel again.
-3: Fails to initialize the object. You need to reinitialize the object.
-7: The object has not been initialized. You need to initialize the object before calling this method.
- -8: The internal state of the object is wrong. The typical cause is that after calling to start a call loop test, you call this method to join the channel without calling to stop the test. You need to call before calling this method.
+ -8: The internal state of the object is wrong. The typical cause is that after calling to start a call loop test, you call this method to join the channel without calling to stop the test. You need to call before calling this method.
-17: The request to join the channel is rejected. The typical cause is that the user is already in the channel. Agora recommends that you use the callback to see whether the user is in the channel. Do not call this method to join the channel unless you receive the (1) state.
-102: The channel name is invalid. You need to pass in a valid channel name in channelId to rejoin the channel.
-121: The user ID is invalid. You need to pass in a valid user ID in uid to rejoin the channel.
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_playeffect3.dita b/en-US/dita/RTC-NG/API/api_irtcengine_playeffect3.dita
index 96c7ed740b1..b2ae9f63590 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_playeffect3.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_playeffect3.dita
@@ -97,7 +97,7 @@
The file path. The SDK supports URLs and absolute path of local files. The absolute path needs to be accurate to the file name and extension. Supported audio formats include MP3, AAC, M4A, MP4, WAV, and 3GP. See Supported Audio Formats.
The file path. The SDK supports URI addresses starting with content://, paths starting with /assets/, URLs and absolute paths of local files. The absolute path needs to be accurate to the file name and extension. Supported audio formats include MP3, AAC, M4A, MP4, WAV, and 3GP. See Supported Audio Formats.
The file path. The SDK supports file paths starting with ipod-library//, URLs and absolute file paths of local files. The absolute path needs to be accurate to the file name and extension. Supported audio formats include MP3, AAC, M4A, MP4, WAV, and 3GP. See Supported Audio Formats.
- 播放文件的地址。
+ The file path.
If you have preloaded an audio effect into memory by calling , ensure that the value of this parameter is the same as that of filePath in .
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_sendcustomreportmessage.dita b/en-US/dita/RTC-NG/API/api_irtcengine_sendcustomreportmessage.dita
index 2f59c6d49d0..fa36105d640 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_sendcustomreportmessage.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_sendcustomreportmessage.dita
@@ -53,7 +53,7 @@
Details
- Agora supports reporting and analyzing customized messages. This function is in the beta stage with a free trial. The ability provided in its beta test version is reporting a maximum of 10 message pieces within 6 seconds, with each message piece not exceeding 256 bytes and each string not exceeding 100 bytes. To try out this function, contact and discuss the format of customized messages with us.
+ Agora supports reporting and analyzing customized messages. This function is in the beta stage with a free trial. The ability provided in its beta test version is reporting a maximum of 10 message pieces within 6 seconds, with each message piece not exceeding 256 bytes and each string not exceeding 100 bytes. To try out this function, contact and discuss the format of customized messages with us.
\ No newline at end of file
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_sendstreammessage.dita b/en-US/dita/RTC-NG/API/api_irtcengine_sendstreammessage.dita
index bee8765a921..43f511d6413 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_sendstreammessage.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_sendstreammessage.dita
@@ -37,10 +37,10 @@
Details
After calling , you can call this method to send data stream messages to all users in the channel.
The SDK has the following restrictions on this method:
- - 频道内每个客户端最多可以同时拥有 5 个数据通道,所有数据通道共用的总发包码率限制为 30 KB/s。
- - Up to 60 packets can be sent per second in a data stream with each packet having a maximum size of 1 KB.
+ - Each client within the channel can have up to 5 data channels simultaneously, with a total shared packet bitrate limit of 30 KB/s for all data channels.
+ - Each data channel can send up to 60 packets per second, with each packet being a maximum of 1 KB.
- A successful method call triggers the callback on the remote client, from which the remote user gets the stream message. A failed method call triggers the callback on the remote client.
+ A successful method call triggers the callback on the remote client, from which the remote user gets the stream message. A failed method call triggers the callback on the remote client.
- This method needs to be called after and joining the channel.
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setclientrole2.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setclientrole2.dita
index 5b72016e488..0bf3eb6e9f5 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_setclientrole2.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_setclientrole2.dita
@@ -34,7 +34,7 @@
By default,the SDK sets the user role as audience. You can call this method to set the user role as host. The user role (roles) determines the users' permissions at the SDK level, including whether they can publish audio and video streams in a channel.
- The difference between this method and is that, the former supports setting the audienceLatencyLevel. audienceLatencyLevel needs to be used together with role to determine the level of service that users can enjoy within their permissions. For example, an audience member can choose to receive remote streams with low latency or ultra-low latency. 不同的延时级别会影响计费,详见。
+ The difference between this method and is that, the former supports setting the audienceLatencyLevel. audienceLatencyLevel needs to be used together with role to determine the level of service that users can enjoy within their permissions. For example, an audience member can choose to receive remote streams with low latency or ultra-low latency. Latency of different levels differs in billing. See .
Call timing
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setdefaultaudioroutetospeakerphone.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setdefaultaudioroutetospeakerphone.dita
index 4eb37551ac9..9c2cc1170a8 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_setdefaultaudioroutetospeakerphone.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_setdefaultaudioroutetospeakerphone.dita
@@ -45,7 +45,7 @@
Call timing
- Call this method before joining a channel. 如需在加入频道后切换音频路由,请调用 。
+ Call this method before joining a channel. If you need to change the audio route after joining a channel, call .
Restrictions
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 52fc4d42c5c..8f536b5b392 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalaccesspoint.dita
@@ -34,7 +34,7 @@
Restrictions
- 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.
+ 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.
Parameters
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalrendermode.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalrendermode.dita
index 0cb652216c4..d051a310096 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_setlocalrendermode.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_setlocalrendermode.dita
@@ -55,8 +55,7 @@
uid
-
- 用户 ID。
+ The user ID.
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setremotevideosubscriptionoptions.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setremotevideosubscriptionoptions.dita
index 0c0ebb1e474..44ee510819e 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_setremotevideosubscriptionoptions.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_setremotevideosubscriptionoptions.dita
@@ -35,12 +35,11 @@
Details
- When a remote user has enabled dual-stream mode, you can call this method to choose the option for subscribing to the video streams sent by the remote user. SDK 对远端视频流的默认订阅行为取决于注册的视频观测器类型:
- - 如果注册的是 观测器,则默认订阅原始数据和编码后的数据。
- - 如果注册的是 观测器,则默认仅订阅编码后的数据。
- - 如果注册了两种观测器,则默认跟随后注册的视频观测器。 举例来说,如果后注册的是 观测器,则默认订阅原始数据和编码后的数据。
-
- 如果你想修改以上默认行为,或者想针对不同 uid 设置不同的订阅选项,可调用该方法设置。 有关详细的实现步骤,详见。
+ When a remote user has enabled dual-stream mode, you can call this method to choose the option for subscribing to the video streams sent by the remote user. The default subscription behavior of the SDK for remote video streams depends on the registered video observer type:
+ - If the observer is registered, the default is to subscribe to both raw data and encoded data.
+ - If the observer is registered, the default is to subscribe only to the encoded data.
+ - If both types of observers are registered, the default follows the last registered video observer. For example, if the last registered observer is the observer, the default is to subscribe to both raw data and encoded data.
+
If you want to modify the default behavior above, or want to set different subscription options for different uids, you can call this method to set it. For detailed implementation steps, please refer to .
Parameters
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_setuplocalvideo.dita b/en-US/dita/RTC-NG/API/api_irtcengine_setuplocalvideo.dita
index 1c7d58fd7a6..61005084a8b 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_setuplocalvideo.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_setuplocalvideo.dita
@@ -26,7 +26,7 @@
- This method initializes the video view of a local stream on the local device. It only affects the video seen by the local user and does not impact the publishing of the local video. 调用该方法绑定本地视频流的显示视窗 (view),并设置本地用户视图的渲染模式和镜像模式。
+ This method initializes the video view of a local stream on the local device. It only affects the video seen by the local user and does not impact the publishing of the local video. Call this method to bind the local video stream to a video view (view) and to set the rendering and mirror modes of the video view.
The binding remains valid after leaving the channel. To stop rendering or unbind the local video from the view, set view as .
diff --git a/en-US/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita b/en-US/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita
index 9b6724e9243..2cb050ea915 100644
--- a/en-US/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita
+++ b/en-US/dita/RTC-NG/API/api_irtcengine_startlastmileprobetest.dita
@@ -38,7 +38,7 @@
diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_oncamerafocusareachanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_oncamerafocusareachanged.dita
index b58085cfa15..34fe126fb10 100644
--- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_oncamerafocusareachanged.dita
+++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_oncamerafocusareachanged.dita
@@ -72,7 +72,7 @@
point
- 镜头内表示对焦的点。
+ The focus point within the camera frame.
diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechanged.dita
index 5b790915e29..09d8023b7b9 100644
--- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechanged.dita
+++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onclientrolechanged.dita
@@ -53,7 +53,7 @@ NS_SWIFT_NAME(rtcEngine(_:didClientRoleChanged:newRole:newRoleOptions:));
Restrictions
This callback will not be triggered when you call or and set the user role to BROADCASTER before joining a channel.
- 当你在加入频道前调用 并将用户角色设为 BROADCASTER 时,不会触发此回调。
+ This callback will not be triggered when you call and set the user role to BROADCASTER before joining a channel.
diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onconnectionstatechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onconnectionstatechanged.dita
index 4cca0037701..123ad62ab8a 100644
--- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onconnectionstatechanged.dita
+++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onconnectionstatechanged.dita
@@ -58,11 +58,11 @@
The current connection state. See .
- - (1):网络连接断开。
- - (2):建立网络连接中。
- - (3):网络已连接。
- - (4):重新建立网络连接中。
- - (5):网络连接失败。
+ - (1): The SDK is disconnected from Agora's edge server.
+ - (2): The SDK is connecting to Agora's edge server.
+ - (3): The SDK is connected to Agora's edge server.
+ - (4): The SDK tries to reconnect to the Agora edge server.
+ - (5): The SDK fails to connect to Agora's edge server.
diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalvideostatechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalvideostatechanged.dita
index 169a9876cf0..54913cf300f 100644
--- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalvideostatechanged.dita
+++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onlocalvideostatechanged.dita
@@ -99,7 +99,7 @@
(8): Fails to find a local video capture device. Remind the user to check whether the camera is connected to the device properly or the camera is working properly, and then to rejoin the channel.
(14): Video capture is interrupted. Possible reasons include the following:
- The camera is being used by another app. Prompt the user to check if the camera is being used by another app.
- - 设备已锁屏,或当前 App 已被切换到后台。 You can use foreground services to notify the operating system and ensure that the app can still collect video when it switches to the background. See .
+ - The device is locked, or the current app has been switched to the background. You can use foreground services to notify the operating system and ensure that the app can still collect video when it switches to the background. See .
(15): The video capture device encounters an error. Prompt the user to close and restart the camera to restore functionality. If this operation does not solve the problem, check if the camera has a hardware failure.
diff --git a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onrtmpstreamingstatechanged.dita b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onrtmpstreamingstatechanged.dita
index 79edf63f5df..58ab0ec1897 100644
--- a/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onrtmpstreamingstatechanged.dita
+++ b/en-US/dita/RTC-NG/API/callback_irtcengineeventhandler_onrtmpstreamingstatechanged.dita
@@ -88,7 +88,7 @@
(9): Agora's server fails to find the media stream of Media Push.
(10): The format of the media push URL is not supported. Check whether the URL format is correct.
(11): The user role is not host, so the user cannot use the Media Push function. Check your application code logic.
- (13):非转码推流情况下,调用了 更新转码属性。 Check your application code logic.
+ (13): The method is called to update the transcoding configuration in a scenario where there is Media Push without transcoding. Check your application code logic.
(14): Errors occurred in the host's network.
(16): Your project does not have permission to use Media Push service. Refer to Media Push to enable the Media Push permission.
(100): The Media Push has been stopped normally. After you call to stop the Media Push, the SDK returns this value.
diff --git a/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getmirrorapplied.dita b/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getmirrorapplied.dita
index 89438d81db7..bb42c41a609 100644
--- a/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getmirrorapplied.dita
+++ b/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getmirrorapplied.dita
@@ -27,10 +27,10 @@
If the video data you want to obtain is a mirror image of the original video, you need to register this callback when calling . After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. You need to set whether or not to mirror the video frame in the return value of this callback.
- - 在 Android 平台上,该回调支持的视频数据格式有:I420、RGBA 和 Texture。
- - 在 Windows 平台上,该回调支持的视频数据格式有:I420、RGBA 和 TextureBuffer。
- - 在 iOS 平台上,该回调支持的视频数据格式有:I420、RGBA 和 CVPixelBuffer。
- - 在 macOS 平台上,该回调支持的视频数据格式有:I420 和 RGBA。
+ - On the Android platform, the supported video data formats for this callback are: I420, RGBA, and Texture.
+ - On the Windows platform, the supported video data formats for this callback are: I420, RGBA, and TextureBuffer.
+ - On the iOS platform, the supported video data formats for this callback are: I420, RGBA, and CVPixelBuffer.
+ - On the macOS platform, the supported video data formats for this callback are: I420 and RGBA.
- Both this method and the method support setting the mirroring effect. Agora recommends that you only choose one method to set it up. Using both methods at the same time causes the mirroring effect to overlap, and the mirroring settings fail.
diff --git a/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getrotationapplied.dita b/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getrotationapplied.dita
index 17d8d4dc748..7accb677bc1 100644
--- a/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getrotationapplied.dita
+++ b/en-US/dita/RTC-NG/API/callback_ivideoframeobserver_getrotationapplied.dita
@@ -28,10 +28,10 @@
If the video has been rotated according to rotation in on the capture device, you do not need to call this method to set the video rotation.
- - 在 Android 平台上,该回调支持的视频数据格式有:I420、RGBA 和 Texture。
- - 在 Windows 平台上,该回调支持的视频数据格式有:I420、RGBA 和 TextureBuffer。
- - 在 iOS 平台上,该回调支持的视频数据格式有:I420、RGBA 和 CVPixelBuffer。
- - 在 macOS 平台上,该回调支持的视频数据格式有:I420 和 RGBA。
+ - On the Android platform, the supported video data formats for this callback are: I420, RGBA, and Texture.
+ - On the Windows platform, the supported video data formats for this callback are: I420, RGBA, and TextureBuffer.
+ - On the iOS platform, the supported video data formats for this callback are: I420, RGBA, and CVPixelBuffer.
+ - On the macOS platform, the supported video data formats for this callback are: I420 and RGBA.
diff --git a/en-US/dita/RTC-NG/API/class_channelmediaoptions.dita b/en-US/dita/RTC-NG/API/class_channelmediaoptions.dita
index db3d3946ff3..2490141ca87 100644
--- a/en-US/dita/RTC-NG/API/class_channelmediaoptions.dita
+++ b/en-US/dita/RTC-NG/API/class_channelmediaoptions.dita
@@ -1576,7 +1576,7 @@ public:
publishCustomAudioTrackId
- 待发布的自定义音频轨道的 ID,默认值为 0。 你可以通过 方法来获取自定义音频轨道 ID。
+ The ID of the custom audio track to be published. The default value is 0. You can obtain the custom audio track ID through the method.
publishCustomVideoTrack
@@ -1713,7 +1713,7 @@ public:
: The audio stream is filtered. If the audio stream filter is not enabled, this setting does not takes effect.
: The audio stream is not filtered.
- 如需启用该功能,请。
+ If you need to enable this function, contact .
diff --git a/en-US/dita/RTC-NG/API/class_lastmileproberesult.dita b/en-US/dita/RTC-NG/API/class_lastmileproberesult.dita
index c206aa61300..486968d3a2d 100644
--- a/en-US/dita/RTC-NG/API/class_lastmileproberesult.dita
+++ b/en-US/dita/RTC-NG/API/class_lastmileproberesult.dita
@@ -144,10 +144,10 @@ public:
state
The status of the last-mile network tests. See .
- The status of the last-mile network tests, which includes:
+ The status of the last-mile network test, which includes:
- (1): The last-mile network probe test is complete.
- - (2): The last-mile network probe test is incomplete because the bandwidth estimation is not available due to limited test resources. Probably due to limited test resources.
- - (3): The last-mile network probe test is not carried out. Probably due to poor network conditions.
+ - (2): The last-mile network probe test is incomplete because bandwidth prediction is not conducted. One possible reason is that testing resources were temporarily limited.
+ - (3): The last-mile network probe test is not conducted. Probably due to poor network conditions.
diff --git a/en-US/dita/RTC-NG/API/class_remoteaudiostats.dita b/en-US/dita/RTC-NG/API/class_remoteaudiostats.dita
index 1af4f1907c2..0a5826a74c4 100644
--- a/en-US/dita/RTC-NG/API/class_remoteaudiostats.dita
+++ b/en-US/dita/RTC-NG/API/class_remoteaudiostats.dita
@@ -433,7 +433,7 @@ class RemoteAudioStats {
(4): Users cannot communicate smoothly.
(5): The quality is so bad that users can barely communicate.
(6): The network is down, and users cannot communicate at all.
- (8):网络质量检测进行中。
+ (8): The last-mile probe test is in progress.
diff --git a/en-US/dita/RTC-NG/API/class_videoencoderconfiguration.dita b/en-US/dita/RTC-NG/API/class_videoencoderconfiguration.dita
index a6ff97fdd1a..6111f0a70cf 100644
--- a/en-US/dita/RTC-NG/API/class_videoencoderconfiguration.dita
+++ b/en-US/dita/RTC-NG/API/class_videoencoderconfiguration.dita
@@ -570,7 +570,7 @@ public:
dimensions
- 视频编码的分辨率 (px),详见 。 This parameter measures the video encoding quality in the format of length × width. The default value is 960 × 540. You can set a custom value.
+ The dimensions of the encoded video (px). See . This parameter measures the video encoding quality in the format of length × width. The default value is 960 × 540. You can set a custom value.
Users can set the resolution by themselves, or directly select the desired resolution from the following list:
- : The video resolution is 120 × 120.
- : The video resolution is 160 × 120.
diff --git a/en-US/dita/RTC-NG/API/enum_errorcodetype.dita b/en-US/dita/RTC-NG/API/enum_errorcodetype.dita
index a582c70d900..26709bab79c 100644
--- a/en-US/dita/RTC-NG/API/enum_errorcodetype.dita
+++ b/en-US/dita/RTC-NG/API/enum_errorcodetype.dita
@@ -42,7 +42,7 @@
5: The request is rejected. Possible reasons include the following:
- - 初始化失败。 Reinitialize the .
+ - The initialization fails. Reinitialize the .
- The channel name is set as the empty string "" when joining the channel. Reset the channel name.
- When the method is called to join multiple channels, the specified channel name is already in use. Reset the channel name.
diff --git a/en-US/dita/RTC-NG/API/enum_localvideostreamreason.dita b/en-US/dita/RTC-NG/API/enum_localvideostreamreason.dita
index 6ab0c8ba0b5..8fde8a39f99 100644
--- a/en-US/dita/RTC-NG/API/enum_localvideostreamreason.dita
+++ b/en-US/dita/RTC-NG/API/enum_localvideostreamreason.dita
@@ -132,15 +132,15 @@
- 31:用户已停止屏幕共享。
+ 31: User has stopped screen sharing.
- 32:屏幕共享进程已被其他屏幕共享进程打断。
+ 32: The screen sharing process has been interrupted by another screen sharing process.
- 33:屏幕共享进程被系统来电打断。
+ 33: The screen sharing process was interrupted by a system call.
diff --git a/en-US/dita/RTC-NG/API/enum_qualitytype.dita b/en-US/dita/RTC-NG/API/enum_qualitytype.dita
index 573ce0b60e8..ee4f463a9e1 100644
--- a/en-US/dita/RTC-NG/API/enum_qualitytype.dita
+++ b/en-US/dita/RTC-NG/API/enum_qualitytype.dita
@@ -41,7 +41,7 @@
- 8: 网络质量检测进行中。
+ 8: The last-mile network probe test is in progress.