Overview

The SpeedTester SDK wraps the IPC layer between your app and the SpeedTester TV service. Under the hood it uses AIDL, but you never touch it — the SDK handles service binding, reconnection, and marshalling automatically.

Authentication

Every call into the SpeedTester service is authorised. Two mechanisms are available — whichever passes first is used.

Setup

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        maven { url = uri("https://maven.3ss.tv/releases") }
    }
}

// app/build.gradle.kts
dependencies {
    implementation("tv.threess:speedtest-sdk:1.0.0")
}

<!-- AndroidManifest.xml -->
<queries>
    <package android:name="tv.threess.speedtester" />
</queries>

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        SpeedTesterSdk.init(
            context = this,
            apiKey  = "YOUR_TENANT_API_KEY"  // omit if using package allowlist
        )
    }
}

Speed test

Use SpeedTestClient to trigger a test and observe progress as a Flow. Cancelling the coroutine automatically cancels the test.

val client = SpeedTestClient(context)

client.startTest().collect { event ->
    when (event) {
        is SpeedTestClient.Event.Progress   -> showProgress(event.downloadMbps, event.percent)
        is SpeedTestClient.Event.Completed -> showResult(event.result)
        is SpeedTestClient.Event.Error     -> showError(event.message)
    }
}

client.release() // call in onDestroy / onCleared

Network status

Observe live network conditions as a Flow. Emits immediately with the current state, then on every change.

val client = NetworkStatusClient(context)

client.networkStatus().collect { status ->
    println("${status.connectionType} — ${status.ssid} (${status.signalStrengthDbm} dBm)")
}

Wi-Fi

val client = WifiClient(context)

when (val result = client.connect("MyNetwork", "password123")) {
    is WifiConnectResult.Connected -> println("Connected to ${result.ssid}")
    is WifiConnectResult.Failed    -> println("Failed: ${result.reason}")
}

Data models

SpeedTestResult

NetworkStatus

Error reference

Permissions

All sensitive permissions are held by the SpeedTester app. Your AndroidManifest.xml does not need ACCESS_FINE_LOCATION, ACCESS_WIFI_STATE, CHANGE_WIFI_STATE, or INTERNET. You only need the <queries> entry from step 2.