Este documento tiene como objetivo proporcionar una guía detallada para la integración de aplicaciones con el Agente Pulsus, permitiendo la captura del identificador Pulsus de manera eficiente.
1. Declarar un BroadcastReceiver para obtener el Identificador Pulsus
Para capturar el Identificador Pulsus, es necesario declarar un BroadcastReceiver en el archivo AndroidManifest.xml, registrando la acción mobi.pulsus.PULSUS_ID.
Ejemplo de implementación:
<receiver android:name=".broadcast.PulsusIdReceiver">
<intent-filter>
<action android:name="mobi.pulsus.PULSUS_ID" />
</intent-filter>
</receiver>
A partir de Android 8 (Oreo), es obligatorio registrar el BroadcastReceiver en tiempo de ejecución.
Ejemplo de código:
registerReceiver(PulsusIdReceiver(), IntentFilter("mobi.pulsus.PULSUS_ID"))
2. Capturar el Identificador Pulsus
Con el BroadcastReceiver debidamente declarado en AndroidManifest.xml, es posible capturar el identificador desde la Intent. La información estará disponible en extras con la clave "PULSUS_ID".
Ejemplo de código:
class PulsusIdReceiver : BroadcastReceiver() {
override fun onReceive(context: Context?, intent: Intent?) {
val pulsusId = intent?.extras?.getString("PULSUS_ID") Toast.makeText(context, pulsusId, Toast.LENGTH_LONG).show()
}
}
3. Solicitar el Identificador Pulsus
Finalmente, podemos solicitar al Agente Pulsus el identificador, que será recibido por el BroadcastReceiver declarado anteriormente.
Para solicitar el identificador, realiza la llamada al método sendBroadcast(), enviando la Intent con la acción mobi.pulsus.REQUEST_PULSUS_ID.
Ejemplo de código:
private fun requestPulsusID() {
sendBroadcast(Intent().apply {
flags = Intent.FLAG_INCLUDE_STOPPED_PACKAGES
action = "mobi.pulsus.REQUEST_PULSUS_ID"
})
}