NowPushService-Klasse – Android

Die NowPushService Die 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, succCallback: Consumer<NowPushPayload>, errorCallback: Consumer<Throwable>)

Verarbeitet eine Push-Benachrichtigungsanforderung.

Hinweis:

Derzeit ist der einzige implementierte Push-Benachrichtigungstyp NowPushVirtualAgent . Jeder andere übergebene Push-Benachrichtigungstyp gibt ein zurück Nicht SupportedPushError Objekt.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Remote-Nachricht	Remote-Nachricht	Benachrichtigung wie erhalten von Com.google.Firebase.Messaging.FirebaseMessagingService.onMessageReceived . Weitere Informationen finden Sie unter Empfangen Sie Nachrichten in einer Android-App .
Erfolgreicher Rückruf	Verbraucher < NowPushPayload >	Rückruf, um den verarbeiteten zurückzugeben NowPushPayloadBis.
Fehler-Rückruf	Verbraucher < Throwable >	Rückruf, an den der ausgelöste Fehler zurückgegeben wird. Wenn der Fehler ist Nicht SupportedPushError Wird ausgelöst, wird der Benachrichtigungstyp vom mobilen SDK nicht unterstützt und muss außerhalb des mobilen SDK-Frameworks verarbeitet werden.

Tabelle : 3. Rückgaben

Typ	Beschreibung
Keine

Dieses Beispiel zeigt, wie Sie überschreiben OnMessageReceived() Und übergeben RemoteMessageBis zu NowPushService . Wenn NowPushService Erkennt den Benachrichtigungstyp, verarbeitet die Anforderung und gibt das Benachrichtigungsobjekt zurück, das die Anwendung verarbeiten soll. Andernfalls wird ausgelöst Nicht SupportedPushError .

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: Zeichenfolge, pushApp: Zeichenfolge, succCallback: Ausführbar, errorCallback: Consumer<Throwable>)

Registriert eine eindeutige Firebase Token mit ServiceNow Instanz, die zum Identifizieren der Push-Benachrichtigungen für die aktuelle Instanz verwendet wird Android Gerät und angegebene Anwendung.

In der Reihenfolge für ServiceNow Instanz zum Generieren von Benachrichtigungen Android Gerät, um Benachrichtigungen von der Anwendung zu erhalten, muss dieses Token registriert sein.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
Push-Token	Zeichenfolge	Firebase Token wurde von einer der beiden abgerufen Com.google.Firebase.Messaging.FirebaseMessaging.getToken Oder Com.google.Firebase.Messaging.FirebaseMessagingService.onNewToken .
Push-App	Zeichenfolge	Name der Push-Anwendung, wie in der Tabelle „Push-Anwendung“ in der zugehörigen angegeben ServiceNow Instanz.
Erfolgreicher Rückruf	Ausführbar	Rückruf wird ausgeführt, wenn die Tokenregistrierung erfolgreich ist.
Fehler – Rückruf	Verbraucher < Throwable >	Rückruf wird ausgeführt, wenn die Tokenregistrierung fehlschlägt.

Tabelle : 5. Rückgaben

Typ	Beschreibung
Keine

In diesem Beispiel wird ein Push-Token für den aktuellen registriert Android Gerät und die Anwendung „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: Zeichenfolge, pushApp: Zeichenfolge, succCallback: Ausführbar, errorCallback: Consumer<Throwable>)

Hebt die Registrierung des angegebenen auf Firebase Push-Token mit zugehörigem ServiceNow Instanz.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
Push-Token	Zeichenfolge	Firebase Token zum Aufheben der Registrierung. Wurde von einer der beiden abgerufen Com.google.Firebase.Messaging.FirebaseMessaging.getToken Oder Com.google.Firebase.Messaging.FirebaseMessagingService.onNewToken .
Push-App	Zeichenfolge	Name der Push-Anwendung, die dem Token zugeordnet ist, dessen Registrierung aufgehoben werden soll. Diese Informationen werden in der Tabelle „Push-Anwendung“ im zugehörigen gespeichert ServiceNow Instanz.
Erfolgreicher Rückruf	Ausführbar	Rückruf wird ausgeführt, wenn die Token-Registrierung erfolgreich aufgehoben wird.
fehler beim Rückruf	Verbraucher < Throwable >	Rückruf wird ausgeführt, wenn die Token-Aufhebung fehlschlägt.

Tabelle : 7. Rückgaben

Typ	Beschreibung
Keine

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

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