Classe NowPushService - Android

A classe NowPushService 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, sucessoCallback: consumidor<NowPushPayload> , errorCallback: cliente<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 objeto NotSupportedPushError.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
Mensagem remota	Mensagem remota	Notificação recebida por com.google.firebase.messaging.FirebaseMessagingService.onMessageReceived. Para obter informações adicionais, consulte Receber mensagens em um aplicativo Android.
retorno de chamada bem-sucedido	Consumidor <NowPushPayload>	Retorno de chamada para retornar o processado NowPushPayload para.
retorno de chamada de erro	Consumidor <Throwable>	Retorno de chamada para retornar o erro gerado. Se o erro NotSupportedPushError for lançado, o tipo de notificação não será compatível com o SDK móvel e deverá ser processado fora da estrutura do SDK móvel.

Tabela 3. Retorna

Tipo	Descrição
Nenhum

Este exemplo mostra como substituir onMessageReceived() e passar o RemoteMessage por meio de para o NowPushService. Se o NowPushService reconhecer o tipo de notificação, ele processará a solicitação e retornará o objeto de notificação para a aplicação processar. Caso contrário, ele emitirá o 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: cadeia de caracteres, pushApp: cadeia de caracteres, sucessoCallback: executável, errorCallback: consumidor<Throwable> )

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

Para que a instância ServiceNow gere notificações, o dispositivo Android receba 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 com.google.firebase.messaging.FirebaseMessaging.getToken ou com.google.firebase.messaging.FirebaseMessagingService.onNewToken.
pushApp	Cadeia de caracteres	Nome da aplicação de envio por push conforme especificado na tabela Aplicação de envio por push na instância ServiceNow associada.
retorno de chamada bem-sucedido	Executável	Retorno de chamada executado quando o registro do token é bem-sucedido.
retorno de chamada de erro	Consumidor <Throwable>	Retorno de chamada executado quando o registro do token falha.

Tabela 5. Retorna

Tipo	Descrição
Nenhum

Este exemplo registra um token de envio por push para o dispositivo Android atual 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, sucessoCallback: executável, errorCallback: consumidor<Throwable> )

Cancela o registro do token de envio por push Firebase especificado com a instância ServiceNow associada.

Tabela 6. Parâmetros

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

Tabela 7. Retorna

Tipo	Descrição
Nenhum

Este exemplo de código mostra como cancelar o registro de um token de envio por 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)
})