From 4a082065facc2982172c9116889b48c18c085b63 Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Mon, 14 Oct 2024 18:23:19 +0800 Subject: [PATCH 1/2] api change --- dita/RTC-NG/API/class_channelmediaoptions.dita | 2 ++ dita/RTC-NG/API/class_musiccontentcenterconfiguration.dita | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/dita/RTC-NG/API/class_channelmediaoptions.dita b/dita/RTC-NG/API/class_channelmediaoptions.dita index 3542e5816ce..0dbd0941081 100644 --- a/dita/RTC-NG/API/class_channelmediaoptions.dita +++ b/dita/RTC-NG/API/class_channelmediaoptions.dita @@ -84,6 +84,8 @@ public audioDelayMs?:number; public mediaPlayerAudioDelayMs?:number; + + public token?:string; public enableBuiltInMediaEncryption?:boolean; diff --git a/dita/RTC-NG/API/class_musiccontentcenterconfiguration.dita b/dita/RTC-NG/API/class_musiccontentcenterconfiguration.dita index 66925b21623..3fbc4c0aeed 100644 --- a/dita/RTC-NG/API/class_musiccontentcenterconfiguration.dita +++ b/dita/RTC-NG/API/class_musiccontentcenterconfiguration.dita @@ -35,7 +35,7 @@ public eventHandler?:IMusicContentCenterEventHandler - public mccDomain:string = "" + public mccDomain?:string } __attribute__((visibility("default"))) @interface AgoraMusicContentCenterConfig : NSObject @property(assign, nonatomic) AgoraRtcEngineKit* _Nullable rtcEngine; From 65d8f321a505af94f0f8a5fcb10a2f62a0edea2a Mon Sep 17 00:00:00 2001 From: Cilla-luodan <85477033+Cilla-luodan@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:27:51 +0800 Subject: [PATCH 2/2] fix --- .../api_imusiccontentcenter_getcaches.dita | 2 +- ...usiccontentcenter_getinternalsongcode.dita | 3 +- ...imusiccontentcenter_getsongsimpleinfo.dita | 3 +- .../api_imusiccontentcenter_initialize.dita | 2 +- .../api_imusiccontentcenter_ispreloaded.dita | 2 +- .../API/api_imusicontentcenter_preload.dita | 3 +- .../API/api_imusicplayer_setplaymode.dita | 1 + .../API/api_irtcengine_playeffect3.dita | 3 +- ...yersourceobserver_onplaybufferupdated.dita | 4 +- ...entereventhandler_onmusicchartsresult.dita | 2 +- ...reventhandler_onmusiccollectionresult.dita | 2 +- dita/RTC-NG/API/rtc_api_data_type.dita | 9 +- dita/RTC-NG/API/rtc_api_overview.dita | 26 ++-- dita/RTC-NG/RTC_NG_API_Harmony.ditamap | 9 +- .../config/keys-rtc-ng-api-harmony.ditamap | 138 ++++++++++-------- .../config/relations-rtc-ng-api.ditamap | 32 ++-- 16 files changed, 134 insertions(+), 107 deletions(-) diff --git a/dita/RTC-NG/API/api_imusiccontentcenter_getcaches.dita b/dita/RTC-NG/API/api_imusiccontentcenter_getcaches.dita index 0d217b65f0a..25ab118b86e 100644 --- a/dita/RTC-NG/API/api_imusiccontentcenter_getcaches.dita +++ b/dita/RTC-NG/API/api_imusiccontentcenter_getcaches.dita @@ -30,7 +30,7 @@
v4.2.0
-

调用该方法前,你需要预先分配一定大小的内存空间用来存储缓存音乐资源的信息。如果你需要设置可缓存的音乐资源数量,可通过 configurationconfig 来设置。

+

调用该方法前,你需要预先分配一定大小的内存空间用来存储缓存音乐资源的信息。如果你需要设置可缓存的音乐资源数量,可通过 configurationconfig 来设置。

当你不再需要使用已缓存的音乐资源时,你需要及时释放内存以防止内存泄漏。

