NowPushService-Klasse – Android

Die NowPushService -Klasse bietet Funktionen, die die Interaktion mit dem Push-Benachrichtigungsservice ermöglichen.

Tabelle : 1. Eigenschaften

Name	Beschreibung
konfigurieren	Servicekonfiguration, die dem Service zugeordnet werden soll. Datentyp: NowServiceConfiguration

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

Verarbeitet eine Push-Benachrichtigungsanforderung.

Hinweis:

Derzeit ist NowPushVirtualAgentder einzige implementierte Push-Benachrichtigungstyp. Jeder andere übergebene Push-Benachrichtigungstyp gibt ein NotSupportedPushError- Objekt zurück.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Remote-Nachricht	Remote-Nachricht	Benachrichtigung, wie von com.google.firebase.messaging.FirebaseMessagingService.onMessageReceived empfangen. Weitere Informationen finden Sie unter Nachrichten in einer Android-App empfangen.
erfolgreicher Rückruf	Verbraucher <NowPushPayload>	Rückruf, um den verarbeiteten NowPushPayload an zurückzugeben.
Fehler Rückruf	Verbraucher <Ausführbar>	Rückruf, um den ausgelösten Fehler an zurückzugeben. Wenn der Fehler NotSupportedPushError ausgelöst wird, wird der Benachrichtigungstyp vom Mobile-SDK nicht unterstützt und muss außerhalb des Mobile-SDK-Frameworks verarbeitet werden.

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Keine

Dieses Beispiel zeigt, wie onMessageReceived() überschrieben und RemoteMessage an NowPushService übergeben wird. Wenn NowPushService den Benachrichtigungstyp erkennt, verarbeitet er die Anforderung und gibt das Benachrichtigungsobjekt zurück, das die Anwendung verarbeiten soll. Andernfalls wird NotSupportedPushError ausgelöst.

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: String, pushApp: String, successCallback: Runnable, errorCallback: Consumer<Throwable> )

Registriert ein eindeutiges Firebase -Token bei der ServiceNow -Instanz, die zum Identifizieren der Push-Benachrichtigungen für das aktuelle Android -Gerät und die angegebene Anwendung verwendet wird.

Damit die Instanz [ ServiceNow Benachrichtigungen generieren kann, muss das Gerät Android Benachrichtigungen von der Anwendung erhalten. Dieses Token muss registriert sein.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
pushToken	Zeichenfolge	Firebase Token abgerufen von com.google.firebase.messaging.FirebaseMessaging.getToken oder com.google.firebase.messaging.FirebaseMessagingService.onNewToken.
pushApp	Zeichenfolge	Name der Push-Anwendung, wie in der Push-Anwendungstabelle in der zugeordneten Instanz ServiceNow angegeben.
erfolgreicher Rückruf	Ausführbar	Rückruf, der ausgeführt wird, wenn die Tokenregistrierung erfolgreich ist.
Fehler Rückruf	Verbraucher <Ausführbar>	Rückruf, der ausgeführt wird, wenn die Tokenregistrierung fehlschlägt.

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Keine

In diesem Beispiel wird ein Push-Token für das aktuelle Gerät Android und die Anwendung „PushAppName“ registriert.

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: String, pushApp: String, successCallback: Runnable, errorCallback: Consumer<Throwable> )

Hebt die Registrierung des angegebenen Push-Tokens Firebase bei der zugeordneten Instanz ServiceNow auf.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
pushToken	Zeichenfolge	Firebase Token zum Aufheben der Registrierung. Abgerufen von com.google.firebase.messaging.FirebaseMessaging.getToken oder com.google.firebase.messaging.FirebaseMessagingService.onNewToken.
pushApp	Zeichenfolge	Name der Push-Anwendung, die dem Token zugeordnet ist, dessen Registrierung aufgehoben werden soll. Diese Informationen werden in der Tabelle „Push-Anwendung“ in der zugeordneten Instanz ServiceNow gespeichert.
erfolgreicher Rückruf	Ausführbar	Rückruf, der ausgeführt wird, wenn die Registrierung des Tokens erfolgreich aufgehoben wurde.
Fehler rCallback	Verbraucher <Ausführbar>	Rückruf, der ausgeführt wird, wenn die Registrierung des Tokens fehlschlägt.

Tabelle : 7. Ergebnisse

Typ	Beschreibung
Keine

Dieses Codebeispiel zeigt, wie die Registrierung eines Push-Tokens aufgehoben wird, z. B. wenn sich der Benutzer von der Anwendung abmeldet.

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