Installation

The Android SDK connects Android apps to Reactor models. These pages describe inc.reactor:reactor-sdk-android:1.1.0. Use the published API reference for the complete API.

Requirements

Requirement	Value
`minSdk`	26 (Android 8.0)
ABIs	`arm64-v8a` and `x86_64`
Kotlin	2.1 or later; the AGP 9 default works
Page size	4 KB and 16 KB devices, including Android 15

The SDK is written in Kotlin. Calls that wait are suspend functions, and state is exposed as StateFlow. For desktop JVM or desktop Kotlin, use the Java SDK.

Add the dependency

Gradle (Kotlin DSL)

repositories {
    mavenCentral()
}

dependencies {
    implementation("inc.reactor:reactor-sdk-android:1.1.0")
}

The AAR includes the native libraries for both ABIs. No separate download or NDK is needed.

Permissions

The SDK declares no permissions. Add INTERNET to your app’s manifest:

AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET" />

Capturing from a device also needs RECORD_AUDIO or CAMERA. Request them from your app when you need them.

Connect

Have your backend issue a short-lived, scoped JWT and pass it to the app. See Authentication for token issuance.

import inc.reactor.sdk.android.ConnectionStatus
import inc.reactor.sdk.android.Reactor
import inc.reactor.sdk.android.ReactorOptions
import kotlinx.coroutines.flow.first

suspend fun run(jwt: String) {
    val reactor = Reactor(ReactorOptions(jwt = jwt))
    try {
        reactor.connect("reactor/helios")
        reactor.status.first { it == ConnectionStatus.READY }
        reactor.sendCommand("set_prompt", """{"prompt":"a mountain landscape"}""")
    } finally {
        runCatching { reactor.disconnect() }
        reactor.close()
    }
}

Call this from a coroutine, for example lifecycleScope.launch { run(jwt) }. disconnect() ends a session the client created. close() releases the client. Call both: closing alone does not end the session.

Never bundle a Reactor API key in an APK. Anyone can extract it. Keep it on your backend and give the app a scoped JWT.

Optional module

inc.reactor:reactor-sdk-android-media adds camera, microphone, speaker, and rendering helpers. Add it with the same 1.1.0 version:

implementation("inc.reactor:reactor-sdk-android-media:1.1.0")

Class	Purpose
`CameraCapture`	Camera2 frames as upright BGRA, following device orientation
`Microphone`	Microphone capture, with the platform’s echo canceller
`Speaker`	Audio playback
`VideoRenderer`	A `SurfaceView` that draws received video frames

The base SDK opens no hardware. See the media API reference for each class.

Reactor

Connect, send commands, upload files, and download recordings.

Track

Receive and send video and audio frames.

Types

Replies, state, step results, and errors.

Get Started

Concepts

SDK Reference

Resources

Requirements

Add the dependency

Permissions

Connect

Optional module

Reactor

Track

Types

​Requirements

​Add the dependency

​Permissions

​Connect

​Optional module

Reactor

Track

Types

Requirements

Add the dependency

Permissions

Connect

Optional module