PcmSourceInterface.hpp

#ifndef ZAO_ENDPOINT_AUDIO_PCM_SOURCE_INTERFACE_HPP_
#define ZAO_ENDPOINT_AUDIO_PCM_SOURCE_INTERFACE_HPP_
 
#include <future>
#include <memory>
#include <string>
#include <vector>
 
#include "../EventSourceInterface.hpp"
#include "../SourceStreamInterface.hpp"
#include "../StreamInterface.hpp"
#include "PcmBufferWriter.hpp"
#include "PcmFormat.hpp"
#include "PcmSourceBufferDequeueResult.hpp"
#include "PcmSourceBufferEnqueueResult.hpp"
 
namespace zao {
namespace endpoint {
 
class TimestampInterface;
 
namespace audio {
 
class PcmSourceCallbackInterface;
 
class PcmSourceInterface
    : public StreamInterface,
      public SourceStreamInterface,
      public EventSourceInterface<PcmSourceCallbackInterface> {
 public:
  [[deprecated("Please use SetSourceFormats function")]]
  void SetAcceptableFormats(const std::vector<PcmFormat>& formats) {
    return SetSourceFormats(formats);
  }
 
  virtual void SetSourceFormats(const std::vector<PcmFormat>& formats) = 0;
 
  [[deprecated("Please use GetDeterminedFormat function")]]
  bool GetDecidedFormat(PcmFormat& format) const {
    return GetDeterminedFormat(format);
  }
 
  virtual bool GetDeterminedFormat(PcmFormat& format) const = 0;
 
  [[deprecated("Please use GetDeterminedFormatAsync function")]]
  std::shared_future<PcmFormat> GetFormatDecisionStatus() const {
    return GetDeterminedFormatAsync();
  }
 
  virtual std::shared_future<PcmFormat> GetDeterminedFormatAsync() const = 0;
 
#ifndef LIBZAO_ENDPOINT_INTERNAL
  [[deprecated("Please use {Dequeue,Enqueue}SourceBuffer APIs")]]
#endif
  virtual std::weak_ptr<PcmBufferPoolWriterInterface> GetPcmBufferPool() = 0;
 
  virtual PcmSourceBufferDequeueResult DequeueSourceBuffer() = 0;
 
  virtual PcmSourceBufferEnqueueResult EnqueueSourceBuffer(
      std::unique_ptr<PcmSourceBufferInterface> buffer) = 0;
 
  virtual void FlushQueue() = 0;
 
  virtual ~PcmSourceInterface() noexcept = default;
};
 
class PcmSourceCallbackInterface : public StreamCallbackInterface,
                                   public SourceStreamCallbackInterface {
 public:
  enum class EventType {
    kUnknown = 0,
 
    kDisconnected,
 
    kUnlinked,
 
    kEncodeError,
 
    kFailedFormatNegotiation,
  };
 
  virtual bool OnRequestSourceFormat(const PcmFormat& format) = 0;
 
  virtual void OnDecideSourceFormat(const PcmFormat* format) = 0;
 
  virtual void OnNotifySourceEvent(EventType type, const std::string& message) {
  }
 
  virtual ~PcmSourceCallbackInterface() noexcept = default;
};
 
}  // namespace audio
}  // namespace endpoint
}  // namespace zao
 
#endif  // ZAO_ENDPOINT_AUDIO_PCM_SOURCE_INTERFACE_HPP_