📖 PrzeglądOverview

Debug Overlay to wizualny debugger reklam wyświetlający metryki i eventy w czasie rzeczywistym.Debug Overlay is a visual ad debugger displaying metrics and events in real-time. Idealny do testowania i debugowania podczas developmentu.

🚀 InstalacjaInstallation

W klasie Application
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()

        ADict.init(this, BuildConfig.DEBUG)

        // Instalacja Debug Overlay
        ADict.ADS.DebugOverlay.install(
            application = this,
            cfg = DebugOverlay.Config(
                startVisible = true,        // Czy widoczny na starcie
                startCollapsed = false,     // Czy zwinięty na starcie
                showInRelease = false,      // Czy pokazywać w release
                refreshMs = 500,            // Interwał odświeżania (ms)
                maxEventLines = 12          // Max linii eventów
            )
        )
    }
}

⚙️ KonfiguracjaConfiguration

ParametrParameterTypTypeDomyślnieDefaultOpisDescription
startVisibleBooleantrueCzy widoczny na starcie
startCollapsedBooleanfalseCzy zwinięty na starcieWhether collapsed on start
showInReleaseBooleanfalseCzy pokazywać w release buildWhether to show in release build
refreshMsLong500Interwał odświeżania metrykMetrics refresh interval
maxEventLinesInt12Maksymalna liczba linii eventówMaximum event line count

🎮 Sterowanie programowe

API
// Pokaż
ADict.ADS.DebugOverlay.show()

// Ukryj
ADict.ADS.DebugOverlay.hide()

// Przełącz widoczność
ADict.ADS.DebugOverlay.toggleVisibility()

// Zwiń wszystkie sekcje
ADict.ADS.DebugOverlay.collapseAll()

// Rozwiń wszystkie sekcje
ADict.ADS.DebugOverlay.expandAll()

// Przełącz zwinięcie
ADict.ADS.DebugOverlay.toggleCollapsedAll()

📊 Co wyświetlaWhat It Displays

💡 Dobre praktyki

✅ Zalecenia:
Shake to toggle
// Użyj biblioteki ShakeDetector lub własnej implementacji
shakeDetector.setOnShakeListener {
    ADict.ADS.DebugOverlay.toggleVisibility()
}