Now PushService-Klasse – Android

Die Now PushService 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: Jetzt Servicekonfiguration

NowPushService – handlePush(remoteMessage: RemoteMessage, Success Callback: Consumer<NowPushPayload>, errorCallback: Consumer<Throwable>)

Verarbeitet eine Push-Benachrichtigungsanforderung.

Hinweis:

Derzeit ist der einzige implementierte Push-Benachrichtigungstyp Now PushVirtualAgent . 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 < Now PushPayload >	Rückruf, um den verarbeiteten zurückzugeben NowPushPayloadBis.
Fehler beim Rückruf	Verbraucher < Throwable >	Rückruf, an den der ausgelöste Fehler zurückgegeben werden soll. 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 Sie RemoteMessageBis zu Now PushService . Wenn Now PushService 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 FirebaseToken mit ServiceNowInstanz, die zum Identifizieren der Push-Benachrichtigungen für die aktuelle Instanz verwendet wird AndroidGerät und angegebene Anwendung.

In der Reihenfolge für ServiceNowInstanz zum Generieren von Benachrichtigungen AndroidGerät, um Benachrichtigungen von der Anwendung zu erhalten, muss dieses Token registriert werden.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
Push-Token	Zeichenfolge	FirebaseToken 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“ auf dem angegeben ServiceNowInstanz.
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 die aktuelle registriert AndroidGerät und 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 FirebasePush-Token mit zugehörigem ServiceNowInstanz.

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 Push-Anwendungstabelle auf der zugehörigen gespeichert ServiceNowInstanz.
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)
})