After calling this method, if you receive the
If the preload is successful and you want to play the media resource, call
Agora does not support preloading duplicate media resources to the playlist. However, you can preload the media resources that are being played to the playlist again.
+This callback reports the last mile network conditions of each user in the channel. Last mile refers to the connection between the local device and Agora's edge server.
The SDK triggers this callback once every two seconds. If a channel includes multiple users, the SDK triggers this callback as many times.
This callback provides feedback on network quality through sending and receiving broadcast packets within the channel. Excessive broadcast packets can lead to broadcast storms. To prevent broadcast storms from causing a large amount of data transmission within the channel, this callback supports feedback on the network quality of up to 4 remote hosts simultaneously by default.
-
+
当你需要使用播放器播放视频，你可以调用该方法将一个视图（view）添加到视频渲染器中，以便显示视频内容。
+Call this method
当前仅支持添加一个视图。
+When the method call succeeds, there is no return value; when fails, the
添加视图是否成功：
+
Call this method after
None.
+
+
Call this method after
None.
+
+
当你调用
Call this method
一次只能移除一个视图。
+When the method call succeeds, there is no return value; when fails, the
移除视图是否成功：
+
Call this method
None.
+
+
None.
+当前设置的镜像模式，详见
+
Call this method after
None.
+当前设置的视频渲染模式，详见
+
Call this method
None.
+
+
Call this method
None.
+
+
None.
+When the method call succeeds, there is no return value; when fails, the
+
当你调用
Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
设置的 JSON 配置信息。
+
Call this method
None.
+调用该方法失败时，SDK 会抛出
+
当你需要设置私有参数或使用定制功能时，可以调用该方法。
+Call this method
None.
+
+
当调用 API 失败时，可调用此方法以获取错误码。
+None.
+When the method call succeeds, there is no return value; when fails, the
Error code. See
+
当 API 调用失败后，你可以调用该方法获取错误信息来帮助排查问题。
+None.
+When the method call succeeds, there is no return value; when fails, the
+
调用该方法可以获取美型部位当前设置的参数信息。
+用户在 App 中打开美型部位和修饰力度菜单时，你可以调用该方法获取当前的美型部位选项，然后根据结果刷新用户界面中的菜单，并更新 UI。
+Call
None.
+美型部位。 See
美型部位：
When the method call succeeds, there is no return value; when fails, the
+
When the method call succeeds, there is no return value; when fails, the
+
调用该方法可以获取美型效果当前设置的参数信息。
+用户在 App 中打开美型风格和风格强度菜单时，你可以调用该方法获取当前的美型效果选项，然后根据结果刷新用户界面中的菜单，并更新 UI。
+Call
None.
+When the method call succeeds, there is no return value; when fails, the
+
When the method call succeeds, there is no return value; when fails, the
+
成功调用该方法后，你设置的外部
当停止屏幕共享或销毁
如果你具备自行申请
For detailed implementation steps, please refer to
Call this method
在调用该方法前，必须先申请
When the method call succeeds, there is no return value; when fails, the
+
通过设置该方法，开发者可以替换 SDK 内部默认的远端 EGL 环境上下文，便于实现统一的 EGL 上下文管理。
+引擎销毁时，SDK 会自动释放 EGL 环境上下文。
+该方法适用于使用 Texture 格式的视频数据进行远端视频自渲染的场景。
+Call this method before joining a channel.
+None.
+When the method call succeeds, there is no return value; when fails, the
+
如果在
该方法和
Call this method after calling
When the method call succeeds, there is no return value; when fails, the
+
如果在
Call
When the method call succeeds, there is no return value; when fails, the
+
调用该方法可对人脸各部位进行修饰，使用预设的参数一次性实现瘦脸、大眼、瘦鼻等微整形效果，支持微调整体的修饰力度，详见
该方法和
Call
When the method call succeeds, there is no return value; when fails, the
+
调用该方法可对脸部指定部位进行调整，从而实现瘦脸、大眼、瘦鼻等微整形效果，详见
When the method call succeeds, there is no return value; when fails, the
+
Both this method and
Call
When the method call succeeds, there is no return value; when fails, the
+
When the method call succeeds, there is no return value; when fails, the
+
在对视频渲染帧率要求不高的场景（例如：屏幕共享、在线教育）下，你可以调用该方法设置本地视频渲染的最大帧率，SDK 进行本地渲染的实际帧率会尽量接近该值，从而减小 CPU 消耗、提升系统性能。
+You can call this method either before or after joining a channel.
+None.
+When the method call succeeds, there is no return value; when fails, the
The low-light enhancement feature can adaptively adjust the brightness value of the video captured in situations with low or uneven lighting, such as backlit, cloudy, or dark scenes. It restores or highlights the image details and improves the overall visual effect of the video.
+You can call this method to enable the color enhancement feature and set the options of the color enhancement effect.
-The low-light enhancement feature can adaptively adjust the brightness value of the video captured in situations with low or uneven lighting, such as backlit, cloudy, or dark scenes. It restores or highlights the image details and improves the overall visual effect of the video.
+Call this method after calling
+
在对视频渲染帧率要求不高的场景（例如：屏幕共享、在线教育）或者远端使用中低端设备的场景下，你可以调用该方法设置视频在远端渲染的最大帧率，SDK 进行远端视频渲染的实际帧率会尽量接近该值，从而减小 CPU 消耗、提升系统性能。
+You can call this method either before or after joining a channel.
+None.
+When the method call succeeds, there is no return value; when fails, the
Underlit environments and low-end video capture devices can cause video images to contain significant noise, which affects video quality. In real-time interactive scenarios, video noise also consumes bitstream resources and reduces encoding efficiency during encoding.
+You can call this method to enable the video noise reduction feature and set the options of the video noise reduction effect.
-Underlit environments and low-end video capture devices can cause video images to contain significant noise, which affects video quality. In real-time interactive scenarios, video noise also consumes bitstream resources and reduces encoding efficiency during encoding.
+Call this method after calling
+
该方法支持在本地将多路音频流合并为一路音频流。 例如：将本地麦克风采集的音频流、媒体播放器中的音频流、声卡采集的音频流、远端音频流等合并为一路音频流，然后将合流后的音频流发布到频道中。
你可以在如下场景中开启该功能：
You can call this method either before or after joining a channel.
+为了保证音频质量，建议参与本地合流的音频流数量不超过 10 个。
+When the method call succeeds, there is no return value; when fails, the
+
After calling
Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
+
This method takes a snapshot of a video stream from the specified user, generates a JPG image, and saves it to the specified path.
+Call this method after joining a channel.
+When the method call succeeds, there is no return value; when fails, the
+
After calling , call this method if you want to update the local video mixing
Call this method after
When the method call succeeds, there is no return value; when fails, the
+
Call this method after
When the method call succeeds, there is no return value; when fails, the
+
None.
+
+
你可以通过该方法获取播放器及媒体流的相关信息，例如音频采样率、视频帧的尺寸等信息。
+Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
获取信息是否成功：
+
该方法用于获取播放器的统计信息，包括解码、渲染帧率、音视频码率等，并通过回调函数异步返回结果。
+Call this method after
None.
+
+
观众端可以调用该方法来设置是否订阅主播的音频流。
+Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
订阅或取消订阅操作是否成功：
+
观众端可以调用该方法来设置是否订阅主播的视频流。
+None.
+When the method call succeeds, there is no return value; when fails, the
订阅或取消订阅操作是否成功：
+
该方法支持通过 URL 打开实时流媒体。 如果你想要加快打开 URL 资源的速度，可以在调用该方法前，调用
如果资源打开失败，你会收到
Call this method after
该方法目前仅支持打开以
+
当你调用
Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
暂停播放是否成功：
+
如果你关闭了自动播放，当你调用
Call this method after you call and receive the
该方法目前仅支持播放带
When the method call succeeds, there is no return value; when fails, the
播放是否成功：
+
Call this method after
None.
+
+
成功预加载后，可以加快通过
在打开媒体资源之前，提前加载可以减少用户等待时间，提供更流畅的视听体验。
+Call this method
该方法目前仅对带
各字段的详细说明详见
When the method call succeeds, there is no return value; when fails, the
预加载是否成功：
+
调用该方法前，你需要实现一个继承自
None.
+When the method call succeeds, there is no return value; when fails, the
注册是否成功：
+
该方法用于指定一个 Canvas 对象来显示视频。 当视频流成功播放后，视频画面会显示在这个指定的 Canvas 上。
+Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
设置是否成功：
+
你可以调用该方法来进行播放器设置，如开启自动播放、订阅不同分辨率和码率的视频流等。
+Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
播放器设置是否成功：
+
当你成功打开 URL 流并调用
如果你调用
Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
停止播放是否成功：
+
调用
Call this method
None.
+When the method call succeeds, there is no return value; when fails, the
取消注册是否成功：
+
你可以调用该方法来得知当前播放器的自动播放设置。
+Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
获取自动播放设置是否成功：
+
当你调用
Call this method
None.
+
+
None.
+When the method call succeeds, there is no return value; when fails, the
获取配置是否成功：
+
调用该方法创建的 RTE 对象，无需再通过
调用该方法前，请确保已调用
None.
+When the method call succeeds, there is no return value; when fails, the
一个 RTE 对象。
+
此方法为异步方法，通过回调函数返回初始化结果。
+该方法需要在创建 RTE 对象并设置 App ID 后调用。
+None.
+When the method call succeeds, there is no return value; when fails, the
异步操作是否成功加入队列：
+
//TODO rte Observer 回调类文档不暴露的话，只暴露这个接口是否有意义？
+成功注册观测器对象后，你可以接收
如果注册失败，SDK 会抛出
请在初始化 RTE 引擎后再调用该方法。
+None.
+When the method call succeeds, there is no return value; when fails, the
观测器对象是否注册成功：
+
RTE 对象用于组织和管理 Rte 内部相关资源。
+Call this method
None.
+
+
你可以调用该方法来设置 App ID 等信息。
+ +Call this method after
None.
+When the method call succeeds, there is no return value; when fails, the
配置是否成功：
+
成功调用
如果取消注册失败，SDK 会抛出
Call
None.
+When the method call succeeds, there is no return value; when fails, the
取消注册是否成功：
+
此异常携带的错误码，详见
+
当异步操作完成后，SDK 会触发该回调报告异步操作的结果。
+
+
当获取媒体资源信息的异步操作完成后，SDK 会触发该回调报告异步操作的结果。
+None.
+
+
当主播的音量发生变化时，SDK 会触发该回调。
+None.
+
+
如果你需要监控播放器事件，需要先调用
当播放器事件发生变化时，SDK 会触发该回调。
+None.
+
+
如果你需要获取媒体流的附属信息，需要先调用
在 SDK 解析播放器所播放的媒体流的附属信息后，会触发该回调报告数据的类型及其具体内容。
+None.
+
+
如果你需要获取播放器、媒体流的相关信息，需要先调用
当播放器及媒体流的相关信息发生变化时，SDK 会触发该回调。
+None.
+
+
如果你需要监控播放器所播放视频流分辨率的变化，需要先调用
当视频流的分辨率发生变化时，SDK 会触发该回调报告当前视频的宽高。
+None.
+
+
如果你需要监控播放器状态的变化，需要先调用
当播放器状态发生变化时，SDK 会触发此回调报告当前和变化之前的状态。
+None.
+
+
+
+
+
+
美型部位，详见
美型部位：
+
美型风格，详见
美型风格：
+
3D 立方体贴图文件的本地绝对路径，该文件用于实现自定义滤镜效果。 引用的 .cube 文件必须严格遵循立方体查找表（Cube LUT）规范，否则滤镜效果无法生效。 以下为 .cube 文件的示例：
+
+
+
+
The user ID of the remote user.
+The audio track ID. Set this parameter to the custom audio track ID returned in
+
+
+
+
+
Note that the buffer provides a pointer to a pointer. This interface cannot modify the pointer of the buffer, but it can modify the content of the buffer.
+
You can call this method either before or after joining a channel.
+None.
+When the method call succeeds, there is no return value; when fails, the
+
After the user leaves the channel, the SDK automatically disables the built-in encryption. To enable the built-in encryption, call this method before the user joins the channel again.
+Scenarios with higher security requirements.
+Call this method before joining a channel.
+Whether to enable built-in encryption:
When the method call succeeds, there is no return value; when fails, the
+
Agora recommends that you call this method after joining a channel.
+Whether to enable the extension:
When the method call succeeds, there is no return value; when fails, the
+
This method needs to be called after the camera is started (for example, by calling
None.
+When the method call succeeds, there is no return value; when fails, the
+
The voice AI tuner supports enhancing sound quality and adjusting tone style.
+Social entertainment scenes including online KTV, online podcast and live streaming in showrooms, where high sound quality is required.
+This method can be called either before or after joining the channel.
+None.
+When the method call succeeds, there is no return value; when fails, the
+
This method can be called either before or after joining the channel.
+None.
+
+
This method can be called either before or after joining the channel.
+None.
+
+
If you want to enable the wide-angle or ultra-wide-angle mode for camera capture, it is recommended to start by calling this method to check whether the device supports the required focal length capability. Then, adjust the camera's focal length configuration based on the query result by calling
Returns an array of
Returns an object containing the following properties:
+
Input and output parameter. An array representing the video codec capabilities of the SDK. See
+
For extensions external to the SDK (such as those from Extensions Marketplace and SDK Extensions), you need to load them before calling this method. Extensions internal to the SDK (those included in the full SDK package) are automatically loaded and registered after the initialization of
When the method call succeeds, there is no return value; when fails, the
+
After enabling the extension, you can call this method to set the properties of the extension.
+Call this mehtod after calling
If you want to set properties for multiple extensions, you need to call this method multiple times.
+When the method call succeeds, there is no return value; when fails, the
+
You can call this method to set the attributes of the extension provider and initialize the relevant parameters according to the type of the provider.
+Call this method before
If you want to set the properties of the extension provider for multiple extensions, you need to call this method multiple times.
+When the method call succeeds, there is no return value; when fails, the
+
Captures the video stream of a screen or a part of the screen area.
+In the screen sharing scenario, you need to call this method to start capturing the screen video stream. For implementation guidance of screen sharing, please refer to
You can call this method either before or after joining the channel, with the following differences:
None.
+When the method call succeeds, there is no return value; when fails, the
+
This method captures a window or part of the window. You need to specify the ID of the window to be captured.
+This method supports window sharing of UWP (Universal Windows Platform) applications. Agora tests the mainstream UWP applications by using the lastest SDK, see details as follows:
+
In the screen sharing scenario, you need to call this method to start capturing the screen video stream. For implementation guidance of screen sharing, please refer to
The window sharing feature of the Agora SDK relies on WGC (Windows Graphics Capture) or GDI (Graphics Device Interface) capture, and WGC cannot be set to disable mouse capture on systems earlier than Windows 10 2004. Therefore,
None.
+(Optional) The relative location of the region to the window. If you do not set this parameter, the SDK shares the whole window. It consists of the following parameters:
If the specified region overruns the window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole window.
+When the method call succeeds, there is no return value; when fails, the
+
After the user leaves the channel, the SDK automatically disables the built-in encryption. To enable the built-in encryption, call this method before the user joins the channel again.
+When the method call succeeds, there is no return value; when fails, the
+
In case of extension enabling failure or runtime errors, the extension triggers this callback and reports the error code along with the reasons.
+
+
To listen for events while the extension is running, you need to register this callback.
+
+
The callback is triggered after the extension is successfully enabled.
+
+
The callback is triggered after the extension is successfully disabled.
+
+
+
+
+
Whether to publish the video captured from the screen:
Whether to publish the video captured from the screen:
Whether to publish the audio captured from the screen:
+
+
Delay (in milliseconds) for sending audio frames. You can use this parameter to set the delay of the audio frames that need to be sent, to ensure audio and video synchronization.
+To switch off the delay, set the value to 0.
+(Optional) The token generated on your server for authentication. See
+
The video type. See
+
The alpha channel data output by using portrait segmentation algorithm. This data matches the size of the video frame, with each pixel value ranging from [0,255], where 0 represents the background and 255 represents the foreground (portrait).
+By setting this parameter, you can render the video background into various effects, such as transparent, solid color, image, video, etc.
+
+
+
+
+
+
+
+
+
The dimensions of the encoded video (px). See
Users can set the resolution by themselves, or directly select the desired resolution from the following list:
The minimum encoding bitrate (Kbps) of the video.
+The SDK automatically adjusts the encoding bitrate to adapt to the network conditions. Using a value greater than the default value forces the video encoder to output high-quality images but may cause more packet loss and sacrifice the smoothness of the video transmission. Unless you have special requirements for image quality, Agora does not recommend changing this value.
+Sets the mirror mode of the published local video stream. It only affects the video that the remote user sees. See
Sets the mirror mode of the published local video stream. It only affects the video that the remote user sees.
+
Note that the buffer provides a pointer to a pointer. This interface cannot modify the pointer of the buffer, but it can modify the content of the buffer.
+The alpha channel data output by using portrait segmentation algorithm. This data matches the size of the video frame, with each pixel value ranging from [0,255], where 0 represents the background and 255 represents the foreground (portrait).
+By setting this parameter, you can render the video background into various effects, such as transparent, solid color, image, video, etc.
+The meta information in the video frame. To use this parameter, contact
+
美型部位。 See
Facial enhancement areas. See
美型部位：
You can call this method to enable the color enhancement feature and set the options of the color enhancement effect.
The low-light enhancement feature can adaptively adjust the brightness value of the video captured in situations with low or uneven lighting, such as backlit, cloudy, or dark scenes. It restores or highlights the image details and improves the overall visual effect of the video.
Call this method after calling
You can call this method to enable the video noise reduction feature and set the options of the video noise reduction effect.
Underlit environments and low-end video capture devices can cause video images to contain significant noise, which affects video quality. In real-time interactive scenarios, video noise also consumes bitstream resources and reduces encoding efficiency during encoding.
Call this method after calling
美型部位，详见
美型部位：
@@ -59,12 +59,12 @@
@@ -37,7 +37,7 @@
Note that the buffer provides a pointer to a pointer. This interface cannot modify the pointer of the buffer, but it can modify the content of the buffer.
You can call this method either before or after joining a channel.
-None.
diff --git a/en-US/dita/RTC-NG/API/api_imediaplayer_pause.dita b/en-US/dita/RTC-NG/API/api_imediaplayer_pause.dita index 685fb532187..8432c683bfc 100644 --- a/en-US/dita/RTC-NG/API/api_imediaplayer_pause.dita +++ b/en-US/dita/RTC-NG/API/api_imediaplayer_pause.dita @@ -32,7 +32,7 @@You can call this method either before or after joining a channel.
-None.
diff --git a/en-US/dita/RTC-NG/API/api_imediaplayer_setplaybackspeed.dita b/en-US/dita/RTC-NG/API/api_imediaplayer_setplaybackspeed.dita index f6e0465ea6e..a9013c53505 100644 --- a/en-US/dita/RTC-NG/API/api_imediaplayer_setplaybackspeed.dita +++ b/en-US/dita/RTC-NG/API/api_imediaplayer_setplaybackspeed.dita @@ -34,7 +34,7 @@You can call this method to switch the media resource to be played according to the current network status. For example:
After calling this method, if you receive the
调用该方法后，如果你收到
If you want to customize CDN routes for playing the media resource, call the
Make sure to set this parameter as
Agora recommends that you call this method after joining a channel.
This method must be called after the SDK triggers the
This method must be called after the SDK triggers the
The low-light enhancement feature can adaptively adjust the brightness value of the video captured in situations with low or uneven lighting, such as backlit, cloudy, or dark scenes. It restores or highlights the image details and improves the overall visual effect of the video.
+This method and
Underlit environments and low-end video capture devices can cause video images to contain significant noise, which affects video quality. In real-time interactive scenarios, video noise also consumes bitstream resources and reduces encoding efficiency during encoding.
+You can call this method to enable the video noise reduction feature and set the options of the video noise reduction effect.
Both this method and
Media device states:
After calling
After calling
+
+
0: (Default) Prefers to reduce the video frame rate while maintaining video resolution during video encoding under limited bandwidth. This degradation preference is suitable for scenarios where video quality is prioritized.
-Common scenarios reporting this error code:
3: 秀场直播
+ +
-
-
You need to register the callback when calling the
Call
Call this method after calling
Call
Call this method after calling
For detailed implementation steps, please refer to
Call
Call this method after calling
Both this method and
Both this method and
Call
Call this method after calling
在对视频渲染帧率要求不高的场景（例如：屏幕共享、在线教育）或者远端使用中低端设备的场景下，你可以调用该方法设置视频在远端渲染的最大帧率，SDK 进行远端视频渲染的实际帧率会尽量接近该值，从而减小 CPU 消耗、提升系统性能。
+In scenarios where the video rendering frame rate is not critical (e.g., screen sharing, online education) or when the remote users are using mid-to-low-end devices, you can call this method to set the maximum frame rate for video rendering on the remote client. The SDK will attempt to render the actual frame rate as close as possible to this value, which helps to reduce CPU consumption and improve system performance.
Call
Call this method after calling
在对视频渲染帧率要求不高的场景（例如：屏幕共享、在线教育）下，你可以调用该方法设置本地视频渲染的最大帧率，SDK 进行本地渲染的实际帧率会尽量接近该值，从而减小 CPU 消耗、提升系统性能。
+In scenarios where the requirements for video rendering frame rate are not high (such as screen sharing or online education), you can call this method to set the maximum frame rate for local video rendering. The SDK will attempt to keep the actual frame rate of local rendering close to this value, which helps to reduce CPU consumption and improving system performance.
该方法用于指定一个 Canvas 对象来显示视频。 当视频流成功播放后，视频画面会显示在这个指定的 Canvas 上。
+This method specifies a Canvas object to display the video. Once the the video stream sucessfully plays, the video image will be displayed on the specified canvas.
When the method call succeeds, there is no return value; when fails, the
设置是否成功：
Whether the settings are successful:
When the method call succeeds, there is no return value; when fails, the
播放器设置是否成功：
当你成功打开 URL 流并调用
如果你调用
After you successfully play the URL stream using
If you fail to open the URL stream using
When the method call succeeds, there is no return value; when fails, the
停止播放是否成功：
Whether the media resource stops playing:
调用该方法创建的 RTE 对象，无需再通过
The RTE object created by calling this method does not need to be initialized again using
调用该方法前，请确保已调用
Before calling this method, ensure that you have initialized the RTC engine using
When the method call succeeds, there is no return value; when fails, the
一个 RTE 对象。
An RTE object.
RTE 对象用于组织和管理 Rte 内部相关资源。
+The RTE object manages the internal resources of Rte.
如果你需要监控播放器所播放视频流分辨率的变化，需要先调用
To monitor the resolution changes of the video stream being played, ensure that you call
当视频流的分辨率发生变化时，SDK 会触发该回调报告当前视频的宽高。
+When the resolution of the video stream changes, the SDK triggers this callback to report the current width and height of the video.
@@ -45,17 +45,17 @@
美型风格，详见 美型风格： Face shape beauty style options: The face shape beauty style:
-
+
Call this method
Call this method after
Call this method
Call this method after
Call this method
Call this method after
Call this method
Call this method after
Call this method
Call this method after
Call this method
Call this method after
Call this method
Call this method after
Call this method
Call this method after
你可以调用该方法来进行播放器设置，如开启自动播放、订阅不同分辨率和码率的视频流等。
+You can call this method to configuer the player, such as enableing autoplay and subscribing to video streams of different resolutions and bitrate.
When the method call succeeds, there is no return value; when fails, the
播放器设置是否成功：
Whether the player is configured successfully:
When the method call succeeds, there is no return value; when fails, the
获取自动播放设置是否成功：
当你调用
Before you call
Call this method
Call this method after
When the method call succeeds, there is no return value; when fails, the
获取配置是否成功：
Whether the RTE object is configured successfully:
此方法为异步方法，通过回调函数返回初始化结果。
+This method is asynchronous, which means that the result of initialization is retured through a callback.
该方法需要在创建 RTE 对象并设置 App ID 后调用。
+Call this method after the intializing the RTE object and sets the App ID.
When the method call succeeds, there is no return value; when fails, the
异步操作是否成功加入队列：
Whether the asynchronous operation is added to the queue:
//TODO rte Observer 回调类文档不暴露的话，只暴露这个接口是否有意义？
-成功注册观测器对象后，你可以接收
如果注册失败，SDK 会抛出
After you successfully register the observer object, you can receive callback events in the
If the registration fails, the SDK throws
你可以调用该方法来设置 App ID 等信息。
+You can use this method to set information such as the App ID.
When the method call succeeds, there is no return value; when fails, the
配置是否成功：
Whether the RTE object is configured successfully:
当主播的音量发生变化时，SDK 会触发该回调。
+The SDK triggers this callback when the volumn of the broadcaster changes.
如果你需要监控播放器事件，需要先调用
To monitor player events, you need to call
当播放器事件发生变化时，SDK 会触发该回调。
+The SDK triggers this callback when the player event changes.
如果你需要获取媒体流的附属信息，需要先调用
To receive the metadata of the media stream, call
在 SDK 解析播放器所播放的媒体流的附属信息后，会触发该回调报告数据的类型及其具体内容。
+After the SDK parses the metadata of the media stream being played, it triggers this callback to report the data type and its content.
如果你需要获取播放器、媒体流的相关信息，需要先调用
To receive the information of the player and the media stream, call
当播放器及媒体流的相关信息发生变化时，SDK 会触发该回调。
+The SDK triggers this callback when the information of the player and the media stream changes.
If autoplay is disabled, you need to call the
当你需要使用播放器播放视频，你可以调用该方法将一个视图（view）添加到视频渲染器中，以便显示视频内容。
+When you need to use a player to play a video, you can call this method to add a view to the video renderer for displaying.
当前仅支持添加一个视图。
+Only one view can be added.
After calling the
After calling the
When the method call succeeds, there is no return value; when fails, the
添加视图是否成功：
Whether the view is added successfully:
调用该方法失败时，SDK 会抛出
If the method call fails, the SDK throws
当 API 调用失败后，你可以调用该方法获取错误信息来帮助排查问题。
+When an API call fails, you can use this method to retrieve error information to help troubleshoot the issue.
成功调用该方法后，你设置的外部
After successfully calling this method, the external
当停止屏幕共享或销毁
通过设置该方法，开发者可以替换 SDK 内部默认的远端 EGL 环境上下文，便于实现统一的 EGL 上下文管理。
-引擎销毁时，SDK 会自动释放 EGL 环境上下文。
+This method can replace the default remote EGL context within the SDK, making it easier to manage the EGL context.
+When the engine is destroyed, the SDK will automatically release the EGL context.
该方法适用于使用 Texture 格式的视频数据进行远端视频自渲染的场景。
+This method is suitable for using a custom video rendering method instead of the default SDK rendering method to render remote video frames in Texture format.
//TODO rte Observer 回调类文档不暴露的话，只暴露这个接口是否有意义？
After you successfully register the observer object, you can receive callback events in the
If the registration fails, the SDK throws
If the registration fails, the SDK throws
成功调用
如果取消注册失败，SDK 会抛出
如果取消注册失败，SDK 会抛出
当前设置的镜像模式，详见
The current image mode. See
After successfully calling this method, the external
当停止屏幕共享或销毁
After successfully calling this method, the external
When the screen sharing is stopped or
如果你具备自行申请
If you are able to apply for
在调用该方法前，必须先申请
Before calling this method, you must first apply for
当你调用
After you call
Call this method
Call this method after
一次只能移除一个视图。
+Only one view can be removed at a time.
When the method call succeeds, there is no return value; when fails, the
移除视图是否成功：
Whether the view is removed successfully:
当前设置的视频渲染模式，详见
The current video rendering mode. See
When the method call succeeds, there is no return value; when fails, the
当你调用
After you call
When the method call succeeds, there is no return value; when fails, the
设置的 JSON 配置信息。
The JSON configuration you set.
当你需要设置私有参数或使用定制功能时，可以调用该方法。
+When you need to set private parameters or use custom features, you can call this method.
当调用 API 失败时，可调用此方法以获取错误码。
+When an API call fails, you can call this method to get the error code.
你可以调用该方法来得知当前播放器的自动播放设置。
+You can call this method to get the autoplay settings of the current player.
When the method call succeeds, there is no return value; when fails, the
获取自动播放设置是否成功：
Whether the autoplay settings are retrieved:
此异常携带的错误码，详见
The error code contained in the exception:
当异步操作完成后，SDK 会触发该回调报告异步操作的结果。
+After the asynchronous operation is completed, the SDK triggers this callback to report the result of the operation.
当获取媒体资源信息的异步操作完成后，SDK 会触发该回调报告异步操作的结果。
+When the asynchronous operation that retrieves the statistics of the media resources, the SDK triggers this callback to report the result of this operation.
diff --git a/en-US/dita/RTC-NG/API/class_rteplayerinfo.dita b/en-US/dita/RTC-NG/API/class_rteplayerinfo.dita
index ea4e5636bb5..1d8051bdd57 100644
--- a/en-US/dita/RTC-NG/API/class_rteplayerinfo.dita
+++ b/en-US/dita/RTC-NG/API/class_rteplayerinfo.dita
@@ -2,7 +2,7 @@
@@ -78,33 +78,33 @@
diff --git a/en-US/dita/RTC-NG/API/class_filtereffectoptions.dita b/en-US/dita/RTC-NG/API/class_filtereffectoptions.dita
index b3dc7aaf549..0e3feac0897 100644
--- a/en-US/dita/RTC-NG/API/class_filtereffectoptions.dita
+++ b/en-US/dita/RTC-NG/API/class_filtereffectoptions.dita
@@ -2,7 +2,7 @@
diff --git a/en-US/dita/RTC-NG/API/class_player.dita b/en-US/dita/RTC-NG/API/class_player.dita
index 5b9ab5355a2..11c50ba4522 100644
--- a/en-US/dita/RTC-NG/API/class_player.dita
+++ b/en-US/dita/RTC-NG/API/class_player.dita
@@ -2,5 +2,5 @@
Facial enhancement areas. See 美型部位： Facial enhancement areas. 调用 After you register the player event observer by calling Call this method Call this method after When the method call succeeds, there is no return value; when fails, the 取消注册是否成功： Whether you successfully unregister the observer:
+
-
+
When the method call succeeds, there is no return value; when fails, the
取消注册是否成功：
Whether you successfully unregister the observer:
@@ -57,11 +57,11 @@
美型部位，详见
美型部位：
Facial enhancement areas:
Facial enhancement areas.
3D 立方体贴图文件的本地绝对路径，该文件用于实现自定义滤镜效果。 引用的 .cube 文件必须严格遵循立方体查找表（Cube LUT）规范，否则滤镜效果无法生效。 以下为 .cube 文件的示例： The absolute path to the local cube map texture file, which customzies the filter effect. The referred .cude file should strictly follow the Cube LUT Format Specification; otherwise, the filter effect does not work. The following is a sample of the .cude file:
-
@@ -57,17 +57,17 @@
-
+
@@ -68,25 +68,25 @@
The user ID of the remote user.
The audio track ID. Set this parameter to the custom audio track ID returned in
@@ -60,19 +60,19 @@
Facial enhancement areas. See
Facial enhancement areas.
如果你需要监控播放器状态的变化，需要先调用
To monitor player events, you need to call
当播放器状态发生变化时，SDK 会触发此回调报告当前和变化之前的状态。
+When the player state changes, the SDK triggers this callback the report the previous and current states.
@@ -50,7 +50,7 @@
@@ -52,7 +52,7 @@
@@ -42,13 +42,13 @@
Facial enhancement areas:
Facial enhancement areas.
If the token of any target channel expires, the whole media relay stops; hence Agora recommends that you specify the same expiration time for the tokens of all the target channels.
If the token of any target channel expires, the whole media relay stops; hence Agora recommends that you specify the same expiration time for the tokens of all the target channels.
3: 秀场直播
+3. Live show scenario.
调用该方法后，如果你收到
After calling this method, if you receive the
If you want to customize CDN routes for playing the media resource, call the
After calling
After calling
该方法支持在本地将多路音频流合并为一路音频流。 例如：将本地麦克风采集的音频流、媒体播放器中的音频流、声卡采集的音频流、远端音频流等合并为一路音频流，然后将合流后的音频流发布到频道中。
This method supports merging multiple audio streams into one audio stream locally. 例如：将本地麦克风采集的音频流、媒体播放器中的音频流、声卡采集的音频流、远端音频流等合并为一路音频流，然后将合流后的音频流发布到频道中。
After calling
After calling
After calling this method, if you receive the
If the preload is successful and you want to play the media resource, call
You can call this method to enable the video noise reduction feature and set the options of the video noise reduction effect.
-This method supports merging multiple audio streams into one audio stream locally. 例如：将本地麦克风采集的音频流、媒体播放器中的音频流、声卡采集的音频流、远端音频流等合并为一路音频流，然后将合流后的音频流发布到频道中。
This method supports merging multiple audio streams into one audio stream locally. For example, merging the audio streams captured from the local microphone, and that from the media player, the sound card, and the remote users into one audio stream, and then publish the merged audio stream to the channel.
你可以在如下场景中开启该功能：
You can enable this function in the following scenarios:
为了保证音频质量，建议参与本地合流的音频流数量不超过 10 个。
+To ensure audio quality, it is recommended that the number of audio streams to be mixed does not exceed 10.
成功预加载后，可以加快通过
After successful preloading, the speed of accessing URL resources can be accelerated when calling
在打开媒体资源之前，提前加载可以减少用户等待时间，提供更流畅的视听体验。
+Before opening media resources, preloading can reduce the time for waiting and provide a smoother user experience.
该方法目前仅对带
This method currently only takes effect on URLs with the prefix
各字段的详细说明详见
See
When the method call succeeds, there is no return value; when fails, the
预加载是否成功：
Whether preloading is successful:
After calling , call this method if you want to update the local video mixing
After calling
你可以通过该方法获取播放器及媒体流的相关信息，例如音频采样率、视频帧的尺寸等信息。
+You can obtain information about the player state and media stream through this method, such as audio sampling rate, video frame size.
When the method call succeeds, there is no return value; when fails, the
获取信息是否成功：
Whether obtaining the information is successful:
该方法用于获取播放器的统计信息，包括解码、渲染帧率、音视频码率等，并通过回调函数异步返回结果。
+This method is used to obtain statistical information about the player, including decoding, rendering frame rate, audio and video bitrate, etc., and asynchronously returns the results through a callback function.
观众端可以调用该方法来设置是否订阅主播的音频流。
+Audience member can call this method to decide whether to subscribe to the host's audio stream.
When the method call succeeds, there is no return value; when fails, the
订阅或取消订阅操作是否成功：
Whether the subscription or unsubscription is successful:
观众端可以调用该方法来设置是否订阅主播的视频流。
+Audience member can call this method to decide whether to subscribe to the host's video stream.
When the method call succeeds, there is no return value; when fails, the
订阅或取消订阅操作是否成功：
Whether the subscription or unsubscription is successful:
该方法支持通过 URL 打开实时流媒体。 如果你想要加快打开 URL 资源的速度，可以在调用该方法前，调用
如果资源打开失败，你会收到
This method can open a live stream via URL. If you want to speed up the process of opening a URL, you can call the
If you fail to open the URL, you will receive the
该方法目前仅支持打开以
This method currently only supports playing URLs with the
当你调用
When you call
When the method call succeeds, there is no return value; when fails, the
暂停播放是否成功：
Whether the playback has been successfully paused:
如果你关闭了自动播放，当你调用
If you have disabled the autoplay, when you successfully open a live stream through a URL by calling
Call this method after you call and receive the
Call this method after you receive the
该方法目前仅支持播放带
This method currently only supports playing URLs with the
When the method call succeeds, there is no return value; when fails, the
播放是否成功：
Whether the playing is successful:
调用该方法前，你需要实现一个继承自
Before calling this method, you need to implement a class that inherits from
When the method call succeeds, there is no return value; when fails, the
注册是否成功：
Whether the registration is successful:
When the method call succeeds, there is no return value; when fails, the
观测器对象是否注册成功：
If you have disabled the autoplay, when you successfully open a live stream through a URL by calling
If you have disabled autoplay, when you successfully open a live stream through a URL by calling
After calling this method, if you receive the
After calling this method, if you receive the
If you want to customize CDN routes for playing the media resource, call the
This method must be called after the SDK triggers the
This method must be called after the SDK triggers the
If you are able to apply for
Underlit environments and low-end video capture devices can cause video images to contain significant noise, which affects video quality. In real-time interactive scenarios, video noise also consumes bitstream resources and reduces encoding efficiency during encoding.
+dark environments and low-end video capture devices can cause video images to contain significant noise, which affects video quality. In real-time interactive scenarios, video noise also consumes bitstream resources and reduces encoding efficiency during encoding.
You can enable this function in the following scenarios:
You can call this method to configuer the player, such as enableing autoplay and subscribing to video streams of different resolutions and bitrate.
+You can call this method to configuer the player, such as enabling autoplay and subscribing to video streams of a different resolution and bitrate.
After you successfully play the URL stream using
If you fail to open the URL stream using
After you successfully play the URL stream using
If you fail to open the URL stream using
Before you call
Before you call
This method is asynchronous, which means that the result of initialization is retured through a callback.
+This method is asynchronous, which means that the result of initialization is returned through a callback.
Call this method after the intializing the RTE object and sets the App ID.
+Call this method after the intializing the RTE object and setting the App ID.
Call this method
Call this method before
diff --git a/en-US/dita/RTC-NG/API/class_rteplayerinfo.dita b/en-US/dita/RTC-NG/API/class_rteplayerinfo.dita
index 1d8051bdd57..80fbd21c860 100644
--- a/en-US/dita/RTC-NG/API/class_rteplayerinfo.dita
+++ b/en-US/dita/RTC-NG/API/class_rteplayerinfo.dita
@@ -71,7 +71,7 @@
The metadata type. The SDK currently only supports The metadata type. The SDK currently only supports
+
-
+
The priority of the remote user.
The priority of the remote user.
+
+
The current connection state. The current connection state.
+
+
+
The contrast level, used with the
The contrast level, used with the
@@ -36,7 +36,7 @@
The absolute path to the local cube map texture file, which customzies the filter effect. The referred .cude file should strictly follow the Cube LUT Format Specification; otherwise, the filter effect does not work. The following is a sample of the .cude file: The absolute path to the local cube map texture file, which can be used to customize the filter effect. The specified .cude file should strictly follow the Cube LUT Format Specification; otherwise, the filter options do not take effect. The following is a sample of the .cude file:
+
+
The quality of the audio stream sent by the user. The quality of the audio stream sent by the user.
+
-
+
+
+
+
+
+
+
Audio spectrum information of the remote user.
Audio spectrum information of the remote user.