av_device.h

#ifndef AV_DEVICE_H_
#define AV_DEVICE_H_

#include "av_common.h"
#include "av_device_base.h"
#include <vector>

namespace tencent {

namespace av {
class AVContext;
#define DEVICE_UNKNOWN      "\\unknown"           // Unknown device type.

// Video input/output device type/id
#define DEVICE_VIDEO        "\\video"               // Video device type.
#define DEVICE_CAMERA       "\\video\\camera"       // Camera device type.
#define DEVICE_REMOTE_VIDEO "\\video\\remote_video" // The virtual remote video output device.
#define DEVICE_EXTERNAL_CAPTURE "\\video\\external_capture" //external capture device type.

// Audio input/output device type/id
#define DEVICE_AUDIO        "\\audio"               // Audio device type.
#define DEVICE_MIC          "\\audio\\mic"          // Mic device type.
#define DEVICE_PLAYER       "\\audio\\player"       // Sound player device type.
#define DEVICE_ACCOMPANY    "\\audio\\accompany"    // Audio Accompany device type.
#define DEVICE_REMOTE_AUDIO "\\audio\\remote_audio" // The virtual remote audio output device.
#define DEVICE_MIX          "\\audio\\mix"          // Mix device
#define DEVICE_MIX_INPUT    "\\audio\\mix\\input"   // Input mix device
#define DEVICE_MIX_OUTPUT   "\\audio\\mix\\output"  // Output mix device

//
// 音频设备相关的由此开始

#define MIN_AUDIO_DEVICE_VOLUME 0

#define MAX_AUDIO_DEVICE_VOLUME 100

class AV_EXPORT AVAudioDevice : public AVDevice {
 public:
  virtual uint32 GetVolume() = 0;

  virtual void SetVolume(uint32 value) = 0;

  virtual uint32 GetDynamicVolume() = 0;

  // Register an audio frame data callback. When a new audio frame appears,
  // the callback will be invoked, and the 'custom_data' is passed back as the last parameter.
  typedef void(*FrameDataCallback)(AudioFrame* audio_frame, void* custom_data);

  virtual void SetFrameDataCallback(FrameDataCallback frame_callback, void* custom_data = NULL) = 0;

  virtual FrameDataCallback GetFrameDataCallback() = 0;

  virtual void* GetFrameCustomData() = 0;
};

class AV_EXPORT AVSupportAudioPreview {
 public:
  typedef void(*PreviewCallback)(AudioFrame* audio_frame, void* custom_data);

  virtual void SetPreviewCallback(PreviewCallback frame_callback, void* custom_data = NULL) = 0;

  virtual PreviewCallback GetPreviewCallback() = 0;

  virtual void* GetPreviewCustomData() = 0;
};

class AV_EXPORT AVRemoteAudioDevice
  : public AVAudioDevice
  , public AVSupportAudioPreview {
 public:

};

class AV_EXPORT AVMicDevice
  : public AVAudioDevice
  , public AVSupportAudioPreview {
 public:

};

class AV_EXPORT AVPlayerDevice
  : public AVAudioDevice
  , public AVSupportAudioPreview {
 public:

};

class AV_EXPORT AVAccompanyDevice
  : public AVAudioDevice
  , public AVSupportAudioPreview {
 public:
  enum SourceType {
    AV_ACCOMPANY_SOURCE_TYPE_NONE = 0, 
    AV_ACCOMPANY_SOURCE_TYPE_SYSTEM = 1, 
    ACCOMPANY_SOURCE_TYPE_PROCESS = 2, 
  };

 public:
  virtual void SetSource(std::string player_path, std::string media_file_path, SourceType source_type) = 0;

  virtual SourceType GetSourceType() = 0;

  virtual std::string GetPlayerPath() = 0;

  virtual std::string GetMediaFilePath() = 0;
};

class AV_EXPORT AVMixDevice
  : public AVAudioDevice
  , public AVSupportAudioPreview {
 public:
  virtual bool AddDevice(std::string device_id) = 0;

  virtual bool RemoveDevice(std::string device_id) = 0;

  virtual int32 GetDeviceCount() = 0;

  virtual std::vector<std::string> GetDeviceIdList() = 0;

};

// mix input device.
// mix input device has a type of 'DEVICE_MIX_INPUT'.
class AV_EXPORT AVMixInputDevice : public AVMixDevice {

};

// mix output device.
// mix output device has a type of 'DEVICE_MIX_OUTPUT'.
class AV_EXPORT AVMixOutputDevice : public AVMixDevice {

};

//
// 视频设备相关的由此开始

class AV_EXPORT AVVideoDevice : public AVDevice {
 public:
  typedef void(*FrameDataCallback)(VideoFrame* video_frame, void* custom_data);

  virtual void SetFrameDataCallback(FrameDataCallback frame_callback, void* custom_data = NULL) = 0;

  virtual FrameDataCallback GetFrameDataCallback() = 0;

  virtual void* GetFrameCustomData() = 0;
};

class AV_EXPORT AVSupportVideoPreview {
 public:
  struct PreviewParam {
    std::string device_id;
    uint32 width;
    uint32 height;
    ColorFormat color_format;
    VideoSrcType src_type;
  };

  typedef void(*PreviewCallback)(VideoFrame* video_frame, void* custom_data);

  virtual void SetPreviewCallback(PreviewCallback frame_callback, void* custom_data = NULL) = 0;

  virtual int SetPreviewParam(std::string id, uint32 width, uint32 height, ColorFormat color_format) = 0;

  virtual PreviewCallback GetPreviewCallback() = 0;

  virtual void* GetPreviewCustomData() = 0;
};

class AV_EXPORT AVSupportVideoPreTreatment {
 public:
  typedef void(*PreTreatmentFun)(VideoFrame* video_frame, void* custom_data);

  virtual void SetPreTreatmentFun(PreTreatmentFun pre_fun, void* custom_data = NULL) = 0;
};

class AV_EXPORT AVRemoteVideoDevice
  : public AVVideoDevice
  , public AVSupportVideoPreview {
 public:
  struct Delegate {
    virtual ~Delegate() {}

    virtual void OnRenderFrame(const std::string& identifier, void* custom_data) = 0;
  };

  virtual void SetDelegate(Delegate* delegate, void* custom_data = NULL) = 0;
};

class AV_EXPORT AVCameraDevice
  : public AVVideoDevice
  , public AVSupportVideoPreview
  , public AVSupportVideoPreTreatment {
 public:

#ifdef OS_IOS

  virtual void* GetPreviewLayer() = 0;
  
  virtual void* GetCameraSession() = 0;
#endif
};

class AV_EXPORT AVExternalCapture
  : public AVCameraDevice {
 public:

#if defined(TARGET_OS_IPHONE)
  virtual void* GetPreviewLayer()  = 0;

#endif
  virtual int OnCaptureFrame(VideoFrame &frame) = 0;
};

} // namespace av
} // namespace tencent

#endif // #ifndef AV_DEVICE_H_