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 @@ <ph keyref="onResolutionChanged"/> - + 视频分辨率发生改变回调。 @@ -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)。
-
- <ph keyref="return-section-title"/> -

方法成功调用时,无返回值;方法调用失败时,会抛出 异常,你需要捕获异常并进行处理。

-
    -
  • 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 @@ + + + + <ph keyref="onEvent"/> + + + + + + + + + +
    +

    + public void onEvent(int event){} + + - (void)onEvent:(AgoraRtePlayerEvent)event; + virtual void onEvent(PlayerEvent event) = 0; + + + + + +

    +
    +
    +
    + +
    自从
    +
    v
    +
    +
    +

    +

    +
    + 适用场景 +

    +

    +
    + 触发时机 +

    +

    +
    + 使用限制 +

    +

    +
    + 参数 + + + + + +
    +
    + <ph keyref="return-section-title"/> +

    方法成功调用时,无返回值;方法调用失败时,会抛出 异常,你需要捕获异常并进行处理。

    +
      +
    • 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 @@ +