Source repositoryav_audio.h

Go to the documentation of this file.

#pragma once
 
// platform includes
#import <AudioToolbox/AudioToolbox.h>
#import <AVFoundation/AVFoundation.h>
#import <CoreAudio/AudioHardwareTapping.h>
#import <CoreAudio/CoreAudio.h>
 
// standard includes
#include <functional>
 
// lib includes
#include "third-party/TPCircularBuffer/TPCircularBuffer.h"
 
NS_ASSUME_NONNULL_BEGIN
 
// Forward declarations
@class AVAudio;
@class CATapDescription;
 
namespace platf {
  using microphone_permission_callback_t = std::function<void(bool)>;  
  using microphone_permission_request_t = std::function<void(microphone_permission_callback_t)>;  

  bool request_microphone_permission(AVAuthorizationStatus authorization_status, const microphone_permission_request_t &request_access);

  bool request_microphone_permission();

  OSStatus audioConverterComplexInputProc(AudioConverterRef _Nullable inAudioConverter, UInt32 *_Nonnull ioNumberDataPackets, AudioBufferList *_Nonnull ioData, AudioStreamPacketDescription *_Nullable *_Nullable outDataPacketDescription, void *_Nonnull inUserData);
  OSStatus systemAudioIOProc(AudioObjectID inDevice, const AudioTimeStamp *_Nullable inNow, const AudioBufferList *_Nullable inInputData, const AudioTimeStamp *_Nullable inInputTime, AudioBufferList *_Nullable outOutputData, const AudioTimeStamp *_Nullable inOutputTime, void *_Nullable inClientData);
}  // namespace platf

struct AudioConverterInputData {
  float *inputData;  
  UInt32 inputFrames;  
  UInt32 framesProvided;  
  UInt32 deviceChannels;  
  AVAudio *avAudio;  
};

typedef struct {
  AVAudio *avAudio;  
  UInt32 clientRequestedChannels;  
  UInt32 clientRequestedSampleRate;  
  UInt32 clientRequestedFrameSize;  
  UInt32 aggregateDeviceSampleRate;  
  UInt32 aggregateDeviceChannels;  
  AudioConverterRef _Nullable audioConverter;  
  float *_Nullable conversionBuffer;  
  UInt32 conversionBufferSize;  
} AVAudioIOProcData;

@interface AVAudio: NSObject <AVCaptureAudioDataOutputSampleBufferDelegate> {
@public
  TPCircularBuffer audioSampleBuffer;  
  dispatch_semaphore_t audioSemaphore;  
@private
  // System-wide audio tap components (Core Audio)
  AudioObjectID tapObjectID;  
  AudioObjectID aggregateDeviceID;  
  AudioDeviceIOProcID ioProcID;  
  AVAudioIOProcData *_Nullable ioProcData;  
}
 
// AVFoundation microphone capture properties
@property (nonatomic, assign, nullable) AVCaptureSession *audioCaptureSession;  
@property (nonatomic, assign, nullable) AVCaptureConnection *audioConnection;  
@property (nonatomic, assign) BOOL hostAudioEnabled;  

+ (NSArray<AVCaptureDevice *> *)microphones;

+ (NSArray<NSString *> *)microphoneNames;

+ (nullable AVCaptureDevice *)findMicrophone:(nullable NSString *)name;

- (int)setupMicrophone:(nullable AVCaptureDevice *)device sampleRate:(UInt32)sampleRate frameSize:(UInt32)frameSize channels:(UInt8)channels;

- (int)setupSystemTap:(UInt32)sampleRate frameSize:(UInt32)frameSize channels:(UInt8)channels;
 
// Buffer management methods for testing and internal use
- (void)initializeAudioBuffer:(UInt8)channels;

- (void)cleanupAudioBuffer;

- (void)cleanupSystemTapContext:(nullable id)tapDescription;

- (int)initializeSystemTapContext:(UInt32)sampleRate frameSize:(UInt32)frameSize channels:(UInt8)channels;

- (nullable CATapDescription *)createSystemTapDescriptionForChannels:(UInt8)channels;

- (OSStatus)createAggregateDeviceWithTapDescription:(CATapDescription *)tapDescription sampleRate:(UInt32)sampleRate frameSize:(UInt32)frameSize;
 
@end
 
NS_ASSUME_NONNULL_END