diff --git a/dita/RTC-NG/API/api_imusiccontentcenter_getinternalsongcode.dita b/dita/RTC-NG/API/api_imusiccontentcenter_getinternalsongcode.dita index a8501eb994a..22f61004c6f 100644 --- a/dita/RTC-NG/API/api_imusiccontentcenter_getinternalsongcode.dita +++ b/dita/RTC-NG/API/api_imusiccontentcenter_getinternalsongcode.dita @@ -40,7 +40,8 @@ songCode - 音乐资源编号,用于标识音乐资源。你可以通过调用 方法来获取音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。 + 音乐资源编号,用于标识音乐资源。你可以通过调用 方法来获取音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。 + 音乐资源编号,用于标识音乐资源。你可以通过调用 方法来获取音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。 jsonOption diff --git a/dita/RTC-NG/API/api_imusiccontentcenter_getsongsimpleinfo.dita b/dita/RTC-NG/API/api_imusiccontentcenter_getsongsimpleinfo.dita index 9582a53c431..4d39164e268 100644 --- a/dita/RTC-NG/API/api_imusiccontentcenter_getsongsimpleinfo.dita +++ b/dita/RTC-NG/API/api_imusiccontentcenter_getsongsimpleinfo.dita @@ -30,7 +30,8 @@
v4.2.2
-

在调用该方法前,你需要先获取到对应的音乐资源的编号。你可以通过调用 方法来获取音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。

+

在调用该方法前,你需要先获取到对应的音乐资源的编号。你可以通过调用 方法来获取音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。

+

在调用该方法前,你需要先获取到对应的音乐资源的编号。你可以通过调用 方法来获取音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。

当你调用该方法后,SDK 会触发 回调报告音乐资源的详细信息。

diff --git a/dita/RTC-NG/API/api_imusiccontentcenter_initialize.dita b/dita/RTC-NG/API/api_imusiccontentcenter_initialize.dita index 883926ea6c1..4d82437ea9b 100644 --- a/dita/RTC-NG/API/api_imusiccontentcenter_initialize.dita +++ b/dita/RTC-NG/API/api_imusiccontentcenter_initialize.dita @@ -37,7 +37,7 @@ 参数 - configuration + configuration config 的设置,详见 diff --git a/dita/RTC-NG/API/api_imusiccontentcenter_ispreloaded.dita b/dita/RTC-NG/API/api_imusiccontentcenter_ispreloaded.dita index e0392a9d840..53651d833f5 100644 --- a/dita/RTC-NG/API/api_imusiccontentcenter_ispreloaded.dita +++ b/dita/RTC-NG/API/api_imusiccontentcenter_ispreloaded.dita @@ -31,7 +31,7 @@
v4.1.0
-

该方法为同步调用。如需预加载新的音乐资源,可调用

+

该方法为同步调用。如需预加载新的音乐资源,可调用

参数 diff --git a/dita/RTC-NG/API/api_imusicontentcenter_preload.dita b/dita/RTC-NG/API/api_imusicontentcenter_preload.dita index 22c384814f6..4dcce6f8e7e 100644 --- a/dita/RTC-NG/API/api_imusicontentcenter_preload.dita +++ b/dita/RTC-NG/API/api_imusicontentcenter_preload.dita @@ -32,7 +32,8 @@

你可以调用该方法预先加载需要播放的音乐资源。成功调用该方法后,SDK 会触发 回调报告预加载音乐资源的事件。

-

在调用该方法来预加载音乐资源之前,你需要调用 方法来获取你需要播放的音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。

+

在调用该方法来预加载音乐资源之前,你需要调用 方法来获取你需要播放的音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。 + 在调用该方法前,你需要先获取到对应的音乐资源的编号。你可以通过调用 方法来获取音乐资源,并通过由此触发的 回调获取音乐资源的编号(songCode)。

如需销毁 对象,请在收到 回调后,再调用 方法。
diff --git a/dita/RTC-NG/API/api_imusicplayer_setplaymode.dita b/dita/RTC-NG/API/api_imusicplayer_setplaymode.dita index 21c3e21caa5..455c38b8768 100644 --- a/dita/RTC-NG/API/api_imusicplayer_setplaymode.dita +++ b/dita/RTC-NG/API/api_imusicplayer_setplaymode.dita @@ -14,6 +14,7 @@

