Classe NowPushService : Android

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • La classe NowPushService fournit des fonctions qui permettent l’interaction avec le service de notification 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 réussi renvoie un objet NotSupportedPushError .
    Tableau 2. Paramètres
    Nom Type Description
    Message distant Message à distance Notification telle que reçue par com.google.firebase.messaging.FirebaseMessagingService.onMessageReceived. Pour plus d’informations, consultez Recevoir des messages dans une application Android.
    Rappel réussi 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 du cadre de travail du SDK mobile.
    Tableau 3. Renvoie
    Type Description
    Néant

    Cet exemple montre comment remplacer onMessageReceived() et transmettre cette RemoteMessage option à NowPushService. Si NowPushService reconnaît le type de notification, il traite la demande et renvoie l’objet de notification à gérer. 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 avec l’instance ServiceNow utilisée pour identifier les notifications push pour l’appareil actuel Android et l’application spécifiée.

    Pour que l’instance génère des notificationsAndroid, l’appareil ServiceNow reçoive des notifications de l’application, ce jeton doit être enregistré.

    Tableau 4. Paramètres
    Nom Type Description
    jeton push Chaîne Firebase jeton 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 tel que spécifié dans la table Application push de l’instance associée ServiceNow .
    Rappel réussi 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’enregistrement 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 pour annuler l’inscription. 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 de l’instance associée ServiceNow .
    Rappel réussi 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 la désinscription 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)
})