Smart TV SDK integration

Fire TV and Android TV use the Android binary flow. Other TV runtimes are not yet generally available.

1. Install

# Fire TV / Android TV — bundle the Android aarch64 binary 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 — identical to Android.
val sdkPath = File(applicationContext.applicationInfo.nativeLibraryDir,
                   "libgetpassive-sdk.so").absolutePath

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

3. Binary downloads

4. Lifecycle notes

Use aarch64 for modern Fire TV, Android TV, and set-top-box hardware.
Use armv7 only for older Android TV boxes that require it.
Start after consent and stop on opt-out just like the Android app flow.
Plan for devices that sleep aggressively by resuming the SDK from your app or service lifecycle.

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

Tizen and webOS native runtimes are on our roadmap — apply for early access at app.getpassive.io.

Last updated June 14, 2026