IAgoraMediaPlayer.h

//
//  Agora Rtc Engine SDK
//
//  Copyright (c) 2019 Agora.io. All rights reserved.
//
 
#ifndef AGORA_MEDIA_PLAYER_H_
#define AGORA_MEDIA_PLAYER_H_
 
#include "AgoraMediaBase.h"
#include "AgoraMediaPlayerTypes.h"
 
namespace agora {
namespace rtc {
 
struct MediaPlayerContext {
  bool enable_chat_voice_mode = false;
  void *context = nullptr;
};
class IMediaPlayerObserver;
 
class IMediaPlayer {
 protected:
  virtual ~IMediaPlayer() = default;
 
 public:
  virtual int initialize(const MediaPlayerContext& context) = 0;
 
  virtual int open(const char* src, int64_t startPos) = 0;
 
  virtual int play() = 0;
 
  virtual int pause() = 0;
 
  virtual int stop() = 0;
 
  virtual int seek(int64_t pos) = 0;
 
  virtual int mute(bool mute) = 0;
 
  virtual int getMute(bool& mute) = 0;
 
  virtual int adjustPlayoutVolume(int volume) = 0;
 
  virtual int getPlayoutVolume(int& volume) = 0;
 
  virtual int getDuration(int64_t& duration) = 0;
 
  virtual int getPlayPosition(int64_t& pos) = 0;
 
  virtual int getStreamCount(int64_t& count) = 0;
 
  virtual int getStreamInfo(int64_t index, media::base::MediaStreamInfo* info) = 0;
 
  virtual media::base::MEDIA_PLAYER_STATE getState() = 0;
 
  virtual int setView(media::base::view_t view) = 0;
 
  virtual int setRenderMode(media::base::RENDER_MODE_TYPE renderMode) = 0;
 
  virtual int registerPlayerObserver(IMediaPlayerObserver* observer) = 0;
 
  virtual int unregisterPlayerObserver(IMediaPlayerObserver* observer) = 0;
 
  virtual int registerVideoFrameObserver(media::base::IVideoFrameObserver* observer) = 0;
  virtual int unregisterVideoFrameObserver(agora::media::base::IVideoFrameObserver* observer) = 0;
 
  virtual int registerAudioFrameObserver(media::base::IAudioFrameObserver* observer) = 0;
 
  virtual int unregisterAudioFrameObserver(agora::media::base::IAudioFrameObserver* observer) = 0;
 
 
  virtual int connect(const char* token, const char* channelId, media::base::user_id_t userId) = 0;
 
  virtual int disconnect() = 0;
 
  virtual int publishVideo() = 0;
 
  virtual int unpublishVideo() = 0;
 
  virtual int publishAudio() = 0;
 
  virtual int unpublishAudio() = 0;
 
  virtual int adjustPublishSignalVolume(int volume) = 0;
 
  virtual int setLogFile(const char* filePath) = 0;
 
  virtual int setLogFilter(unsigned int filter) = 0;
 
  virtual int changePlaybackSpeed(media::base::MEDIA_PLAYER_PLAYBACK_SPEED speed) = 0;
 
  virtual int selectAudioTrack(int index) = 0;
 
  virtual int setPlayerOption(const char *key ,int value) = 0;
 
  virtual int setPlayerOption(const char *key ,const char *value) = 0;
 
 
  virtual int takeScreenshot(const char* filename) = 0;
 
  virtual int selectInternalSubtitle(int index) = 0;
 
  virtual int setExternalSubtitle(const char* url) = 0;
 
  virtual int setPlayerOption(const char *key ,const char *value) = 0;
 
  virtual int setLoopCount(int loopCount) = 0;
 
  virtual const char* getPlayerSdkVersion() = 0;
  
  virtual int switchSrc(const char* src, bool syncPts = true) = 0;
  
  virtual int addPreloadSrc(const char* src, int64_t startPos) = 0;
 
  virtual int playPreload(const char* src) = 0;
 
  virtual void release(bool sync = true) = 0;
};
class IMediaPlayerObserver {
 public:
  virtual void onPlayerStateChanged(media::base::MEDIA_PLAYER_STATE state,
                                    media::base::MEDIA_PLAYER_ERROR ec) = 0;
  
  virtual void onPositionChanged(const int64_t position_ms) = 0;
 
  virtual void onPlayerEvent(media::base::MEDIA_PLAYER_EVENT event) = 0;
 
  virtual void onMetadata(media::base::MEDIA_PLAYER_METADATA_TYPE type, const uint8_t* data,
                                  uint32_t length) = 0;
  
  virtual void onPreloadEvent(const char* src, media::base::PLAYER_PRELOAD_EVENT event) = 0;
 
  virtual void onPlayBufferUpdated(int64_t playCachedBuffer) = 0;
 
 
  virtual void onCompleted() = 0;
 
  virtual ~IMediaPlayerObserver() {}
};
 
}  // namespace rtc
}  // namespace agora
 
#if defined(_WIN32)
 
#ifndef WIN32_LEAN_AND_MEAN
#define WIN32_LEAN_AND_MEAN
#endif // WIN32_LEAN_AND_MEAN
 
#include <windows.h>
#define AGORA_PLAYER_API extern "C"
#define AGORA_PLAYER_CALL
 
#elif defined(__APPLE__)
 
#include <TargetConditionals.h>
#define AGORA_PLAYER_API __attribute__((visibility("default"))) extern "C"
#define AGORA_PLAYER_CALL
 
#elif defined(__ANDROID__) || defined(__linux__)
 
#define AGORA_PLAYER_API extern "C" __attribute__((visibility("default")))
#define AGORA_PLAYER_CALL
 
#else
 
#define AGORA_PLAYER_API extern "C"
#define AGORA_PLAYER_CALL
 
#endif
 
 
 
AGORA_PLAYER_API agora::rtc::IMediaPlayer* AGORA_PLAYER_CALL createAgoraMediaPlayer();
 
#endif  // AGORA_MEDIA_PLAYER_H_