int setPlayMode(MusicPlayMode mode); + abstract setPlayMode(mode:Constants.MusicPlayMode):number - (NSInteger)setPlayMode:(AgoraMusicPlayMode)mode NS_SWIFT_NAME(setPlayMode(mode:)); virtual int setPlayMode(MusicPlayMode mode) = 0; diff --git a/dita/RTC-NG/API/api_irtcengine_playeffect3.dita b/dita/RTC-NG/API/api_irtcengine_playeffect3.dita index 37066919aef..74dbcd8e916 100644 --- a/dita/RTC-NG/API/api_irtcengine_playeffect3.dita +++ b/dita/RTC-NG/API/api_irtcengine_playeffect3.dita @@ -77,8 +77,9 @@

该方法在加入频道前后均可调用。

- <ph props="android cpp apple framework">调用限制</ph> + 调用限制

如果你需要播放在线音效文件,声网建议先将在线音效文件缓存到本地设备,调用 将缓存的音效文件预加载到内存中,然后再调用此方法播放音效。否则,可能出现因在线音效文件加载超时、加载失败而导致的播放失败和无声的问题。

+

无。

diff --git a/dita/RTC-NG/API/callback_imusiccontentcentereventhandler_onmusicchartsresult.dita b/dita/RTC-NG/API/callback_imusiccontentcentereventhandler_onmusicchartsresult.dita index 7966eacded2..3ae18402b0e 100644 --- a/dita/RTC-NG/API/callback_imusiccontentcentereventhandler_onmusicchartsresult.dita +++ b/dita/RTC-NG/API/callback_imusiccontentcentereventhandler_onmusicchartsresult.dita @@ -73,7 +73,7 @@ list result - 当前可播放的音乐榜单列表。详见 + 当前可播放的音乐榜单列表。详见
diff --git a/dita/RTC-NG/API/callback_imusiccontentcentereventhandler_onmusiccollectionresult.dita b/dita/RTC-NG/API/callback_imusiccontentcentereventhandler_onmusiccollectionresult.dita index 10724e1a0c7..481f7f9148c 100644 --- a/dita/RTC-NG/API/callback_imusiccontentcentereventhandler_onmusiccollectionresult.dita +++ b/dita/RTC-NG/API/callback_imusiccontentcentereventhandler_onmusiccollectionresult.dita @@ -41,7 +41,7 @@

当你调用 方法来获取指定榜单的音乐资源列表或调用 来搜索音乐资源时,SDK 会触发此回调报告榜单中音乐资源列表的详细信息。

-

当你调用 方法来获取指定榜单的音乐资源列表或调用 来搜索音乐资源时,SDK 会触发此回调报告榜单中音乐资源列表的详细信息。

+

当你调用 方法来获取指定榜单的音乐资源列表或调用 来搜索音乐资源时,SDK 会触发此回调报告榜单中音乐资源列表的详细信息。

