update 4.5.20250923 header files (#252)

Co-authored-by: WinterPu <[email protected]>

Author: WinterPu

headers/rtc_4.5.20250923/custom_headers/CustomIAgoraMediaEngine.h

@@ -0,0 +1,49 @@
+#pragma once
+
+#include "AgoraBase.h"
+#include "IAgoraMediaEngine.h"
+
+namespace agora {
+namespace media {
+namespace ext {
+
+class IMediaEngine {
+  // ----------------------------- 👇🏻new API👇🏻 -----------------------------
+
+  /**
+   * @iris_api_id: MediaEngine_unregisterAudioFrameObserver
+   * @source: virtual int registerAudioFrameObserver(IAudioFrameObserver* observer) = 0;
+   */
+  virtual int unregisterAudioFrameObserver(IAudioFrameObserver *observer) = 0;
+
+  /**
+   * @iris_api_id: MediaEngine_unregisterVideoFrameObserver
+   * @source: virtual int registerVideoFrameObserver(IVideoFrameObserver* observer) = 0;
+   */
+  virtual int unregisterVideoFrameObserver(IVideoFrameObserver *observer) = 0;
+
+  /**
+   * @iris_api_id: MediaEngine_unregisterVideoEncodedFrameObserver
+   * @source: virtual int registerVideoEncodedFrameObserver(IVideoEncodedFrameObserver* observer) = 0;
+   */
+  virtual int
+  unregisterVideoEncodedFrameObserver(IVideoEncodedFrameObserver *observer) = 0;
+
+  /**
+   * @iris_api_id: MediaEngine_unregisterFaceInfoObserver
+   * @source: virtual int registerFaceInfoObserver(IFaceInfoObserver* observer) = 0;
+   */
+  virtual int unregisterFaceInfoObserver(IFaceInfoObserver* observer) = 0;
+
+  /**
+   * @iris_api_id: MediaEngine_setExternalRemoteEglContext_f337cbf
+   * @source: virtual int setExternalRemoteEglContext(void* eglContext) = 0;
+   */
+  virtual int setExternalRemoteEglContext(const void* eglContext) = 0;
+
+  // ----------------------------- 👆🏻new API👆🏻 -----------------------------
+};
+
+} // namespace ext
+} // namespace media
+} // namespace agora

headers/rtc_4.5.20250923/custom_headers/CustomIAgoraMediaPlayer.h

@@ -0,0 +1,63 @@
+#pragma once
+
+#include "AgoraBase.h"
+#include "AgoraMediaBase.h"
+#include "IAgoraMediaPlayer.h"
+
+namespace agora {
+namespace rtc {
+
+// Put this class to the agora::rtc namespaces to avoid unecessary namespace trimming(trim the `ext` namespace).
+class IMediaPlayerVideoFrameObserver {
+  virtual void onFrame(const agora::media::base::VideoFrame *frame) = 0;
+};
+
+namespace ext {
+
+class IMediaPlayer {
+  // ----------------------------- 👇🏻overload API👇🏻 -----------------------------
+
+  /**
+   * @iris_api_id: MediaPlayer_setPlayerOption_4d05d29
+   * @source: virtual int setPlayerOption(const char* key, int value) = 0;
+   */
+  virtual int setPlayerOptionInInt(const char *key, int value) = 0;
+
+  /**
+   * @iris_api_id: MediaPlayer_setPlayerOption_ccad422
+   * @source: virtual int setPlayerOption(const char* key, char* value) = 0;
+   */
+  virtual int setPlayerOptionInString(const char *key, const char *value) = 0;
+
+  /**
+   * @iris_api_id: MediaPlayer_registerAudioFrameObserver_a5b510b
+   * @source: virtual int registerAudioFrameObserver(media::IAudioPcmFrameSink* observer, RAW_AUDIO_FRAME_OP_MODE_TYPE mode) = 0;
+   */
+  virtual int
+  registerAudioFrameObserver(media::IAudioPcmFrameSink* observer,
+                             RAW_AUDIO_FRAME_OP_MODE_TYPE mode = RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_ONLY) = 0;
+
+  // ----------------------------- 👆🏻overload API👆🏻 -----------------------------
+
+  // ----------------------------- 👇🏻rename API👇🏻 -----------------------------
+
+  /**
+   * @iris_api_id: MediaPlayer_registerVideoFrameObserver_833bd8d
+   * @source: virtual int registerVideoFrameObserver(media::base::IVideoFrameObserver* observer) = 0;
+   */
+  virtual int
+  registerVideoFrameObserver(IMediaPlayerVideoFrameObserver *observer) = 0;
+
+  /**
+   * @iris_api_id: MediaPlayer_unregisterVideoFrameObserver_5165d4c
+   * @source: virtual int unregisterVideoFrameObserver(agora::media::base::IVideoFrameObserver* observer) = 0;
+   */
+  virtual int
+  unregisterVideoFrameObserver(IMediaPlayerVideoFrameObserver *observer) = 0;
+
+  // ----------------------------- 👆🏻rename API👆🏻 -----------------------------
+};
+
+} // namespace ext
+} // namespace rtc
+} // namespace agora

headers/rtc_4.5.20250923/custom_headers/CustomIAgoraMusicContentCenter.h

@@ -0,0 +1,32 @@
+#pragma once
+
+#include "IAgoraMediaPlayer.h"
+
+namespace agora {
+namespace rtc {
+namespace ext {
+
+class IMusicPlayer : public IMediaPlayer {
+  // ----------------------------- 👇🏻overload API👇🏻 -----------------------------
+
+  /**
+   * @iris_api_id: MusicPlayer_open_303b92e
+   * @source: virtual int open(int64_t songCode, int64_t startPos = 0) = 0;
+   * @generate_iris_api_id: true
+   */
+  virtual int openWithSongCode(int64_t songCode, int64_t startPos = 0) = 0;
+
+  // ----------------------------- 👆🏻overload API👆🏻 -----------------------------
+};
+
+class IMusicContentCenter
+{
+  /**
+   * @iris_api_id: MusicContentCenter_preload_d3baeab
+   * @source: virtual int preload(agora::util::AString& requestId, int64_t songCode) = 0;
+   */
+  virtual int preload(agora::util::AString& requestId, int64_t songCode) = 0;
+};
+} // namespace ext
+} // namespace rtc
+} // namespace agora