IAgoraMediaPlayerSource.h

Go to the documentation of this file.

//
//  Agora SDK
//
//  Copyright (c) 2018 Agora.io. All rights reserved.
//
#pragma once  // NOLINT(build/header_guard)
 
#include "AgoraBase.h"
#include "AgoraMediaBase.h"
#include "AgoraMediaPlayerTypes.h"
#include "AgoraRefPtr.h"
 
namespace agora {
namespace rtc {
 
class IMediaPlayerSourceObserver;
 
class IMediaPlayerSource : public RefCountInterface {
protected:
  virtual ~IMediaPlayerSource() {}
 
public:
 
  virtual int getSourceId() const = 0;
 
  virtual int open(const char* url, int64_t startPos) = 0;
 
  virtual int openWithMediaSource(const media::base::MediaSource &source) = 0;
    
  virtual int play() = 0;
 
  virtual int pause() = 0;
 
  virtual int stop() = 0;
 
  virtual int resume() = 0;
 
  virtual int seek(int64_t newPos) = 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::PlayerStreamInfo* info) = 0;
 
  virtual int setLoopCount(int64_t loopCount) = 0;
 
  virtual int setPlaybackSpeed(int speed) = 0;
 
  virtual int selectAudioTrack(int64_t index) = 0;
 
  virtual int selectMultiAudioTrack(int playoutTrackIndex, int publishTrackIndex) = 0;
 
  virtual int setPlayerOption(const char* key, int64_t value) = 0;
 
  virtual int setPlayerOption(const char* key, const char* value) = 0;
 
  virtual int takeScreenshot(const char* filename) = 0;
 
  virtual int selectInternalSubtitle(int64_t index) = 0;
 
  virtual int setExternalSubtitle(const char* url) = 0;
 
  virtual media::base::MEDIA_PLAYER_STATE getState() = 0;
 
  virtual int registerPlayerSourceObserver(IMediaPlayerSourceObserver* observer) = 0;
 
  virtual int unregisterPlayerSourceObserver(IMediaPlayerSourceObserver* observer) = 0;
 
  virtual int registerAudioFrameObserver(media::IAudioPcmFrameSink* observer) = 0;
 
  virtual int unregisterAudioFrameObserver(media::IAudioPcmFrameSink* observer) = 0;
 
  virtual int openWithAgoraCDNSrc(const char* src, int64_t startPos) = 0;
 
  virtual int getAgoraCDNLineCount() = 0;
  
 
  virtual int switchAgoraCDNLineByIndex(int index) = 0;
 
  virtual int getCurrentAgoraCDNIndex() = 0;
 
  virtual int enableAutoSwitchAgoraCDN(bool enable) = 0;
 
  virtual int renewAgoraCDNSrcToken(const char* token, int64_t ts) = 0;
 
  virtual int switchAgoraCDNSrc(const char* src, bool syncPts = false) = 0;
 
  virtual int switchSrc(const char* src, bool syncPts) = 0;
 
  virtual int preloadSrc(const char* src, int64_t startPos) = 0;
 
  virtual int unloadSrc(const char* src) = 0;
 
  virtual int playPreloadedSrc(const char* src) = 0;
 
};
 
class IMediaPlayerSourceObserver {
 public:
  virtual ~IMediaPlayerSourceObserver() {}
 
  virtual void onPlayerSourceStateChanged(media::base::MEDIA_PLAYER_STATE state,
                                          media::base::MEDIA_PLAYER_REASON reason) = 0;
 
  virtual void onPositionChanged(int64_t positionMs, int64_t timestampMs) = 0;
 
  virtual void onPlayerEvent(media::base::MEDIA_PLAYER_EVENT eventCode, int64_t elapsedTime, const char* message) = 0;
 
  virtual void onMetaData(const void* data, int length) = 0;
 
 
  virtual void onPlayBufferUpdated(int64_t playCachedBuffer) = 0;
 
 
  virtual void onPreloadEvent(const char* src, media::base::PLAYER_PRELOAD_EVENT event) = 0;
 
  virtual void onCompleted() = 0;
 
  virtual void onAgoraCDNTokenWillExpire() = 0;
 
  virtual void onPlayerSrcInfoChanged(const media::base::SrcInfo& from, const media::base::SrcInfo& to) = 0;
 
  virtual void onPlayerInfoUpdated(const media::base::PlayerUpdatedInfo& info) = 0;
 
  virtual void onPlayerCacheStats(const media::base::CacheStatistics& stats) {
    (void)stats;
  }
 
  virtual void onPlayerPlaybackStats(const media::base::PlayerPlaybackStats& stats) {
    (void)stats;
  }
  
  virtual void onAudioVolumeIndication(int volume) = 0;
};
 
} //namespace rtc
} // namespace agora