diff --git a/dita/RTC-NG/API/callback_playerobserver_onresolutionchanged.dita b/dita/RTC-NG/API/callback_playerobserver_onresolutionchanged.dita
index a98881a9b16..b181129b3b8 100644
--- a/dita/RTC-NG/API/callback_playerobserver_onresolutionchanged.dita
+++ b/dita/RTC-NG/API/callback_playerobserver_onresolutionchanged.dita
@@ -2,7 +2,7 @@
-
+ 视频分辨率发生改变回调。
@@ -13,10 +13,10 @@
-
+ public void onResolutionChanged(int width, int height){}
-
-
+ - (void)onResolutionChanged:(int)width height:(int)height;
+ virtual void onResolutionChanged(int width, int height) = 0;
@@ -28,37 +28,30 @@
- 自从
- - v
+ - v4.5.0
-
-
-
- 适用场景
-
+ 如果你需要监控播放器所播放视频流分辨率的变化,需要在调用 方法时注册该回调。
触发时机
-
+ 当视频流的分辨率发生变化时,SDK 会触发该回调报告当前视频的宽高。
参数
-
-
+ width
+ 视频帧的宽度(px)。
+
+
+ height
+ 视频帧的高度(px)。
-
-
- 方法成功调用时,无返回值;方法调用失败时,会抛出 异常,你需要捕获异常并进行处理。
-
- - 0: 方法调用成功。
- - < 0: 方法调用失败。详见了解详情和解决建议。
-
diff --git a/dita/RTC-NG/API/enum_rteplayerstate.dita b/dita/RTC-NG/API/enum_rteplayerstate.dita
index c3eb0f1de8e..c0f8c263517 100644
--- a/dita/RTC-NG/API/enum_rteplayerstate.dita
+++ b/dita/RTC-NG/API/enum_rteplayerstate.dita
@@ -16,8 +16,36 @@
枚举值
-
-
+
+ 0:空闲状态。//TODO 播放器会在你打开 URL 之前和结束播放之后会报告该状态码。
+
+
+
+ 1:正在打开 URL 资源。当调用 后会报告该状态码。
+
+
+
+ 2:成功打开 URL 资源。当调用 成功打开 URL 资源后会报告该状态码。
+
+
+
+ 3:播放中。//TODO 当打开 rte url 时,订阅主播成功回调此状态。观众端调用 open 打开 url 并播放后会回调这个状态吗?
+
+
+
+ 4:暂停播放。当成功调用 后会报告该状态码。
+
+
+
+ 5:播放完成。//TODO 当主播结束推流退出房间后,会报告该状态码。这个状态码是观众端和主播端都会报告吗?
+
+
+
+ 6:停止播放。当成功调用 后会报告该状态码。
+
+
+
+ 7:失败状态。当内部发生错误时会报告该状态码。
diff --git a/dita/RTC-NG/API/rtc_api_data_type.dita b/dita/RTC-NG/API/rtc_api_data_type.dita
index a16725e2f2c..6435c5ccea5 100644
--- a/dita/RTC-NG/API/rtc_api_data_type.dita
+++ b/dita/RTC-NG/API/rtc_api_data_type.dita
@@ -1245,6 +1245,7 @@
+
diff --git a/dita/RTC-NG/RTC_NG_API_CPP.ditamap b/dita/RTC-NG/RTC_NG_API_CPP.ditamap
index a7dcabaa095..b5603c9b9d5 100644
--- a/dita/RTC-NG/RTC_NG_API_CPP.ditamap
+++ b/dita/RTC-NG/RTC_NG_API_CPP.ditamap
@@ -485,6 +485,7 @@
+
diff --git a/dita/RTC-NG/config/callback_playerobserver_onevent.dita b/dita/RTC-NG/config/callback_playerobserver_onevent.dita
new file mode 100644
index 00000000000..30d716bf1db
--- /dev/null
+++ b/dita/RTC-NG/config/callback_playerobserver_onevent.dita
@@ -0,0 +1,64 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ public void onEvent(int event){}
+
+ - (void)onEvent:(AgoraRtePlayerEvent)event;
+ virtual void onEvent(PlayerEvent event) = 0;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 方法成功调用时,无返回值;方法调用失败时,会抛出 异常,你需要捕获异常并进行处理。
+
+ - 0: 方法调用成功。
+ - < 0: 方法调用失败。详见了解详情和解决建议。
+
+
+
diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
index 2e8bce5bf74..274621f114c 100644
--- a/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
+++ b/dita/RTC-NG/config/keys-rtc-ng-api-cpp.ditamap
@@ -1199,6 +1199,13 @@
+
+
+
+ onResolutionChanged
+
+
+
@@ -11600,6 +11607,69 @@
RTMP_STREAM_PUBLISH_STATE_DISCONNECTING
+
+
+
+
+ RtePlayerState
+
+
+
+
+
+
+ kRtePlayerStateIdle
+
+
+
+
+
+
+ kRtePlayerStateOpening
+
+
+
+
+
+
+ kRtePlayerStateOpenCompleted
+
+
+
+
+
+
+ kRtePlayerStatePlaying
+
+
+
+
+
+
+ kRtePlayerStatePaused
+
+
+
+
+
+
+ kRtePlayerStatePlaybackCompleted
+
+
+
+
+
+
+ kRtePlayerStateStopped
+
+
+
+
+
+
+ kRtePlayerStateFailed
+
+
diff --git a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap
index 0aae2d7c5eb..33c2ff9bf75 100644
--- a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap
+++ b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap
@@ -3350,6 +3350,7 @@
+