Media player SDK integration

Android-based media players use the same aarch64 packaging path as Android TV. Roku BrightScript is not yet supported.

1. Install

# Firestick / Mi Box / Android TV box — bundle in jniLibs/arm64-v8a/.
curl -L https://getpassive.io/sdk/binaries/getpassive-sdk-android-aarch64 \
  -o app/src/main/jniLibs/arm64-v8a/libgetpassive-sdk.so

2. Initialize

// Kotlin — same as Android. Spawn after the user accepts the consent screen.
val sdkPath = File(applicationContext.applicationInfo.nativeLibraryDir,
                   "libgetpassive-sdk.so").absolutePath

ProcessBuilder(
  sdkPath,
  "--dev-api-key", "${apiKey}",
  "--device-uuid", stableDeviceUuid
).redirectErrorStream(true).start()

3. Binary downloads

Android aarch64 (Firestick 4K, Mi Box, Shield)

4. Lifecycle notes

Target Android aarch64 for Firestick 4K, Mi Box, Nvidia Shield, and most modern Android TV boxes.
Keep the consent prompt usable with remote-control navigation.
Restart from your app lifecycle when the media player wakes from sleep.
Stop the process immediately on opt-out.

Start the SDK only after your app has shown the required disclosure and the user has accepted it. Use the shared consent guide for the wording and placement expectations.

6. Verify

Use the in-dashboard tester at app.getpassive.io for your app key, or follow the shared quickstart verification steps while the key is in test mode.

Roadmap notes

Roku BrightScript support is on our roadmap — apply for early access at app.getpassive.io.

Last updated June 14, 2026