Android

Integra la jornada Human Token en tu aplicación Android usando Custom Tabs.

Markdown

Custom Tabs inicia la jornada Human Token en una pestaña del navegador dentro de tu aplicación. Cuando la jornada finaliza, el navegador redirige a tu esquema de URL personalizado y tu aplicación lo intercepta.

Requisitos previos

• Android 8 (API 26) o posterior
• androidx.browser:browser:1.5.0
• Un esquema de URL único para tu aplicación (por ejemplo, myapp)

Paso 1: Agregar la dependencia

En tu build.gradle:

implementation("androidx.browser:browser:1.5.0")

Paso 2: Definir tu esquema de URL

Elige un esquema único (por ejemplo, myapp). Se usa como callbackUri al crear el proceso:

callbackUri: myapp://callback

Paso 3: Crear la actividad

import android.content.Intent
import android.net.Uri
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.browser.customtabs.CustomTabsIntent

class HumanTokenActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        val url = intent.getStringExtra(EXTRA_PROCESS_URL) ?: return finish()

        CustomTabsIntent.Builder()
            .build()
            .launchUrl(this, Uri.parse(url))
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        intent.data?.let { uri ->
            if (uri.scheme == "myapp") {
                // Journey completed — send processId to your backend
                val processId = uri.getQueryParameter("id")
                handleResult(processId)
            }
        }
    }

    private fun handleResult(processId: String?) {
        // Fetch the result from your backend via Get Process
        finish()
    }

    companion object {
        const val EXTRA_PROCESS_URL = "process_url"
    }
}

Paso 4: Configurar AndroidManifest.xml

<uses-feature android:name="android.hardware.camera" android:required="false" />
<uses-permission android:name="android.permission.CAMERA" />

<activity
    android:name=".HumanTokenActivity"
    android:launchMode="singleTop"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="myapp" android:host="callback" />
    </intent-filter>
</activity>

singleTop asegura que Android llame a onNewIntent() en la actividad existente en lugar de crear una nueva.

Paso 5: Iniciar la jornada

val intent = Intent(this, HumanTokenActivity::class.java)
    .putExtra(HumanTokenActivity.EXTRA_PROCESS_URL, processLink)
startActivity(intent)

Resumen de archivos

Archivo	Propósito
build.gradle	Dependencia de androidx.browser
HumanTokenActivity.kt	Inicio de Custom Tabs + manejo de redirección
AndroidManifest.xml	Filtro de intent para tu esquema de URL