参数 diff --git a/dita/RTC-NG/API/rtc_api_data_type.dita b/dita/RTC-NG/API/rtc_api_data_type.dita index 412b302f670..44a21308a77 100644 --- a/dita/RTC-NG/API/rtc_api_data_type.dita +++ b/dita/RTC-NG/API/rtc_api_data_type.dita @@ -283,10 +283,10 @@
  • -
  • -
  • -
  • -
  • +
  • +
  • +
  • +
  • @@ -1356,6 +1356,7 @@
  • +
  • diff --git a/dita/RTC-NG/API/rtc_api_overview.dita b/dita/RTC-NG/API/rtc_api_overview.dita index d17ddd554c6..3f4ccea2af6 100644 --- a/dita/RTC-NG/API/rtc_api_overview.dita +++ b/dita/RTC-NG/API/rtc_api_overview.dita @@ -1550,7 +1550,7 @@
    -
    +
    媒体播放器

    更多有关媒体播放器的方法,详见内置媒体播放器

    更多有关媒体播放器的方法,详见

    @@ -1559,9 +1559,9 @@ 方法/回调 描述 - + - + @@ -1575,11 +1575,11 @@ - + - + @@ -1658,7 +1658,7 @@
    -
    +
    <ph props="cn">版权音乐</ph>

    本组方法仅适用于 Android 和 iOS。

    @@ -1682,7 +1682,7 @@ - + @@ -1734,7 +1734,7 @@ - + @@ -1742,10 +1742,14 @@ - + + + + + @@ -1770,7 +1774,7 @@ - + @@ -1778,7 +1782,7 @@ - + diff --git a/dita/RTC-NG/RTC_NG_API_Harmony.ditamap b/dita/RTC-NG/RTC_NG_API_Harmony.ditamap index 5a51baf417e..fee50b54fe3 100644 --- a/dita/RTC-NG/RTC_NG_API_Harmony.ditamap +++ b/dita/RTC-NG/RTC_NG_API_Harmony.ditamap @@ -39,9 +39,9 @@ - + - + @@ -525,6 +525,7 @@ + @@ -544,6 +545,8 @@ + + @@ -643,7 +646,7 @@ - + diff --git a/dita/RTC-NG/config/keys-rtc-ng-api-harmony.ditamap b/dita/RTC-NG/config/keys-rtc-ng-api-harmony.ditamap index b35d2f69ced..42890708875 100644 --- a/dita/RTC-NG/config/keys-rtc-ng-api-harmony.ditamap +++ b/dita/RTC-NG/config/keys-rtc-ng-api-harmony.ditamap @@ -111,7 +111,7 @@ - + IMediaPlayerCacheManager @@ -443,7 +443,7 @@ - getPlaySrc + getPlaySrc [2/2] @@ -834,13 +834,6 @@ - - - - enableAudioQualityIndication - - - @@ -1032,20 +1025,6 @@ - - - - CreateRendererView - - - - - - - CreateTextureView - - - @@ -2484,24 +2463,10 @@ - - - - startEchoTest [1/3] - - - - - - - startEchoTest [2/3] - - - - startEchoTest [3/3] + startEchoTest @@ -2819,31 +2784,31 @@ - + - onEvent + onEventWithContext - + - onStarted + onStartedWithContext - + - onStopped + onStoppedWithContext - + - onError + onErrorWithContext @@ -3233,6 +3198,13 @@ + + + + stop [2/2] + + + @@ -3303,6 +3275,13 @@ + + + + destroyMusicPlayer + + + @@ -3373,6 +3352,13 @@ + + + + setPlayMode + + + @@ -8983,105 +8969,105 @@ - PLAYER_EVENT_UNKNOWN + UNKNOWN - PLAYER_EVENT_SEEK_BEGIN + SEEK_BEGIN - PLAYER_EVENT_SEEK_COMPLETE + SEEK_COMPLETE - PLAYER_EVENT_SEEK_ERROR + SEEK_ERROR - PLAYER_EVENT_AUDIO_TRACK_CHANGED + AUDIO_TRACK_CHANGED - PLAYER_EVENT_BUFFER_LOW + BUFFER_LOW - PLAYER_EVENT_BUFFER_RECOVER + BUFFER_RECOVER - PLAYER_EVENT_FREEZE_START + FREEZE_START - PLAYER_EVENT_FREEZE_STOP + FREEZE_STOP - PLAYER_EVENT_SWITCH_BEGIN + SWITCH_BEGIN - PLAYER_EVENT_SWITCH_COMPLETE + SWITCH_COMPLETE - PLAYER_EVENT_SWITCH_ERROR + SWITCH_ERROR - PLAYER_EVENT_FIRST_DISPLAYED + FIRST_DISPLAYED - PLAYER_EVENT_REACH_CACHE_FILE_MAX_COUNT + REACH_CACHE_FILE_MAX_COUNT - PLAYER_EVENT_REACH_CACHE_FILE_MAX_SIZE + REACH_CACHE_FILE_MAX_SIZE @@ -9428,7 +9414,35 @@ - + + + + MusicPlayMode + + + + + + + ORIGINAL + + + + + + + ACCOMPANY + + + + + + + LEAD_SING + + + + PreloadState diff --git a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap index ed9d9bede9c..f0054c86a68 100644 --- a/dita/RTC-NG/config/relations-rtc-ng-api.ditamap +++ b/dita/RTC-NG/config/relations-rtc-ng-api.ditamap @@ -3201,41 +3201,41 @@ - + - + - + - + - - - - - - - + + + + + + + - + - + - - - + + +