From 0ae982d3c22f0f3478250a7ce855b92afd43db5a Mon Sep 17 00:00:00 2001
From: zowue <heminpo49@gmail.com>
Date: Sun, 5 Apr 2026 11:49:33 +0300
Subject: [PATCH] docs(ytwa): Add audio channel limitations and reliability
 warnings

---
 doc/YTWA.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/doc/YTWA.md b/doc/YTWA.md
index eb5e3b7..ab6b1b8 100644
--- a/doc/YTWA.md
+++ b/doc/YTWA.md
@@ -457,6 +457,27 @@ DataChannel is created on the publisher PeerConnection and becomes available on
 - **Payload Type:** 101
 - **Format:** `111/111` (Opus redundancy)
 
+### Audio Channel Limitations
+
+**WARNING:** Audio channels are unreliable for data transmission through Yandex Telemost SFU.
+
+**Observed Issues:**
+- Severe signal degradation (>95% energy loss)
+- Opus codec applies aggressive voice optimization
+- Automatic gain control destroys non-voice signals
+- Voice activity detection (VAD) filters out data tones
+- Noise suppression corrupts encoded data
+
+**Test Results:**
+- Transmitted signal energy: 0.4973 (normalized)
+- Received signal energy: 0.0031-0.0125 (99% loss)
+- DTMF tones: Not detectable after transmission
+- ggwave encoding: Completely destroyed by codec
+
+**Root Cause:** WebRTC audio pipeline optimized for human voice, not arbitrary data. The Opus codec with DTX, FEC, and server-side processing makes audio channels unsuitable for data encoding schemes (FSK, DTMF, ggwave, etc.).
+
+**Recommendation:** Use DataChannel for reliable data transmission. Audio channels should only be used for actual voice communication.
+
 ## Video Codec Configuration
 
 ### Supported Codecs