> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spoofsense.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Android SDK: Native Camera Capture for Verification

> Integrate SpoofSense face liveness verification into Android apps using CameraX and Play Integrity signals. Distributed via JitPack.

The Android SDK opens a full-screen capture activity, captures from the front camera, and submits with device-integrity signals. You need a `clientToken` (`sst_…`) minted by your backend — never embed your secret key in the app. The SDK is distributed via JitPack.

## Installation

Add the JitPack repository and the SDK dependency to your Gradle files:

<CodeGroup>
  ```kotlin settings.gradle.kts theme={null}
  dependencyResolutionManagement {
      repositories { maven("https://jitpack.io") }
  }
  ```

  ```kotlin build.gradle.kts theme={null}
  implementation("com.github.kartik3ya:spoofsense-android-sdk:v0.1.0")
  ```
</CodeGroup>

## Launch and Handle the Result

Register a result callback, then launch the capture activity with your client token:

```kotlin theme={null}
// In your Activity/Fragment
val verify = registerForActivityResult(SpoofSenseVerification()) { result ->
    when (result) {
        is VerificationResult.Complete -> notifyBackend(result.verificationSessionId)
        is VerificationResult.Failed -> Log.w("spoofsense", result.code)
        VerificationResult.Canceled -> {}
    }
}

verify.launch(SpoofSenseConfig(sessionToken = clientToken))
```

| Result     | Meaning                                                                                                                                            |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Complete` | Capture submitted. Send `verificationSessionId` to your backend to [read the decision](/verification-sessions/results) with the secret key         |
| `Failed`   | Terminal failure — `code` is a [standard error code](/guides/errors) such as `SESSION_EXPIRED` or `TOO_MANY_ATTEMPTS`. Mint a new session to retry |
| `Canceled` | The user backed out                                                                                                                                |

## Behavior Notes

* Capture comes from the live camera (CameraX) — there is no gallery or file input, by design.
* The SDK validates the session and fetches its nonce before opening the camera, and handles retryable `422` retakes internally up to the 3-attempt limit.
* Device integrity signals ride along with the submission and feed the [injection-protection policy](/verification-sessions/overview#injection-protection).

<Warning>
  `Complete` means "a capture was submitted", not "the user is verified". Only your backend's session read with `status: "complete"` and `decision: "real"` means verified.
</Warning>