From 9bdf8e6348cf65ef3328f5185747003297dfdc24 Mon Sep 17 00:00:00 2001
From: pstruebi <struebin.patrick.com>
Date: Thu, 23 Oct 2025 18:43:38 +0200
Subject: [PATCH] refactor: rename drift_compensation to
 adaptive_frame_dropping for clarity

---
 src/auracast/auracast_config.py  | 4 ++--
 src/auracast/multicast.py        | 2 +-
 src/auracast/multicast_script.py | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/auracast/auracast_config.py b/src/auracast/auracast_config.py
index a283392..a904b11 100644
--- a/src/auracast/auracast_config.py
+++ b/src/auracast/auracast_config.py
@@ -40,8 +40,8 @@ class AuracastGlobalConfig(BaseModel):
     # so receivers may render earlier than the presentation delay for lower latency.
     immediate_rendering: bool = False
     assisted_listening_stream: bool = False
-    # Clock drift compensation: discard excess samples when buffer exceeds threshold
-    enable_drift_compensation: bool = False
+    # Adaptive frame dropping: discard sub-frame samples when buffer exceeds threshold
+    enable_adaptive_frame_dropping: bool = False
 
 # "Audio input. "
 # "'device' -> use the host's default sound input device, "
diff --git a/src/auracast/multicast.py b/src/auracast/multicast.py
index 7e7a7c0..bf1b343 100644
--- a/src/auracast/multicast.py
+++ b/src/auracast/multicast.py
@@ -656,7 +656,7 @@ class Streamer():
         samples_discarded_total = 0  # Total samples discarded
         discard_events = 0  # Number of times we discarded samples
         frames_since_last_discard = 999  # Guard: frames since last discard (start high to allow first drop)
-        enable_drift_compensation = global_config.enable_drift_compensation
+        enable_drift_compensation = getattr(global_config, 'enable_adaptive_frame_dropping', False)
         # Hardcoded parameters (unit: milliseconds)
         drift_threshold_ms = 2.0 if enable_drift_compensation else 0.0
         static_drop_ms = 0.5 if enable_drift_compensation else 0.0
diff --git a/src/auracast/multicast_script.py b/src/auracast/multicast_script.py
index 1c71f3e..97b05c8 100644
--- a/src/auracast/multicast_script.py
+++ b/src/auracast/multicast_script.py
@@ -110,7 +110,7 @@ if __name__ == "__main__":
         auracast_sampling_rate_hz = LC3_SRATE,
         octets_per_frame = OCTETS_PER_FRAME,
         transport=TRANSPORT1,
-        enable_drift_compensation=True,
+        enable_adaptive_frame_dropping=True,
     )
     config.debug = False