Classe NowPushService - Android

. NowPushService A classe fornece funções que permitem a interação com o serviço de Notificação por push.

Tabela 1. Propriedades

Nome	Descrição
configuração	Configuração de serviço a ser associada ao serviço. Tipo de dados: NowServiceConfiguration

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

Processa uma solicitação de notificação por push.

Nota:

Atualmente, o único tipo de notificação por push implementado é NowPushVirtualAgent . Qualquer outro tipo de notificação por push aprovado retorna um Sem suporte objeto.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
Mensagem remota	Mensagem remota	Notificação conforme recebida por com.google.firebase.messaging.FirebaseMessagingService.onMessageReceived . Para obter informações adicionais, consulte Receba mensagens em um aplicativo Android .
Retorno de chamada bem-sucedido	Consumidor . NowPushPayload >	Retorno de chamada para retornar o processado NowPushPayload.
Retorno de chamada de erro	Consumidor . Throwable >	Retorno de chamada para o qual retornar o erro gerado. Se o erro Sem suporte É lançado, o tipo de notificação não é compatível com o SDK para celular e deve ser processado fora da estrutura do SDK para celular.

Tabela 3. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo mostra como substituir OnMessageReceived() e passar o. RemoteMessageaté NowPushService . . NowPushService reconhece o tipo de notificação, processa a solicitação e retorna o objeto de notificação para a aplicação manipular. Caso contrário, ele lançará o. Sem suporte .

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: Cadeia de caracteres, pushApp: Cadeia de caracteres, successCallback: Executável, erroCallback: Consumer<Throwable>)

Registra um exclusivo Firebase token com ServiceNow instância usada para identificar as notificações por push do atual Android dispositivo e aplicação especificada.

Em ordem para ServiceNow instância para gerar notificações Android para receber notificações da aplicação, este token deve ser registrado.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
PushToken	Cadeia de caracteres	Firebase token recuperado por qualquer um com.google.firebase.messaging.FirebaseMessaging.getToken ou com.google.firebase.messaging.FirebaseMessagingService.onNewToken .
Push App	Cadeia de caracteres	Nome da aplicação de envio conforme especificado na tabela Aplicação de envio no associado ServiceNow instância.
Retorno de chamada bem-sucedido	Executável	Retorno de chamada executado quando o registro do token é bem-sucedido.
Retorno de chamada do erro	Consumidor . Throwable >	Retorno de chamada executado quando o registro do token falha.

Tabela 5. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo registra um token de push para o atual Android E a aplicação "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: Cadeia de caracteres, pushApp: Cadeia de caracteres, successCallback: Executável, erroCallback: Consumer<Throwable>)

Cancela o registro do especificado Firebase token de push com o associado ServiceNow instância.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
PushToken	Cadeia de caracteres	Firebase token para cancelar o registro. Recuperado por qualquer um com.google.firebase.messaging.FirebaseMessaging.getToken ou com.google.firebase.messaging.FirebaseMessagingService.onNewToken .
Push App	Cadeia de caracteres	Nome da aplicação de envio associada ao token para cancelar o registro. Essas informações são armazenadas na tabela Aplicação de envio por push no associado ServiceNow instância.
Retorno de chamada bem-sucedido	Executável	Retorno de chamada executado quando o cancelamento do registro do token é bem-sucedido.
Erro de retorno de chamada	Consumidor . Throwable >	Retorno de chamada executado quando o cancelamento do registro do token falha.

Tabela 7. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo de código mostra como cancelar o registro de um token de push, por exemplo, quando o usuário faz logout da aplicação.

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