Fastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows, iOS testflight! Android, Linux waitlist open! A local Wispr Flow alternative. Follow https://x.com/fluidvoiceapp for more
#ifndef CORE_AUDIO_CAPTURE_SUPPORT_H
#define CORE_AUDIO_CAPTURE_SUPPORT_H
#include <CoreAudio/CoreAudio.h>
#include <stdbool.h>
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef void *FVCoreAudioCaptureRef;
typedef struct {
const float *samples;
uint32_t frameCount;
double sampleRate;
uint64_t inputHostTime;
int64_t inputSampleTime;
uint64_t sequence;
} FVCoreAudioPacket;
/// Layout helpers shared by capture and deterministic tests.
uint32_t fv_core_audio_buffer_bytes_per_frame(
uint32_t bytesPerSample,
uint32_t channelCount
);
uint32_t fv_core_audio_buffer_frame_count(
uint32_t dataByteSize,
uint32_t bytesPerSample,
uint32_t channelCount
);
/// Creates a prepared, input-only capture for one physical Core Audio device.
/// The device is not started and the microphone is not active until start.
int32_t fv_core_audio_capture_create(
AudioObjectID deviceID,
FVCoreAudioCaptureRef *outCapture
);
int32_t fv_core_audio_capture_start(FVCoreAudioCaptureRef capture);
int32_t fv_core_audio_capture_stop(FVCoreAudioCaptureRef capture);
int32_t fv_core_audio_capture_destroy(FVCoreAudioCaptureRef capture);
/// Waits until the realtime producer publishes a packet or capture stops.
/// Returns true when the consumer should attempt to drain the ring.
bool fv_core_audio_capture_wait(FVCoreAudioCaptureRef capture, uint32_t timeoutMilliseconds);
/// Returns a view into the next immutable ring slot. The pointer remains valid
/// until consume is called and must never escape the consumer callback.
bool fv_core_audio_capture_peek(FVCoreAudioCaptureRef capture, FVCoreAudioPacket *packet);
void fv_core_audio_capture_consume(FVCoreAudioCaptureRef capture);
void fv_core_audio_capture_clear(FVCoreAudioCaptureRef capture);
void fv_core_audio_capture_wake(FVCoreAudioCaptureRef capture);
bool fv_core_audio_capture_is_running(FVCoreAudioCaptureRef capture);
void fv_core_audio_capture_mark_format_dirty(FVCoreAudioCaptureRef capture);
bool fv_core_audio_capture_open_packet_gate_if_clean(FVCoreAudioCaptureRef capture);
bool fv_core_audio_capture_copy_stream_format(
FVCoreAudioCaptureRef capture,
AudioStreamID *streamID,
AudioStreamBasicDescription *format
);
double fv_core_audio_capture_sample_rate(FVCoreAudioCaptureRef capture);
uint32_t fv_core_audio_capture_buffer_frame_size(FVCoreAudioCaptureRef capture);
uint64_t fv_core_audio_capture_dropped_packet_count(FVCoreAudioCaptureRef capture);
// MARK: - Audio topology diagnostics
/// Fixed-size, numeric-only event captured without allocation, locks, dispatch,
/// file I/O, environment reads, or Core Audio calls. String rendering happens
/// later on a diagnostics drain queue.
typedef struct {
uint64_t sequence;
uint64_t continuousTime;
uint64_t generation;
uint32_t event;
uint32_t owner;
AudioObjectID objectID;
AudioObjectPropertySelector selector;
AudioObjectPropertyScope scope;
AudioObjectPropertyElement element;
uint32_t queueRole;
uint32_t phase;
uint32_t transport;
uint32_t isMainThread;
int32_t status;
} FVAudioTopologyTraceEvent;
void fv_audio_topology_trace_set_enabled(bool enabled);
bool fv_audio_topology_trace_is_enabled(void);
/// Captures one event and returns its monotonically increasing sequence, or 0
/// when tracing is disabled.
uint64_t fv_audio_topology_trace_record(
uint32_t event,
uint32_t owner,
AudioObjectID objectID,
AudioObjectPropertySelector selector,
AudioObjectPropertyScope scope,
AudioObjectPropertyElement element,
uint32_t queueRole,
uint32_t phase,
uint32_t transport,
int32_t status,
uint64_t generation
);
/// Copies fully published events newer than afterSequence in sequence order.
/// Overwritten or concurrently mutating slots are skipped. latestSequence is
/// the highest sequence reserved when the snapshot began.
uint32_t fv_audio_topology_trace_snapshot(
uint64_t afterSequence,
FVAudioTopologyTraceEvent *events,
uint32_t capacity,
uint64_t *latestSequence
);
uint32_t fv_audio_topology_trace_capacity(void);
uint64_t fv_audio_topology_trace_latest_sequence(void);
/// Main-runloop heartbeat; both functions are atomic and non-blocking.
void fv_audio_topology_trace_main_heartbeat(void);
uint64_t fv_audio_topology_trace_last_main_heartbeat(void);
/// Test-only in intent. Call only while no producers are active.
void fv_audio_topology_trace_reset(void);
#ifdef __cplusplus
}
#endif
#endif