analysis.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stdbool.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct {
  uint64_t total_samples;     // Total samples processed
  float peak_level;           // Maximum sample value
  float rms_level;            // RMS (root mean square) level
  uint64_t clipping_count;    // Samples > 1.0 (clipping)
  uint64_t silent_samples;    // Samples < 0.001 (silence threshold)
  float dc_offset;            // DC bias in signal
  uint32_t packets_count;     // Number of packets
  uint32_t packets_dropped;   // Dropped packets
  int64_t timestamp_start_us; // Start timestamp (microseconds)
  int64_t timestamp_end_us;   // End timestamp (microseconds)
  // Quality indicators for "scratchy/distorted" detection
  uint64_t jitter_count;        // Rapid amplitude changes (jitter events)
  uint64_t discontinuity_count; // Packet arrival gaps (sparse delivery)
  float avg_packet_spacing_ms;  // Average time between packets (ms)
  uint32_t max_gap_ms;          // Largest gap between consecutive packets (ms)
  // Beep/tone artifact detection
  uint64_t beep_events;   // Short tonal bursts (codec artifacts, system beeps)
  uint64_t tonal_samples; // Samples in tonal/beep-like patterns
} audio_analysis_stats_t;
 
int audio_analysis_init(void);
 
void audio_analysis_track_sent_sample(float sample);
 
void audio_analysis_track_sent_packet(size_t size);
 
void audio_analysis_track_received_sample(float sample);
 
void audio_analysis_track_received_packet(size_t size);
 
const audio_analysis_stats_t *audio_analysis_get_sent_stats(void);
 
const audio_analysis_stats_t *audio_analysis_get_received_stats(void);
 
void audio_analysis_print_report(void);
 
void audio_analysis_set_aec3_metrics(double echo_return_loss, double echo_return_loss_enhancement, int delay_ms);
 
void audio_analysis_cleanup(void);
 
#ifdef __cplusplus
} /* extern "C" */
#endif