av_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>
 
// lib includes
#include "third-party/TPCircularBuffer/TPCircularBuffer.h"
 
NS_ASSUME_NONNULL_BEGIN
 
// Forward declarations
@class AVAudio;
@class CATapDescription;
 
namespace platf {
  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