NGIAgoraAudioDeviceManager.h

//
//  Agora SDK
//
//  Copyright (c) 2018 Agora.io. All rights reserved.
//
 
#pragma once  // NOLINT(build/header_guard)
 
#include <cstring>
 
#include "AgoraBase.h"
#include "AgoraRefPtr.h"
namespace agora {
namespace media {
namespace base {
class IAudioFrameObserver;
} // namespace base
} // namespace media
 
namespace rtc {
 
static const int kIntervalInMillseconds = 200;
 
 
struct LoopbackRecordingOption {
  Optional<const char *> deviceName;
  Optional<bool> allowDeviceChange;
};
 
class IAudioDeviceManagerObserver
{
public:
  virtual ~IAudioDeviceManagerObserver() {}
 
  virtual void onDeviceStateChanged() = 0;
 
  virtual void onAudioDeviceStateChanged(const char *deviceId, int deviceType, int deviceState) = 0;
 
  virtual void onVolumeIndication(int deviceType, int volume) = 0;
 
  virtual void onRoutingChanged(int deviceType, AudioRoute route) = 0;
 
  virtual void onAudioDeviceVolumeChanged(int deviceType, int volume, bool muted) = 0;
};
 
class IRecordingDeviceSource : public RefCountInterface {
  public:
    virtual int initRecording(const char* deviceName = NULL) = 0;
 
    virtual int startRecording() = 0;
 
    virtual int stopRecording() = 0;
 
    virtual int registerAudioFrameObserver(media::IAudioPcmFrameSink* observer) = 0;
 
    virtual int unregisterAudioFrameObserver(media::IAudioPcmFrameSink* observer) = 0;
 
    virtual int setLoopbackDeviceParameter(const LoopbackRecordingOption &option) = 0;
 
    virtual ~IRecordingDeviceSource() {}
};
 
class INGAudioDeviceManager : public RefCountInterface {
public:
  virtual agora_refptr<IRecordingDeviceSource> createRecordingDeviceSource(char deviceId[kAdmMaxDeviceNameSize]) = 0;
 
  virtual int setMicrophoneVolume(unsigned int volume) = 0;
  virtual int getMicrophoneVolume(unsigned int& volume) = 0;
  virtual int setSpeakerVolume(unsigned int volume) = 0;
  virtual int getSpeakerVolume(unsigned int& volume) = 0;
  virtual int setMicrophoneMute(bool mute) = 0;
  virtual int getMicrophoneMute(bool& mute) = 0;
  virtual int setSpeakerMute(bool mute) = 0;
  virtual int getSpeakerMute(bool& mute) = 0;
 
  virtual int getPlayoutAudioParameters(AudioParameters* params) const = 0;
 
  virtual int getRecordAudioParameters(AudioParameters* params) const = 0;
 
#if defined(__ANDROID__) || (defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE)
 
  virtual int setDefaultAudioRouting(AudioRoute route) = 0;
  virtual int changeAudioRouting(AudioRoute route) = 0;
  virtual int setAudioRoutingSpeakerOn(bool enable) = 0;
  virtual int getCurrentRouting(AudioRoute& route) = 0;
#endif  // __ANDROID__ || TARGET_OS_IPHONE
 
#if defined(_WIN32) || (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE)
 
  virtual int getNumberOfPlayoutDevices() = 0;
 
  virtual int getNumberOfRecordingDevices() = 0;
  virtual AudioDeviceInfo getPlayoutDeviceInfo(int index) = 0;
  virtual AudioDeviceInfo getRecordingDeviceInfo(int index) = 0;
  virtual int setPlayoutDevice(int index) = 0;
  virtual int setRecordingDevice(int index) = 0;
  virtual int followSystemPlaybackDevice(bool enable) = 0;
 
  virtual int followSystemRecordingDevice(bool enable) = 0;
#endif  // _WIN32 || (TARGET_OS_MAC && !TARGET_OS_IPHONE)
 
#if defined(_WIN32)
 
  virtual int setApplicationVolume(unsigned int volume) = 0;
  virtual int getApplicationVolume(unsigned int& volume) = 0;
  virtual int setApplicationMuteState(bool mute) = 0;
  virtual int getApplicationMuteState(bool& mute) = 0;
  virtual AudioDeviceInfo getLoopbackDeviceInfo(int index) = 0;
  virtual int setLoopbackDevice(int index) = 0;
  virtual int followSystemLoopbackDevice(bool enable) = 0;
#endif  // _WIN32
 
  virtual int registerObserver(IAudioDeviceManagerObserver* observer, void(*safeDeleter)(IAudioDeviceManagerObserver*) = NULL) = 0;
  virtual int unregisterObserver(IAudioDeviceManagerObserver* observer) = 0;
 
  virtual int setupAudioAttributeContext(void* audioAttr) = 0;
 
protected:
  ~INGAudioDeviceManager() {}
};
 
} //namespace rtc
} // namespace agora