Classe NowPushService : Android

La classe NowPushService fournit des fonctions qui permettent l’interaction avec le service de notifications push.

Tableau 1. Propriétés

Nom	Description
configuration	Configuration de service à associer au service. Type de données : NowServiceConfiguration

NowPushService : handlePush(remoteMessage : RemoteMessage, successCallback : Consumer<NowPushPayload>, errorCallback : Consumer<Throwable>)

Traite une demande de notification push.

Remarque :

Actuellement, le seul type de notification push implémenté est NowPushVirtualAgent. Tout autre type de notification push transmis renvoie un objet NotSupportedPushError .

Tableau 2. Paramètres

Nom	Type	Description
Message distant	Message distant	Notification telle que reçue par com.google.firebase.messaging.FirebaseMessagingService.onMessageReceived. Pour plus d’informations, voir Recevoir des messages dans une application Android.
Rappel de réussite	Consommateur <NowPushPayload>	Rappel auquel renvoyer le traité NowPushPayload
Rappel d’erreur	Consommateur <Jetable>	Rappel auquel renvoyer l’erreur levée. Si l’erreur NotSupportedPushError est générée, le type de notification n’est pas pris en charge par le SDK mobile et doit être traité en dehors de l’infrastructure du SDK mobile.

Tableau 3. Renvoie

Type	Description
Néant

Cet exemple montre comment remplacer onMessageReceived() et transmettre le RemoteMessage via à NowPushService. Si le NowPushService reconnaît le type de notification, il traite la demande et renvoie l’objet de notification à l’application. Sinon, il lève NotSupportedPushError.

override fun onMessageReceived(remodeeMessage: RemoteMessage){
  pushService.handlePush(remoteMessage, { push ->
    when (push) {
      is NowPushVirtualAgent → handleVirtualAgentPush(push)
    }, { error ->
        Log.e(TAG, "Unknown push", error)
        handleAppPushNotification(remoteMessage)
    })
}

NowPushService : registerPushToken(pushToken : chaîne, pushApp : chaîne, successCallback : exécutable, errorCallback : consommateur<jetable>)

Enregistre un jeton unique Firebase auprès de l’instance ServiceNow utilisé pour identifier les notifications push pour l’appareil actuel Android et l’application spécifiée.

Ce jeton doit être enregistré pour que l’instance ServiceNow génère des notifications Android .

Tableau 4. Paramètres

Nom	Type	Description
Jeton push	Chaîne	Firebase jeton récupéré soit par com.google.firebase.messaging.FirebaseMessaging.getToken , soit com.google.firebase.messaging.FirebaseMessagingService.onNewToken.
application push	Chaîne	Nom de l’application push tel que spécifié dans la table Application push sur l’instance associée ServiceNow .
Rappel de réussite	Exécutable	Rappel exécuté lorsque l’enregistrement du jeton est réussi.
errorCallback	Consommateur <Jetable>	Rappel exécuté en cas d’échec de l’inscription du jeton.

Tableau 5. Renvoie

Type	Description
Néant

Cet exemple enregistre un jeton push pour l’appareil actuel Android et l’application « PushAppName ».

FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
  val token = task.result

  if (!task.isSuccessful || token == null) {
    throw Exception("Unable to fetch token"))
  }

  pushService.registerPushToken(token, "PushAppName", {
    Log.v(TAG, "Successfully registered push token")
  }, { e ->
    Log.e(TAG, "Error registering push", e)
  })
}

NowPushService : unregisterPushToken(pushToken : chaîne, pushApp : chaîne, successCallback : exécutable, errorCallback : consommateur<jetable>)

Annule l’enregistrement du jeton push spécifié Firebase auprès de l’instance associée ServiceNow .

Tableau 6. Paramètres

Nom	Type	Description
Jeton push	Chaîne	Firebase Jeton à désinscrire. Récupéré par com.google.firebase.messaging.FirebaseMessaging.getToken ou com.google.firebase.messaging.FirebaseMessagingService.onNewToken.
application push	Chaîne	Nom de l’application push associée au jeton à désinscrire. Ces informations sont stockées dans la table Application push sur l’instance associée ServiceNow .
Rappel de réussite	Exécutable	Rappel exécuté lorsque la désinscription du jeton est réussie.
erro rCallback	Consommateur <Jetable>	Rappel exécuté en cas d’échec de l’annulation de l’enregistrement du jeton.

Tableau 7. Renvoie

Type	Description
Néant

Cet exemple de code montre comment annuler l’enregistrement d’un jeton push, par exemple lorsque l’utilisateur se déconnecte de l’application.

pushService.unregisterPushtoken(token, "PushAppName", {
  Log.v(TAG, "Successfully unregistered push token")
},  { e ->
  Log.e(TAG, "Error unregistering push", e)
})