Android SDK initialization

The SDK is a process-wide singleton. Initialize it exactly once in Application.onCreate().

Basic initialization

import android.app.Application
import com.relavoi.sdk.Relavoi
import com.relavoi.sdk.RelavoiConfig

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

    Relavoi.initialize(
      context = this,
      apiKey = BuildConfig.RELAVOI_API_KEY,
      apiSecret = BuildConfig.RELAVOI_API_SECRET,
      tenantId = BuildConfig.RELAVOI_TENANT_ID,
      config = RelavoiConfig(
        enableLogging = BuildConfig.DEBUG
        // baseUrl defaults to production (https://api.relavoi.com/v1).
        // Override it only for staging/testing.
      )
    )
  }
}

Register the Application class in AndroidManifest.xml:

<application
  android:name=".MyApp"
  ...>
</application>

Inject secrets via BuildConfig

Do not commit your API secret to source. Read it from local.properties and surface it through Gradle:

// app/build.gradle.kts
import java.util.Properties

val localProps = Properties().apply {
  rootProject.file("local.properties").takeIf { it.exists() }?.inputStream()?.use { load(it) }
}

android {
  defaultConfig {
    buildConfigField("String", "RELAVOI_API_KEY", "\"${localProps.getProperty("RELAVOI_API_KEY", "")}\"")
    buildConfigField("String", "RELAVOI_API_SECRET", "\"${localProps.getProperty("RELAVOI_API_SECRET", "")}\"")
    buildConfigField("String", "RELAVOI_TENANT_ID", "\"${localProps.getProperty("RELAVOI_TENANT_ID", "")}\"")
  }
  buildFeatures { buildConfig = true }
}

Then in local.properties (gitignored):

RELAVOI_API_KEY=rk_live_YOUR_API_KEY_HERE
RELAVOI_API_SECRET=rs_YOUR_API_SECRET_HERE
RELAVOI_TENANT_ID=a1b2c3d4-e5f6-7890-abcd-ef1234567890

For production builds, source the same values from your CI secret manager.

RelavoiConfig flags

RelavoiConfig is a data class with exactly these fields:

Field	Type	Default	Purpose
baseUrl	String	"https://api.relavoi.com/v1"	REST API host. Override for staging/testing
webSocketUrl	String?	null	Override the event-stream WebSocket URL. When null, it is derived from baseUrl (scheme swapped to ws/wss, /ws appended)
enableLogging	Boolean	false	Verbose Logcat output. Phone numbers always redacted
offlineQueueMaxSize	Int	100	Max actions buffered in the offline queue before the oldest are dropped

Token storage

The SDK persists the JWT in Android Keystore-backed EncryptedSharedPreferences. You do not need to manage tokens yourself; refresh is transparent.

:::warning Initialize before any other call Accessing any subsystem — Relavoi.sessions, Relavoi.events, Relavoi.verification, Relavoi.push, Relavoi.presence — before Relavoi.initialize(...) throws RelavoiException.NotInitialized. Use Relavoi.isInitialized() to check first if you are unsure. :::

Next: Creating sessions.