IAgoraMediaEngine.h

//
//  Agora Media SDK
//
//  Copyright (c) 2015 Agora IO. All rights reserved.
//
#pragma once
 
#include "AgoraBase.h"
#include "AgoraMediaBase.h"
#include "AgoraRefPtr.h"
 
namespace agora {
namespace media {
 
enum AUDIO_MIXING_DUAL_MONO_MODE {
  /* 0: Original mode */
  AUDIO_MIXING_DUAL_MONO_AUTO = 0,
  /* 1: Left channel mode */
  AUDIO_MIXING_DUAL_MONO_L = 1,
  /* 2: Right channel mode */
  AUDIO_MIXING_DUAL_MONO_R = 2,
  /* 3: Mixed channel mode */
  AUDIO_MIXING_DUAL_MONO_MIX = 3
};
 
 
class IMediaEngine {
 public:
  virtual int registerAudioFrameObserver(IAudioFrameObserver* observer) = 0;
  virtual int registerVideoFrameObserver(IVideoFrameObserver* observer) = 0;
 
  virtual int registerVideoEncodedFrameObserver(IVideoEncodedFrameObserver* observer) = 0;
  
  virtual int registerFaceInfoObserver(IFaceInfoObserver* observer) = 0;
 
  virtual int pushAudioFrame(IAudioFrameObserver::AudioFrame* frame, rtc::track_id_t trackId = 0) = 0;
 
  virtual int pullAudioFrame(IAudioFrameObserver::AudioFrame* frame) = 0;
 
  virtual int setExternalVideoSource(
      bool enabled, bool useTexture, EXTERNAL_VIDEO_SOURCE_TYPE sourceType = VIDEO_FRAME,
      rtc::SenderOptions encodedVideoOption = rtc::SenderOptions()) = 0;
 
  virtual int setExternalAudioSource(bool enabled, int sampleRate, int channels, bool localPlayback = false, bool publish = true) __deprecated = 0;
 
  virtual rtc::track_id_t createCustomAudioTrack(rtc::AUDIO_TRACK_TYPE trackType, const rtc::AudioTrackConfig& config) = 0;
 
  virtual int destroyCustomAudioTrack(rtc::track_id_t trackId) = 0;
 
  virtual int setExternalAudioSink(bool enabled, int sampleRate, int channels) = 0;
 
  virtual int enableCustomAudioLocalPlayback(rtc::track_id_t trackId, bool enabled) = 0;
 
  virtual int pushVideoFrame(base::ExternalVideoFrame* frame, unsigned int videoTrackId = 0) = 0;
 
  virtual int pushEncodedVideoImage(const uint8_t* imageBuffer, size_t length,
                                    const agora::rtc::EncodedVideoFrameInfo& videoEncodedFrameInfo,
                                    unsigned int videoTrackId = 0) = 0;
 
  virtual int addVideoFrameRenderer(IVideoFrameObserver *renderer) = 0;
 
  virtual int removeVideoFrameRenderer(IVideoFrameObserver *renderer) = 0;
 
  virtual rtc::track_id_t createLoopbackAudioTrack(const rtc::LoopbackAudioTrackConfig& config) = 0;
 
  virtual int destroyLoopbackAudioTrack(rtc::track_id_t trackId) = 0;
 
  virtual int updateLoopbackAudioTrackConfig(rtc::track_id_t trackId, const rtc::LoopbackAudioTrackConfig& config) = 0;
 
  virtual void release() = 0;
 
 protected:
  virtual ~IMediaEngine() {}
};
 
}  // namespace media
 
}  // namespace agora